汉字转拼音

接口标识: pinyin 价格: 0.005 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

汉字转拼音接口把中文文本批量转换为规范拼音，单次最多 5000 字，提供带声调、无声调、声母、韵母、首字母五种风格，并同时返回逐字数组、空格连写全拼与首字母串三种形态。多音字按词组语境自动取音（如「重庆」读 chóng qìng），可开启开关一次输出全部读音；字母、数字等非汉字字符原样保留。适合姓名注音、少儿识字教育、拼音检索排序与语音播报预处理等场景，本地计算毫秒级返回。

详细介绍

![汉字转拼音接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_pinyin__1794363308_decbcbb2cea1.png)

拼音标注是教育、检索与语音场景的基础工作，多音字却最容易读错。汉字转拼音接口把一段中文一次转成规范拼音。

## 接口概述
面向语文教育、姓名注音、内容检索与语音合成预处理等场景，输入一段不超过 5000 字的中文文本，接口自动完成分字与注音，按带声调、无声调、声母、韵母、首字母五种风格之一输出结果，并同时给出逐字数组、空格连写全拼与首字母串三种形态，可直接写入注音组件、索引字段或展示页面，无需自行维护拼音词库与多音字规则。

## 核心能力
1. **五种风格**：带声调、无声调、声母、韵母、首字母，一个参数自由切换。
2. **语境取音**：多音字按词组语境自动取音，如「重庆」注音为 chóng qìng 而非 zhòng qìng。
3. **多音全读**：开启多音开关后，单字可一次输出全部读音，以斜杠分隔，适合教学与词典场景。
4. **三种形态**：逐字数组、空格连写全拼、首字母串同时返回，一次调用多种用途。
5. **混合文本**：字母、数字等非汉字字符原样保留，不破坏原有排版。

## 产品优势
1. **接入简单**：单次 POST 传一段文本即得结果，无需部署词库与分词组件。
2. **响应迅速**：纯本地计算，毫秒级同步返回，批量注音不排队。
3. **准确规范**：注音遵循汉语拼音方案，声调符号标注位置准确。
4. **稳定可靠**：无外部依赖，服务可用性不受第三方波动影响。
5. **降本增效**：省去自建多音字词典与词组读音数据的长期维护成本。

## 效果展示
一句话理解：它就像给每个汉字配了一位随叫随到的注音老师，你把句子递过去，他逐字标好拼音还给你。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| text | 重庆火锅 | 要注音的中文文本，单次最多 5000 字符 |
| style | tone | 注音风格，tone 为带声调，另可选 plain、initial、final、first_letter |
| heteronym | false | 是否输出多音字全部读音，默认 false 只取语境读音 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 原文回显 | 重庆火锅 | `text`，便于与源文本对齐 |
| 所用风格 | tone | `style` |
| 逐字拼音 | ["chóng","qìng","huǒ","guō"] | `pinyin`，逐字数组，开多音时读音以斜杠分隔 |
| 完整拼音 | chóng qìng huǒ guō | `joined`，空格连写的全拼 |
| 首字母串 | cqhg | `first_letters`，常用于索引与简拼检索 |

API请求示例：

```text
POST /api/pinyin
text=重庆火锅&style=tone&heteronym=false
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "text": "重庆火锅",
    "style": "tone",
    "pinyin": ["chóng", "qìng", "huǒ", "guō"],
    "joined": "chóng qìng huǒ guō",
    "first_letters": "cqhg"
  },
  "request_id": "pinyin-demo-cqhg-0001"
}
```

「重」是典型多音字，接口按词组「重庆」取音 chóng，这正是自建词库最容易出错的地方。

## 应用场景
1. **教育识字**：少儿阅读类应用与课件的生字注音展示。
2. **姓名注音**：证件、名录与名片上的姓名拼音标注，避免误读。
3. **检索排序**：为内容库建立拼音与首字母索引，支持拼音搜索与 A-Z 排序。
4. **语音播报**：文本转语音前的多音字读音校正预处理。
5. **词库加工**：输入法与词典产品批量生成词条读音数据。

## 应用案例
一款少儿阅读应用原先靠教研老师逐篇手工标注拼音，一篇课文要半小时还常漏标多音字；接入接口后课文批量注音直接渲染展示，标注时间缩短到几秒，多音字差错基本消失。

一家企业名录系统的开发者要为 HR 提供按姓名拼音检索的能力，自建姓氏读音词库成本太高；接入接口后把返回的首字母串写入索引字段，拼音检索当周即上线。

一个地名数据整理项目需要给数万条地名批量注音并核对多音字；利用接口的多音字全读音输出，把每个字的可能读音一次性列出再人工复核，校对效率提升了一倍。

常见问题

Q：多音字是如何注音的？

A：默认按词组语境自动取音，例如「重庆」注音为 chóng qìng。如需查看某个字的全部读音，可将 heteronym 参数设为 true，此时该字的多个读音会以斜杠分隔一并输出。

Q：文本中夹杂的英文和数字会怎样处理？

A：非汉字字符原样保留在结果中，不会被丢弃或改写，因此中英混排的句子可以放心整段传入。

Q：单次最多能转多少字？

A：单次请求的 text 最长为 5000 字符，超长会返回参数错误（code=40002）。更长的文本建议分段调用。

拼音注音多音字汉字转拼音首字母拼音检索

接口地址： https://www.phpwc.cn/api/pinyin

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`text`	string	必填	-	待转换中文文本，≤5000 字符
`style`	string	选填	`tone`	风格：tone 带声调/plain 无声调/initial 声母/final 韵母/first_letter 首字母
`heteronym`	boolean	选填	`false`	是否输出多音字全部读音
`surname_mode`	boolean	选填	`false`	是否启用姓氏模式

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`text`	string	原文
`style`	string	所用风格
`pinyin`	array	逐字拼音数组（多音字以斜杠分隔）
`joined`	string	空格连接的完整拼音
`first_letters`	string	首字母串
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试