{"uid":"cap_DdIzZK53JiNYHF5qg0qGS","slug":"chinese-text-to-pinyin-converter-2b71168c","name":"Chinese Text to Pinyin Converter","description":"Convert Chinese text to pinyin with tone marks or tone numbers; flags characters with several readings.","url":"https://chinese-culture.x402tookit.com/pinyin?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"type":"string"}}}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n2bLuNWpjz3fCYK18X6vE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts Chinese text (up to 200 characters) to pinyin with tone marks, tone numbers, or plain romanization, and flags polyphonic characters with multiple readings.","exampleAgentPrompt":"Convert 你好，我叫小明，很高兴认识你 to pinyin with tone marks and let me know if any characters have multiple readings.","exampleUseCases":[{"title":"Pronunciation guide for language learners","prompt":"I'm learning Mandarin and want to know how to pronounce 春眠不觉晓，处处闻啼鸟 — can you give me the pinyin with tone marks and flag any characters that have more than one reading?"},{"title":"Romanizing Chinese product names for export","prompt":"I need the pinyin (using tone numbers like zhong1) for these product names in simplified Chinese: 龙井茶, 普洱茶, 铁观音 — also tell me if any of those characters are polyphonic."},{"title":"Annotating Chinese lyrics for a music sheet","prompt":"Can you convert these song lyrics 月亮代表我的心 to plain pinyin without any tone marks or numbers so I can put it under the musical notation?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:32:59.957Z","isFirstParty":false,"canonicalSlug":"chinese-text-to-pinyin-converter-2b71168c"}