Skip to content

创建口音合成任务

说明

Cicada-TTS的语音模型提供口音合成能力,支持用户选取相应的口音并且上传一段个人的音色,即可合成具备个人音色和特定口音的音频。

使用流程

口音合成的实现具体流程如下:

  1. 通过文件管理上传自己的音色文件,并获取prompt_audio的参数
  2. 咨询客服或者售后人员获取口音id信息
  3. 上传待合成的文本信息 (文本长度不能超过4000字)
  4. 调用口音合成任务并获取task_id
  5. 根据task_id调用获取语音合成结果的接口,获取相应的音频信息

注意: 此接口为异步任务,具体进度通过查询接口查看,计费:0.2蝉豆/秒,QPS为500/min

更多口音请咨询客服或对应售后人员

声音人名称模型口音id
四川男年轻cicada3.0-turbo89843d52ccd04e2d854decd28d6143ce
南京男年轻cicada3.0-turbob9705cff084c4416b02f01d797025c25
陕西男年轻cicada3.0-turbof28c22c6d26f48f29ee4cc1380adff24
天津年轻男cicada3.0-turbo2c9f4ce01f254b5e9408e5af3b464900
天津年迈女cicada3.0-turboeb370cde929049d9b36debcb6161f053
东北年轻男cicada3.0-turbo4027dfc73c6e4235911dba293f53e62f
台湾口音男cicada3.0-turbo63dd6a2bf2c54cbe828154f393e5d833
闽南口音女cicada3.0-turbo1880b61fc567431aafe35266057a6585
北京年轻男cicada3.0-turbo8a18396b48b54d5f8d4143369145d357
东北年迈女cicada3.0-turboed5eea52f94045198e9ec7c45e54fb96
河南年迈女cicada3.0-turbo737b5b61343640139f539767c03be495
四川年轻女cicada3.0-turbo74afc28ab43544669f50773449acf2b5

请求地址

http
POST /open/v1/create_audio_task_v2
http
access_token: {{access_token}}
Content-Type: application/json

请求参数Body

参数名称类型Nested Key是否必传示例说明
audio_manstringC-f6254806192e4ef99189ae899d89943e声音ID
speednumber1语速(范围:0.5x~2x)
pitchnumber1语调(范围根据声音人类型变化,具体参照类型范围对照表)
textobjecttext你好,我是你的蝉镜数字人(文本长度限制为4000字以下)富文本
plain_text你好,我是你的蝉镜数字人
callbackstring"http://127.0.0.1:8012/test_callback"回调地址(任务结束后会向该地址发送一个 POST 请求。++请求体的格式和++获取语音合成结果++接口查询结果返回的data相同++)
aigc_watermarkboolfalse音频是否加明水印,默认是false
prompt_audiostring09eacb8ead0a423e9dcd75065ae32d25音色prompt,使用特定口音的声音人+音色prompt可以实现让对应音色使用特定口音发音,来自通过文件管理上传的音色文件
mssnumber10AI断句字数,替换原本的font_size、width、height

请求示例

json
{
    "audio_man": "C-f7387406192e4ef99189ae899d89943e",
    "speed": 1,
    "pitch": 1,
    "text": {
        "text": "你好,我是你的蝉镜数字人",
        "plain_text": "你好,我是你的蝉镜数字人"
    },
    "callback": "http://127.0.0.1:8012/test_callback",
    "prompt_audio": "09eacb8ead0a423e9dcd75065ae32d25",
    "mss": 10
}

响应JSON

json
{
    "trace_id": "dd09f123a25b43cf2119a2449daea6de",
    "code": 0,
    "msg": "success",
    "data": {
        "task_id": "88f635dd9b8e4a898abb9d4679e0edc8"
    }
}

声音类型对应语调范围及效率表(声音类型通过查询声音详情接口获取)

声音类型语调范围生成效率
cicada1.0不支持20-25 字符/秒
cicada2.00.1 ~ 3 / -12 ~ 12 (具体范围咨询客服)8-25 字符/秒
cicada3.0不支持20-35 字符/秒
cicada3.0-turbo不支持10-15 字符/秒

响应参数

字段说明
code响应状态码
msg响应消息
task_id语音合成任务ID

响应状态码说明

code说明
0响应成功
400传入参数格式错误
10400AccessToken验证失败
APP状态错误
缺少 tts 文本
缺少音频文件
输入文本不可以包含 emoji
40000参数错误
40001超出QPS限制
40002制作视频时长到达上限
50000系统内部错误
没有找到对应的声音ID
声音ID对应的audio_man不存在或被禁用