# Chinese Text to Pinyin Converter

> Chinese Text to Pinyin Converter is a paid API for AI agents from chinese-culture.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Converts Chinese text (up to 200 characters) to pinyin with tone marks, tone numbers, or plain romanization, and flags polyphonic characters with multiple readings.

## Facts

- Endpoint: GET https://chinese-culture.x402tookit.com/pinyin?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chinese-text-to-pinyin-converter-2b71168c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DdIzZK53JiNYHF5qg0qGS

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability chinese-text-to-pinyin-converter-2b71168c
```

Example prompt: Convert 你好，我叫小明，很高兴认识你 to pinyin with tone marks and let me know if any characters have multiple readings.

## When to prefer this

Choose this endpoint when you need to romanize Chinese text into pinyin for language learning, pronunciation guides, music notation, or display purposes. It is specifically useful when you need tone information (marks or numbers) and want to be alerted to polyphonic characters that have context-dependent readings. Prefer this over a generic translation API when the goal is romanization rather than meaning.

## Known failure modes

- Missing required 'text' query parameter returns an error
- Input exceeding 200 characters may be truncated or rejected
- Non-Chinese or mixed-script input may produce unconverted characters in the unconvertedHan list
- Polyphonic characters are flagged but the correct reading cannot always be disambiguated without context
- Invalid 'style' value falls back to default 'marks' style

## How this service works

Convert Chinese text to pinyin with tone marks or tone numbers; flags characters with several readings.

## Output

Returns a pinyin string representing the romanization of the input Chinese text in the requested style (tone marks, tone numbers, or plain). Also includes the syllable count, a list of polyphonic characters with all their possible readings, any Han characters that could not be converted, and the style used. May include a degraded flag and disclaimer if coverage is partial.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "text"
     ],
     "properties": {
      "text": {
       "type": "string",
       "description": "Chinese text, up to 200 characters"
      },
      "style": {
       "type": "string",
       "description": "marks (default, zhōng), numbers (zhong1) or plain (zhong)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "style": {
       "type": [
        "null",
        "string"
       ]
      },
      "pinyin": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "syllables": {
       "type": [
        "null",
        "number"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "unconvertedHan": {
       "type": [
        "array",
        "null"
       ]
      },
      "polyphonicCharacters": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "char": {
          "type": [
           "null",
           "string"
          ]
         },
         "readings": {
          "type": [
           "array",
           "null"
          ],
          "items": {
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chinese-text-to-pinyin-converter-2b71168c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chinese-culture.x402tookit.com](https://www.zero.xyz/host/chinese-culture.x402tookit.com/llms.txt)