声音克隆配音

输入文本与音色（speaker），生成对应音色的配音音频（声音克隆）。无需上传文件，输入即文本。

创建任务

基本信息

项目	值
请求方法	POST
请求路径	/task/audio_tts_clone
Content-Type	application/json
鉴权方式	Authorization 请求头（直接传 API Key）

请求参数（Body）

参数名	类型	必填	默认值	说明
text	string	是	—	待合成文本，非空，长度上限 2000 字
speaker	string	是	—	音色代号（见下方「可用音色」）
text_lang	string	否	zh	目标语言，一期支持中文 zh
output_format	string	否	wav	输出音频格式：wav 或 mp3
speed	number	否	音色预设	语速倍率（0.5 ~ 2.0）；不传则用该音色的预设语速

可用音色（speaker）

音色	代号（speaker）	性别	试听
讲述者	narrator	男
软萌少女	sweet_female	女
广东荣姐	cantonese_accent	女
电台女神	radio_female	女
暖心姐姐	heartwarming_female	女
亲切女声	kind_female	女
授课主播	lecturer	男
弗兰教授	professor_fran	男
灵动女声	energetic_female	女

音色列表会持续更新；调用前请以最新文档为准。「试听」为各音色 demo 示例。

计费说明

按合成时长计费（分钟）。因输出音频为产物、创建任务时尚无音频可探测，时长由文本字数估算（中文约 200 字/分钟）。

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/audio_tts_clone \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "你好，欢迎收听本期节目。",
    "speaker": "narrator",
    "output_format": "wav",
    "speed": 1.0
  }'

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "audio_tts_clone",
    "status": "queued"
  }
}

---

查询任务结果

基本信息

项目	值
请求方法	GET
请求路径	/task/audio_tts_clone/{task_id}
鉴权方式	Authorization 请求头（直接传 API Key）

响应参数（output_result）

参数名	类型	说明
file_id	string	合成音频文件 ID
download_url	string	音频下载路径
speaker	string	使用的音色代号

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "download_url": "/download/a1/output_tts.wav",
      "speaker": "narrator"
    },
    "create_time": "2026-06-21T08:00:00Z",
    "update_time": "2026-06-21T08:00:12Z"
  }
}

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	必填参数缺失（text / speaker）	补齐参数
6011	400	业务参数非法（speaker 不可用、text 超长、speed 越界等）	按参数说明修正
6502	401	鉴权失败	检查 Authorization 请求头
6201	402	额度不足	前往仪表盘充值
6202	402	余额不足	前往仪表盘充值

使用限制

• 单次合成文本上限 2000 字，超长请分次合成。
• 一期仅支持中文（zh）目标语言。
• 仅可使用已授权且质检通过的音色（见「可用音色」）。