汉字转拼音 API

把中文转成拼音，支持带声调、数字声调、无声调、首字母四种风格和多音字列表，附带拼音首字母缩写（如“中国→ZG”）。多音字按单字最常用读音转换，不做词语上下文判断（如“银行”会得到 yín xíng），需要时可查看每个字的全部读音

数据来源：本地转换，读音数据来自新华字典开源数据 chinese-xinhua（MIT）

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

汉字转拼音（带声调 / 数字声调 / 无声调 / 首字母）

GET /api/pinyin

请求参数

  • text（必填）：要转换的文本，最多 1000 个字；英文、数字、标点等非汉字原样保留，示例 中国人民银行
  • style：拼音风格：tone 带声调（zhōng）/ number 数字声调（zhong1，轻声不加数字，ü 写作 v）/ none 无声调（zhong）/ initial 首字母（z），示例 tone
  • separator：音节之间的分隔符，最多 5 个字符；传空值（separator=）表示不分隔，示例
  • heteronym：是否在拼音结果里列出多音字的全部读音（用 / 分隔，如 zhōng/zhòng）：true / false，示例 false

返回字段

  • text（string）：原文
  • style（string）：拼音风格：tone / number / none / initial
  • pinyin（string）：转换结果：每个汉字一个音节，用 separator 连接；非汉字按原样成段保留，空白只保留换行。多音字取最常用读音，heteronym=true 时列出全部读音
  • abbr（string）：拼音首字母缩写（大写，只取汉字），如“中国”为“ZG”
  • hanCount（number）：转换出拼音的汉字个数（字典未收录的生僻字不计入，原样保留）
  • chars（array）：逐字结果，与原文的字符一一对应（按 Unicode 码位）
  • chars[].char（string）：字符
  • chars[].pinyin（string|null）：该字采用的读音（按 style 格式化）；非汉字或字典未收录时为 null
  • chars[].readings（array）：该字的全部读音（按 style 格式化并去重，第一个为默认读音）；非汉字为空数组
  • chars[].polyphonic（boolean）：是否多音字（按当前 style 去重后读音多于 1 个）