汉字转拼音

汉字转拼音：支持声调、分隔、首字母大写、缩写；词组消歧更准

汉字转拼音：将中文文本转为汉语拼音，支持声调、单字分隔、首字母大写、全大写、仅首字母缩写等。
内置 4 万+ 汉字字典，并对常见多音词做词组消歧（如「重庆」「银行」）。

典型场景：姓名检索、SEO 别名、通讯录排序、表单拼音字段生成。

调用地址：https://api.ynlskj.com.cn/gateway/pinyin

请求方法：POST

在其他地方怎么调用

请求地址用上面的调用地址，把 JSON 放在请求体里
方法用 POST
API Key 只能放在请求头 X-API-Key，不要写进网址，也不要写进 Query 框
Key 在「个人中心 → API Key」里复制，登录后会自动填入你自己的 Key

参数说明

参数	位置	必填	说明
`text`	Body JSON	是	待转换文本，最长 2000 字。也可用 `content`
`tone`	Body JSON	否	`1` 显示声调（如 yún），默认 `0` 无声调
`separator`	Body JSON	否	拼音之间的分隔符。默认空格；首字母模式默认空；可传 `-`、`_`、空字符串等
`ucfirst`	Body JSON	否	`1` 每个拼音首字母大写（Yun Nan）
`uppercase`	Body JSON	否	`1` 全大写（YUN NAN）
`initials`	Body JSON	否	`1` 只返回首字母（ynkj）
`keep_non_chinese`	Body JSON	否	默认 `1` 保留数字/英文/标点；`0` 丢弃
`v_to_u`	Body JSON	否	`1` 将 ü 写成 v（女→nv），便于某些系统检索
`heteronym`	Body JSON	否	`1` 在 list 中附带该字全部读音
`phrase`	Body JSON	否	默认 `1` 启用词组消歧（重庆、银行等）；`0` 强制逐字
`X-API-Key`	Header	是	你的 API Key

这个接口是干什么的？

把汉字转成汉语拼音，一次请求即可得到拼接结果和逐字明细。适合姓名检索、SEO 别名、通讯录排序、表单自动生成拼音字段等场景。

内置 4 万+ 汉字字典（CC0 开源数据），并对常见多音词做词组消歧，例如「重庆」读 chong qing 而非「zhong qing」。

典型参数组合

场景	Body 示例	结果示意
带声调 + 首字母大写	`{"text":"云南科技","tone":1,"ucfirst":1}`	`Yún Nán Kē Jì`
无声调、短横线分隔	`{"text":"云南科技","separator":"-"}`	`yun-nan-ke-ji`
仅首字母缩写	`{"text":"云南科技","initials":1}`	`ynkj`
全大写	`{"text":"云南","uppercase":1}`	`YUN NAN`
ü 写成 v	`{"text":"女人","v_to_u":1}`	`nv ren`
返回全部读音	`{"text":"银行","heteronym":1}`	list 中含 readings 数组

词组消歧示例

POST /gateway/pinyin {"text":"重庆银行"}
→ pinyin: "chong qing yin hang"

说明

默认 POST；参数也可放 Query（调试页 Query 区填写 JSON）
多音字默认取常用读音；开启 phrase（默认开）后优先按词组匹配
字典未命中的生僻字：pinyin 为空，type=unknown，并计入 unknown_count
更新字典：服务器执行 php cli/build_pinyin_data.php（数据源 mozillazg/pinyin-data，CC0）

返回说明

字段	说明
`ret`	`ok` 成功，`err` 失败
`data.pinyin`	核心字段：按选项拼接后的拼音字符串
`data.list`	逐字明细：[{char, pinyin, type}, ...]；type 为 han / other / unknown
`data.list[].readings`	`heteronym=1` 时返回该字全部读音
`data.unknown_count`	未识别汉字数量
`data.options`	本次生效的选项回显
`msg`	本站提示，如「次数充足，剩余 99 次」或「次数不足，剩余 0 次」
`remain_quota`	本次调用后的剩余次数

可直接复制的代码

未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key，不会展示别人的。

<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/pinyin');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{
    "text": "云南科技",
    "tone": 1,
    "separator": " ",
    "ucfirst": 1
}',
]);
echo curl_exec($ch);

import requests

url = 'https://api.ynlskj.com.cn/gateway/pinyin'
headers = {'X-API-Key': '你的密钥'}
resp = requests.post(url, headers=headers, json={
    "text": "云南科技",
    "tone": 1,
    "separator": " ",
    "ucfirst": 1
}, timeout=15)
print(resp.text)

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "text": "云南科技",
    "tone": 1,
    "separator": " ",
    "ucfirst": 1
}`)
	req, _ := http.NewRequest("POST", "https://api.ynlskj.com.cn/gateway/pinyin", body)
	req.Header.Set("X-API-Key", "你的密钥")
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(string(out))
}

fetch('https://api.ynlskj.com.cn/gateway/pinyin', {
  method: 'POST',
  headers: {
    'X-API-Key': '你的密钥',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "text": "云南科技",
    "tone": 1,
    "separator": " ",
    "ucfirst": 1
})
})
  .then(res => res.json())
  .then(data => console.log(data));

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.ynlskj.com.cn/gateway/pinyin"))
    .header("X-API-Key", "你的密钥")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\n    \"text\": \"云南科技\",\n    \"tone\": 1,\n    \"separator\": \" \",\n    \"ucfirst\": 1\n}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "你的密钥");
var content = new StringContent("{\n    \"text\": \"云南科技\",\n    \"tone\": 1,\n    \"separator\": \" \",\n    \"ucfirst\": 1\n}", Encoding.UTF8, "application/json");
var result = await client.PostAsync("https://api.ynlskj.com.cn/gateway/pinyin", content);
Console.WriteLine(await result.Content.ReadAsStringAsync());

curl -X POST "https://api.ynlskj.com.cn/gateway/pinyin" \
  -H "X-API-Key: 你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "云南科技",
    "tone": 1,
    "separator": " ",
    "ucfirst": 1
}'

请求参数演示

{"text":"云南科技","tone":1,"separator":" ","ucfirst":1}

响应演示

{"ret":"ok","data":{"text":"云南科技","pinyin":"Yún Nán Kē Jì","list":[{"char":"云","pinyin":"Yún","type":"han"},{"char":"南","pinyin":"Nán","type":"han"},{"char":"科","pinyin":"Kē","type":"han"},{"char":"技","pinyin":"Jì","type":"han"}],"unknown_count":0,"options":{"tone":true,"separator":" ","ucfirst":true,"uppercase":false,"initials":false,"keep_non_chinese":true,"v_to_u":false,"heteronym":false,"phrase":true}}}

在线调试

登录后可在线调试。调试会真实调用网关并消耗次数。

去登录

计费套餐

体验套餐

¥10.00

1,000（1千）次 · 30 天

登录后购买

基础套餐

¥100.00

10,000（1万）次 · 360 天

登录后购买

高级套餐

¥1000.00

100,000（10万）次 · 360 天

登录后购买