[DEMO] 中文转拼音

返回带声调、按输入顺序的拼音字符串数组，使用上下文默认单读音。非汉字片段保留原文且可能合并；显式空字符串返回空数组成功，DataTotalCount仍为1。支持表单和JSON，不提供多读音或转换风格选项。
将中文词语和句子转换为带声调的拼音，便于展示读音参考。
按输入文本的先后顺序返回拼音，便于按顺序整理转换结果。
使用词语上下文处理常见多音字，默认返回一个读音，不罗列全部读音。
支持中文与英文、数字混排，非汉字片段保留原文。
标点随转换结果保留，可与拼音一起用于句子展示。
支持含空格和换行的段落文本，保留对应的非汉字片段。
可为词条列表制作读音资料，供词语学习和资料整理使用。
可为中文名称提供拼音参考，专名和生僻字仍需结合语境复核。
可将文章片段转换为注音素材，用于内容阅读辅助。
转换结果以字符串数组独立返回，便于应用自行组合拼音显示。
支持表单和 JSON 提交同一文本，已有接入方式可继续使用。
公开样例同时展示原文输入和拼音结果，便于接入时核对。

当前接口契约

接口详情：https://www.gugudata.com/api/details/chinesepinyin

公开 Demo 用于查看调用方式和响应结构，返回范围以示例参数为准。

正常响应

HTTP 200，application/json。

字段	类型	说明
DataStatus	object
DataStatus.RequestParameter	string	真实、可读的业务请求参数；无业务参数时为空，不包含凭据。
DataStatus.StatusCode	integer
DataStatus.StatusDescription	string
DataStatus.ResponseDateTime	string
DataStatus.DataTotalCount	integer	成功结果数量，为 1。
Data	string[]	返回带声调、按输入顺序的拼音字符串数组，使用上下文默认单读音。非汉字片段保留原文且可能合并；显式空字符串返回空数组成功，DataTotalCount仍为1。支持表单和JSON，不提供多读音或转换风格选项。

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数错误	HTTP 400
901	处理、依赖失败或超时	HTTP 503

返回响应

🟢200成功

application/json

业务成功，状态码100。

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "content=咕咕数据基于我们十年来为企业客户提供的千亿级数据存储与性能优化、相关海量基础数据支撑，将合规的部分通用数据、通用功能抽象成产品级数据 API，大大满足了用户在产品开发过程中对基础数据的需求，同时降低了海量数据的存储与运维成本，以及复杂功能的技术门槛与人力开发成本。",
    "StatusCode": 100,
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-10-19 22:15:20.393",
    "DataTotalCount": 1
  },
  "Data": [
    "gū",
    "gū",
    "shù",
    "jù",
    "jī",
    "yú",
    "wǒ",
    "men",
    "shí",
    "nián",
    "lái",
    "wèi",
    "qǐ",
    "yè",
    "kè",
    "hù",
    "tí",
    "gōng",
    "de",
    "qiān",
    "yì",
    "jí",
    "shù",
    "jù",
    "cún",
    "chǔ",
    "yǔ",
    "xìng",
    "néng",
    "yōu",
    "huà",
    "、",
    "xiāng",
    "guān",
    "hǎi",
    "liàng",
    "jī",
    "chǔ",
    "shù",
    "jù",
    "zhī",
    "chēng",
    "，",
    "jiāng",
    "hé",
    "guī",
    "de",
    "bù",
    "fèn",
    "tōng",
    "yòng",
    "shù",
    "jù",
    "、",
    "tōng",
    "yòng",
    "gōng",
    "néng",
    "chōu",
    "xiàng",
    "chéng",
    "chǎn",
    "pǐn",
    "jí",
    "shù",
    "jù",
    " API，",
    "dà",
    "dà",
    "mǎn",
    "zú",
    "le",
    "yòng",
    "hù",
    "zài",
    "chǎn",
    "pǐn",
    "kāi",
    "fā",
    "guò",
    "chéng",
    "zhōng",
    "duì",
    "jī",
    "chǔ",
    "shù",
    "jù",
    "de",
    "xū",
    "qiú",
    "，",
    "tóng",
    "shí",
    "jiàng",
    "dī",
    "le",
    "hǎi",
    "liàng",
    "shù",
    "jù",
    "de",
    "cún",
    "chǔ",
    "yǔ",
    "yùn",
    "wéi",
    "chéng",
    "běn",
    "，",
    "yǐ",
    "jí",
    "fù",
    "zá",
    "gōng",
    "néng",
    "de",
    "jì",
    "shù",
    "mén",
    "kǎn",
    "yǔ",
    "rén",
    "lì",
    "kāi",
    "fā",
    "chéng",
    "běn",
    "。"
  ]
}

🟠400参数错误，业务码501。

🔴503处理、依赖失败或超时，业务码901。

当前接口契约#

正常响应#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

正常响应

业务状态说明