汉字转拼音

接口信息

接口地址: /convert
请求方式: POST
内容类型: application/json

请求参数

参数	类型	必填	默认值	说明
text	string	是	-	要转换的汉字文本
toneType	string	否	symbol	声调类型：symbol（符号声调）、none（无声调）、num（数字声调）
pattern	string	否	pinyin	输出模式：pinyin（完整拼音）、initial（声母）、final（韵母）、first（首字母）、num（声调数字）
type	string	否	all	返回类型：all（完整字符串）、array（数组形式）
separator	string	否	(空格)	分隔符，用于分隔多个拼音

请求示例

基本转换

curl -X POST https://api.apisbo.com/pinyin/convert \
  -H "Content-Type: application/json" \
  -d '{
    "text": "你好世界"
  }'

无声调转换

curl -X POST https://api.apisbo.com/pinyin/convert \
  -H "Content-Type: application/json" \
  -d '{
    "text": "你好世界",
    "toneType": "none"
  }'

数字声调转换

curl -X POST https://api.apisbo.com/pinyin/convert \
  -H "Content-Type: application/json" \
  -d '{
    "text": "你好世界",
    "toneType": "num"
  }'

获取首字母

curl -X POST https://api.apisbo.com/pinyin/convert \
  -H "Content-Type: application/json" \
  -d '{
    "text": "汉字转拼音",
    "pattern": "first",
    "toneType": "none"
  }'

响应示例

基本响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "original": "你好世界",
    "pinyin": "nǐ hǎo shì jiè",
    "pinyinArray": ["nǐ", "hǎo", "shì", "jiè"],
    "pinyinNum": "ni3 hao3 shi4 jie4"
  }
}

无声调响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "original": "你好世界",
    "pinyin": "ni hao shi jie",
    "pinyinArray": ["ni", "hao", "shi", "jie"],
    "pinyinNum": "ni3 hao3 shi4 jie4"
  }
}

数字声调响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "original": "你好世界",
    "pinyin": "ni3 hao3 shi4 jie4",
    "pinyinArray": ["ni3", "hao3", "shi4", "jie4"],
    "pinyinNum": "ni3 hao3 shi4 jie4"
  }
}

首字母响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "original": "汉字转拼音",
    "pinyin": "hzzpy",
    "pinyinArray": ["h", "z", "z", "p", "y"],
    "pinyinNum": "h4 z4 zhuan3 pin1 yin1"
  }
}

响应字段说明

字段	类型	说明
data.original	string	原始文本
data.pinyin	string	拼音字符串（根据 toneType 格式化）
data.pinyinArray	string[]	拼音数组（每个字独立）
data.pinyinNum	string	数字声调格式拼音（当 toneType 不为 num 时提供）

toneType 参数说明

值	说明	示例
symbol	符号声调（默认）	nǐ hǎo
none	无声调	ni hao
num	数字声调	ni3 hao3

pattern 参数说明

值	说明	示例
pinyin	完整拼音（默认）	nǐ hǎo
initial	声母	n h
final	韵母	ǐ ǎo
first	首字母	n h
num	声调数字	3 3

注意事项

支持混合文本（中文 + 英文 + 数字），非中文字符将原样保留
多音字默认返回常用读音
标点符号会被跳过
每次调用最多支持 1000 个汉字

最后更新于 February 28, 2026

获取首字母