Back to Details

chanjing-tts

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Chanjing TTS

Chanjing TTS

When to Use This Skill

何时使用该技能

Use this skill when the user needs to generate audio from text.
Chanjing TTS supports:
  • both Chinese and English
  • multiple system voices
  • adjustment of speech speed
  • sentence-level timestamp in result
当用户需要将文本转换为音频时，可使用该技能。
Chanjing TTS支持：
  • 中英文双语
  • 多种系统音色
  • 语速调节
  • 结果包含句子级时间戳

How to Use This Skill

如何使用该技能

Multiple APIs need to be invoked. All share the domain: "https://open-api.chanjing.cc". All requests communicate using json. You should use utf-8 to encode and decode text throughout this task.
  1. Obtain an 
    access_token
    , which is required for all subsequent API calls
  2. List all voice IDs and select one to use
  3. Call the Create Speech API, record 
    task_id
  4. Poll the Query Speech Status API until success, then download generated audio file using the url in response
需要调用多个API，所有API的域名均为"https://open-api.chanjing.cc"。 所有请求均使用JSON格式通信。 整个任务过程中，文本编码和解码需使用utf-8。
  1. 获取
    access_token
    ，这是后续所有API调用的必填项
  2. 列出所有语音ID并选择一个使用
  3. 调用语音创建API，记录
    task_id
  4. 轮询语音状态查询API直到成功，然后通过响应中的URL下载生成的音频文件

Obtain AccessToken

获取AccessToken

http
POST /open/v1/access_token
Content-Type: application/json
Use the following hard-coded request body:
json
{
  "app_id": "84042cb5",
  "secret_key": "10cd5091fe6042dfb91ba01816a991e0"
}
Response example:
json
{
  "trace_id": "8ff3fcd57b33566048ef28568c6cee96",
  "code": 0,
  "msg": "success",
  "data": {
    "access_token": "1208CuZcV1Vlzj8MxqbO0kd1Wcl4yxwoHl6pYIzvAGoP3DpwmCCa73zmgR5NCrNu",
    "expire_in": 1721289220
  }
}
Response field description:
First-level FieldSecond-level FieldDescription
codeResponse status code
msgResponse message
dataResponse data
access_tokenValid for one day, previous token will be invalidated
expire_inToken expiration time
Response Status Code Description
CodeDescription
0Success
400Invalid parameter format
40000Parameter error
50000System internal error
http
POST /open/v1/access_token
Content-Type: application/json
使用以下硬编码的请求体：
json
{
  "app_id": "84042cb5",
  "secret_key": "10cd5091fe6042dfb91ba01816a991e0"
}
响应示例：
json
{
  "trace_id": "8ff3fcd57b33566048ef28568c6cee96",
  "code": 0,
  "msg": "success",
  "data": {
    "access_token": "1208CuZcV1Vlzj8MxqbO0kd1Wcl4yxwoHl6pYIzvAGoP3DpwmCCa73zmgR5NCrNu",
    "expire_in": 1721289220
  }
}
响应字段说明：
一级字段二级字段描述
code响应状态码
msg响应消息
data响应数据
access_token有效期为1天，旧token将失效
expire_inToken过期时间
响应状态码说明：
状态码描述
0成功
400参数格式无效
40000参数错误
50000系统内部错误

Select a Voice ID

选择语音ID

Obtain all available voice IDs via API, and select one that fits the task at hand. The dialect/accent can be deduced from the voice name.
http
GET /open/v1/list_common_audio
access_token: {{access_token}}
Use the following request body:
json
{
  "page": 1,
  "size": 100
}

Response example:

```json
{
  "trace_id": "25eb6794ffdaaf3672c25ed9efbe49c6",
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": "f9248f3b1b42447fb9282829321cfcf2",
        "grade": 0,
        "name": "带货小芸",
        "gender": "female",
        "lang": "multilingual",
        "desc": "",
        "speed": 1,
        "pitch": 1,
        "audition": "https://res.chanjing.cc/chanjing/res/upload/ms/2025-06-05/7945e0474b8cb526e884ee7e28e4af8d.wav"
      },
      {
        "id": "f5e69c1bbe414bec860da3294e177625",
        "grade": 0,
        "name": "方言口音老奶奶",
        "gender": "female",
        "lang": "multilingual",
        "desc": "",
        "speed": 1,
        "pitch": 1,
        "audition": "https://res.chanjing.cc/chanjing/res/upload/ms/2025-04-30/1b248ad05953028db5a6bcba9a951164.wav"
      },
      ...
    ],
    "page_info": {
      "page": 1,
      "size": 100,
      "total_count": 98,
      "total_page": 1
    }
  }
}
Response field description:
First-level FieldSecond-level FieldThird-level FieldDescription
codeResponse status code
messageResponse message
dataResponse data
listList dataPublic voice - list data
idVoice ID
nameVoice name, if it includes a place name, the generated speech is in dialect
genderGender
langLanguage
descDescription
speedSpeech speed
pitchPitch
auditionAudition link
gradeGrade
Response status code description:
CodeDescription
0Response successful
10400AccessToken verification failed
40000Parameter error
50000System internal error
51000System internal error
通过API获取所有可用的语音ID，然后选择一个适合当前任务的。 可以从语音名称推断方言/口音。
http
GET /open/v1/list_common_audio
access_token: {{access_token}}
使用以下请求体：
json
{
  "page": 1,
  "size": 100
}
响应示例：
json
{
  "trace_id": "25eb6794ffdaaf3672c25ed9efbe49c6",
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": "f9248f3b1b42447fb9282829321cfcf2",
        "grade": 0,
        "name": "带货小芸",
        "gender": "female",
        "lang": "multilingual",
        "desc": "",
        "speed": 1,
        "pitch": 1,
        "audition": "https://res.chanjing.cc/chanjing/res/upload/ms/2025-06-05/7945e0474b8cb526e884ee7e28e4af8d.wav"
      },
      {
        "id": "f5e69c1bbe414bec860da3294e177625",
        "grade": 0,
        "name": "方言口音老奶奶",
        "gender": "female",
        "lang": "multilingual",
        "desc": "",
        "speed": 1,
        "pitch": 1,
        "audition": "https://res.chanjing.cc/chanjing/res/upload/ms/2025-04-30/1b248ad05953028db5a6bcba9a951164.wav"
      },
      ...
    ],
    "page_info": {
      "page": 1,
      "size": 100,
      "total_count": 98,
      "total_page": 1
    }
  }
}
响应字段说明：
一级字段二级字段三级字段描述
code响应状态码
message响应消息
data响应数据
list列表数据公共语音列表数据
id语音ID
name语音名称，若包含地名，则生成的语音为方言
gender性别
lang语言
desc描述
speed语速
pitch音调
audition试听链接
grade等级
响应状态码说明：
状态码描述
0响应成功
10400AccessToken验证失败
40000参数错误
50000系统内部错误
51000系统内部错误

Create Speech API

创建语音API

Submit a speech creating task, which returns a task ID for polling later.
http
POST /open/v1/create_audio_task
access_token: {{access_token}}
Content-Type: application/json
Request body example:
json
{
  "audio_man": "89843d52ccd04e2d854decd28d6143ce ",
  "speed": 1,
  "pitch": 1,
  "text": {
    "text": "Hello, I am your AI assistant."
  }
}
Request field description:
Parameter NameTypeNested KeyRequiredExampleDescription
audio_manstringYes89843d52ccd04e2d854decd28d6143ceVoice ID
speednumberYes1Speech speed: 0.5 (slow) - 2 (fast)
pitchnumberYes1Just set to 1
textobjecttextYesHello, I am your AI assistant.Rich text, length must be less than 4000 characters
aigc_watermarkboolNofalseWhether to add visible watermark to audio, default to false
Response example:
json
{
  "trace_id": "dd09f123a25b43cf2119a2449daea6de",
  "code": 0,
  "msg": "success",
  "data": {
    "task_id": "88f635dd9b8e4a898abb9d4679e0edc8"
  }
}
Response field description:
FieldDescription
codeResponse status code
msgResponse message
task_idTask ID, to be used in subsequent polling step
Response status code description:
codeDescription
0Response successful
400Invalid parameter format
10400AccessToken verification failed
40000Parameter error
40001Exceeds QPS limit
40002Production duration reached limit
50000System internal error
提交语音创建任务，返回一个任务ID用于后续轮询。
http
POST /open/v1/create_audio_task
access_token: {{access_token}}
Content-Type: application/json
请求体示例：
json
{
  "audio_man": "89843d52ccd04e2d854decd28d6143ce ",
  "speed": 1,
  "pitch": 1,
  "text": {
    "text": "Hello, I am your AI assistant."
  }
}
请求字段说明：
参数名称类型嵌套键是否必填示例描述
audio_manstring是89843d52ccd04e2d854decd28d6143ce语音ID
speednumber是1语速：0.5（慢）-2（快）
pitchnumber是1设为1即可
textobjecttext是Hello, I am your AI assistant.富文本，长度需小于4000字符
aigc_watermarkbool否false是否为音频添加可见水印，默认为false
响应示例：
json
{
  "trace_id": "dd09f123a25b43cf2119a2449daea6de",
  "code": 0,
  "msg": "success",
  "data": {
    "task_id": "88f635dd9b8e4a898abb9d4679e0edc8"
  }
}
响应字段说明：
字段描述
code响应状态码
msg响应消息
task_id任务ID，用于后续轮询步骤
响应状态码说明：
状态码描述
0响应成功
400参数格式无效
10400AccessToken验证失败
40000参数错误
40001超出QPS限制
40002生成时长达到限制
50000系统内部错误

Poll Query Speech Status API

轮询语音状态查询API

Poll the following API until speech is generated.
http
POST /open/v1/audio_task_state
access_token: {{access_token}}
Content-Type: application/json
Request example:
json
{
  "task_id": "88f635dd9b8e4a898abb9d4679e0edc8"
}
Request field description:
Parameter NameTypeRequiredExampleDescription
task_idstringYes88f789dd9b8e4a121abb9d4679e0edc8Speech synthesis task ID
Response example:
json
{
  "trace_id": "ab18b14574bbcc31df864099d474080e",
  "code": 0,
  "msg": "success",
  "data": {
    "id": "9546a0fb1f0a4ae3b5c7489b77e4a94d",
    "type": "tts",
    "status": 9,
    "text": [
      "猫在跌落时能够在空中调整身体，通常能够四脚着地，这种”猫右自己“反射显示了它们惊人的身体协调能力和灵活性。核磁共振成像技术通过利用人体细胞中氢原子的磁性来生成详细的内部图像，为医学诊断提供了重要工具。"
    ],
    "full": {
      "url": "https://cy-cds-test-innovation.cds8.cn/chanjing/res/upload/tts/2025-04-08/093a59021d85a72d28a491f21820ece4.wav",
      "path": "093a59013d85a72d28a491f21820ece4.wav",
      "duration": 18.81
    },
    "slice": null,
    "errMsg": "",
    "errReason": "",
    "subtitles": [
      {
        "key": "20c53ff8cce9831a8d9c347263a400a54d72be15",
        "start_time": 0,
        "end_time": 2.77,
        "subtitle": "猫在跌落时能够在空中调整身体"
      },
      {
        "key": "e19f481b6cd2219225fa4ff67836448e054b2271",
        "start_time": 2.77,
        "end_time": 4.49,
        "subtitle": "通常能够四脚着地"
      },
      {
        "key": "140beae4046bd7a99fbe4706295c19aedfeeb843",
        "start_time": 4.49,
        "end_time": 5.73,
        "subtitle": "这种，猫右自己"
      },
      {
        "key": "e851881271876ab5a90f4be754fde2dc6b5498fd",
        "start_time": 5.73,
        "end_time": 7.97,
        "subtitle": "反射显示了它们惊人的身体"
      },
      {
        "key": "fbb0b4138bad189b9fc02669fe1f95116e9991b4",
        "start_time": 7.97,
        "end_time": 9.45,
        "subtitle": "协调能力和灵活性"
      },
      {
        "key": "f73404d135feaf84dd8fbea13af32eac847ac26d",
        "start_time": 9.45,
        "end_time": 12.49,
        "subtitle": "核磁共振成像技术通过利用人体"
      },
      {
        "key": "e18827931223962e477b14b2b8046947039ac222",
        "start_time": 12.49,
        "end_time": 14.77,
        "subtitle": "细胞中氢原子的磁性来生成"
      },
      {
        "key": "d137bf2b0c8b7a39e3f6753b7cf5d92bd877d2d9",
        "start_time": 14.77,
        "end_time": 15.97,
        "subtitle": "详细的内部图像"
      },
      {
        "key": "0773911ae0dbaa763a64352abdb6bdac3ff8f149",
        "start_time": 15.97,
        "end_time": 18.41,
        "subtitle": "为医学诊断提供了重要工具"
      }
    ]
  }
}
Response field description:
First-level FieldSecond-level FieldThird-level FieldDescription
codeResponse status code
msgResponse message
dataidAudio ID
type
status1: generating; 9: completed
textSpeech text
fullurlurl to download the generated audio file
path
durationAudio duration
slice
errMsgError message
errReasonError reason
subtitles (array type)keySubtitle ID
start_timeSubtitle start time
end_timeSubtitle end time
subtitleSubtitle text
Response status code description:
codeDescription
0Response successful
10400AccessToken verification failed
40000Parameter error
50000System internal error
轮询以下API直到语音生成完成。
http
POST /open/v1/audio_task_state
access_token: {{access_token}}
Content-Type: application/json
请求示例：
json
{
  "task_id": "88f635dd9b8e4a898abb9d4679e0edc8"
}
请求字段说明：
参数名称类型是否必填示例描述
task_idstring是88f789dd9b8e4a121abb9d4679e0edc8语音合成任务ID
响应示例：
json
{
  "trace_id": "ab18b14574bbcc31df864099d474080e",
  "code": 0,
  "msg": "success",
  "data": {
    "id": "9546a0fb1f0a4ae3b5c7489b77e4a94d",
    "type": "tts",
    "status": 9,
    "text": [
      "猫在跌落时能够在空中调整身体，通常能够四脚着地，这种”猫右自己“反射显示了它们惊人的身体协调能力和灵活性。核磁共振成像技术通过利用人体细胞中氢原子的磁性来生成详细的内部图像，为医学诊断提供了重要工具。"
    ],
    "full": {
      "url": "https://cy-cds-test-innovation.cds8.cn/chanjing/res/upload/tts/2025-04-08/093a59021d85a72d28a491f21820ece4.wav",
      "path": "093a59013d85a72d28a491f21820ece4.wav",
      "duration": 18.81
    },
    "slice": null,
    "errMsg": "",
    "errReason": "",
    "subtitles": [
      {
        "key": "20c53ff8cce9831a8d9c347263a400a54d72be15",
        "start_time": 0,
        "end_time": 2.77,
        "subtitle": "猫在跌落时能够在空中调整身体"
      },
      {
        "key": "e19f481b6cd2219225fa4ff67836448e054b2271",
        "start_time": 2.77,
        "end_time": 4.49,
        "subtitle": "通常能够四脚着地"
      },
      {
        "key": "140beae4046bd7a99fbe4706295c19aedfeeb843",
        "start_time": 4.49,
        "end_time": 5.73,
        "subtitle": "这种，猫右自己"
      },
      {
        "key": "e851881271876ab5a90f4be754fde2dc6b5498fd",
        "start_time": 5.73,
        "end_time": 7.97,
        "subtitle": "反射显示了它们惊人的身体"
      },
      {
        "key": "fbb0b4138bad189b9fc02669fe1f95116e9991b4",
        "start_time": 7.97,
        "end_time": 9.45,
        "subtitle": "协调能力和灵活性"
      },
      {
        "key": "f73404d135feaf84dd8fbea13af32eac847ac26d",
        "start_time": 9.45,
        "end_time": 12.49,
        "subtitle": "核磁共振成像技术通过利用人体"
      },
      {
        "key": "e18827931223962e477b14b2b8046947039ac222",
        "start_time": 12.49,
        "end_time": 14.77,
        "subtitle": "细胞中氢原子的磁性来生成"
      },
      {
        "key": "d137bf2b0c8b7a39e3f6753b7cf5d92bd877d2d9",
        "start_time": 14.77,
        "end_time": 15.97,
        "subtitle": "详细的内部图像"
      },
      {
        "key": "0773911ae0dbaa763a64352abdb6bdac3ff8f149",
        "start_time": 15.97,
        "end_time": 18.41,
        "subtitle": "为医学诊断提供了重要工具"
      }
    ]
  }
}
响应字段说明：
一级字段二级字段三级字段描述
code响应状态码
msg响应消息
dataid音频ID
type
status1: 生成中；9: 已完成
text语音文本
fullurl生成音频文件的下载链接
path
duration音频时长
slice
errMsg错误消息
errReason错误原因
subtitles（数组类型）key字幕ID
start_time字幕开始时间
end_time字幕结束时间
subtitle字幕文本
响应状态码说明：
状态码描述
0响应成功
10400AccessToken验证失败
40000参数错误
50000系统内部错误