{"uid":"cap_WJezqrky202NvoPcqeO5K","slug":"api-cn402-com-beeb2bae","name":"Chinese Hanzi to Pinyin Converter","description":"Chinese pinyin, hanzi to pinyin, Mandarin romanization, 拼音转换, Chinese phonetic, Hanyu Pinyin with tones, 普通话拼音, Chinese to Latin, Mandarin transliteration, tone marks numbers. Convert Chinese characters to Pinyin (Hanyu Pinyin) with tone marks. For AI agents handling Chinese text-to-speech, Chinese language learning apps.","url":"https://api.cn402.com/hanzi/pinyin","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"style":{"type":"string","description":"Style (optional)"}}},"responseSchema":null,"example":{"request":{"text":"你好","format":"tone_numbers"},"response":{"_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","input":"你好","style":"with_tone","joined":"nǐ hǎo","pinyin":["nǐ","hǎo"]}},"exampleRequest":{"text":"你好","format":"tone_numbers"},"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U9pzJHygrml-CN7VcH_og","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts Chinese characters (Hanzi) to Hanyu Pinyin romanization with tone marks or tone numbers","exampleAgentPrompt":"Convert this Chinese text to pinyin with tone marks for me: '你好，我叫李明，很高兴认识你。'","exampleUseCases":null,"resultDescription":"Returns the Pinyin romanization of the input Chinese characters, with tone marks (e.g. nǐ hǎo) or tone numbers (e.g. ni3 hao3) indicating the Mandarin tones for each syllable","failureModes":["Non-Chinese input returns an error or empty result","Invalid or malformed characters may not be converted","Network timeout for very long text inputs","HTTP 402 if payment header is missing or insufficient","Rare characters (obscure Hanzi) may not have pinyin mappings"],"whenToPreferThis":"Use this endpoint when you need accurate Hanyu Pinyin romanization with proper tone marks for Chinese (Mandarin) text — ideal for text-to-speech pipelines, language learning apps, pronunciation guides, or annotating Chinese content for non-native readers. Prefer this over generic translation APIs when you specifically need phonetic output rather than meaning translation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:00.952Z","isFirstParty":false}