文档中心
aigc_server 数字人 PaaS 服务
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 数字人 PaaS 服务
  • 服务端 API
  • 语音合成
  • 创建语音合成任务

服务端 API 版块于4月16日至5月15日升级维护,期间暂停信息更新,如有任何疑问,请联系ZEGO技术支持。

创建异步语音合成任务

更新时间:2025-04-15 19:16

描述

调用本接口,传入音色、文本、语速、语调和音量等参数,创建一个异步语音合成任务,基于文本生成音频。

接口原型

  • 请求方法:POST
  • 中国大陆正式环境请求地址:https://aigc-api.zegotech.cn/?Action=CreateTtsTask
  • 传输协议:HTTPS
  • 调用频率限制:10 次/秒

请求参数

以下请求参数列表仅列出了接口请求参数,公共参数列表请参考 调用方式 - 公共请求参数。

参数 类型 是否必选 描述
TimbreId
String
是
音色 ID,可通过 查询音色列表 获取。
Text
String
是
文本内容,不超过 1800 个字。支持 SSML标记语言。
SpeechRate
Int
否
语速,取值范围为 [-500, 500],默认值 0。数值越大,声音越快。
PitchRate
Int
否
语调,取值范围为 [-500, 500],默认值 0。数值越大,声音越尖。
Volume
Int
否
音量,取值范围为 [1, 100],默认值 50。数值越大,声音越大。

请求示例

  • 请求 URL

    https://aigc-api.zegotech.cn/?Action=CreateTtsTask
    &AppId=1234567890
    &SignatureNonce=15215528852396
    &Timestamp=1234567890
    &Signature=7a2c0f11145fb760d607a07b54825013
    &SignatureVersion=2.0
  • 请求消息体

    {
        "TimbreId": "your_timebre_id",
        "Text": "时维九月,序属三秋。潦水尽而寒潭清,烟光凝而暮山紫。俨骖騑于上路,访风景于崇阿。临帝子之长洲,得天人之旧馆。层峦耸翠,上出重霄;飞阁流丹,下临无地。鹤汀凫渚,穷岛屿之萦回;桂殿兰宫,即冈峦之体势。",
        "SpeechRate": 0,
        "PitchRate": 0,
        "Volume": 50
    }

响应参数

参数 类型 描述
Code
Int
错误码。
Message
String
错误描述。
Data
Object
响应对象。
TaskId
String
语音合成任务 ID。获取任务 ID 后,请 查询语音合成任务 传入此 ID,获取相关音频下载 URL。

响应示例

{
    "Code": 0,
    "Message": "succeed",
    "Data": {
        "TaskId": "XXXXXXXXXXXX",
    }
}

返回码

以下仅列出了常见的接口业务逻辑相关的返回码,完整返回码请参考 全局返回码。

返回码 说明 处理建议
0 成功。 -
100000004 签名过期。 请重新生成签名。
100000005 签名错误。 请确认生成签名的参数是否正确。
400000001 输入参数无效。 请根据 Message 提示,调整对应参数的取值。
400000002 数字人 PaaS 服务权限未开通。 请联系 ZEGO 技术支持开通服务权限。
400000004 未找到音色。 请确认设置的 TimbreId 是否正确。
400010000 系统错误。 请联系 ZEGO 技术支持处理。
400010001 未获得接口调用权限。 请联系 ZEGO 技术支持开通服务权限。
本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈