文档
汉字转拼音 API
批量转换

批量转换

接口信息

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

请求参数

参数类型必填默认值说明
textsstring[]是-要转换的汉字文本数组
toneTypestring否symbol声调类型：symbol（符号声调）、none（无声调）、num（数字声调）
patternstring否pinyin输出模式：pinyin（完整拼音）、initial（声母）、final（韵母）、first（首字母）
separatorstring否(空格)分隔符，用于分隔多个拼音

请求示例

基本批量转换 

curl -X POST https://api.apisbo.com/pinyin/batch \
  -H "Content-Type: application/json" \
  -d '{
    "texts": ["你好", "世界", "汉字转拼音"]
  }'

无声调批量转换 

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

首字母批量转换 

curl -X POST https://api.apisbo.com/pinyin/batch \
  -H "Content-Type: application/json" \
  -d '{
    "texts": ["你好", "世界"],
    "pattern": "first",
    "toneType": "none"
  }'

响应示例 

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "original": "你好",
      "pinyin": "nǐ hǎo"
    },
    {
      "original": "世界",
      "pinyin": "shì jiè"
    },
    {
      "original": "汉字转拼音",
      "pinyin": "hàn zì zhuǎn pīn yīn"
    }
  ]
}

无声调批量响应 

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "original": "你好",
      "pinyin": "ni hao"
    },
    {
      "original": "世界",
      "pinyin": "shi jie"
    }
  ]
}

响应字段说明

字段类型说明
data[].originalstring原始文本
data[].pinyinstring拼音字符串

使用场景

  • 批量处理文件名
  • 批量生成拼音标签
  • 数据预处理

注意事项

  • 每次请求最多支持 100 个文本
  • 每个文本最多支持 1000 个汉字
  • 批量处理时性能优于多次单独调用
  • 响应顺序与请求顺序一致
最后更新于
获取声母