请求体#
Content-Type: application/json,被签名参数为请求体顶层的非空标量字段,值取 JSON 里的字面文本,数值只写普通十进制。
textstring必填待合成的文本
languagestring可选zh-CN 默认,en-US,en-GB
voicestring可选中文 xiaoyan 女声或 xiaofeng 男声,英文 female 或 male
formatstring可选mp3 默认,wav,ogg
speedinteger可选语速,0 到 100,默认 50
pitchinteger可选音调,0 到 100,默认 50
volumeinteger可选音量,0 到 100,默认 50
stylestring可选风格,可为 null
请求头与原生整段评测相同,带 Idempotency-Key 时同一个键只合成一次,只计费一次。
状态码#
| 状态 | 错误码 | 原因 |
|---|---|---|
| 200 | 无 | 合成完成 |
| 400 | 40001 | 参数校验失败 |
| 401 | 40100,2001 到 2011 | 未认证,签名错误,token 或 API Key 无效 |
| 409 | 40901,40902,40903 | 同一幂等键处理中,额度不足,幂等键用于不同请求 |
| 429 | 42900,3001 到 3003 | 限流,带 Retry-After |
| 500 | 50000 | 服务器内部错误,可重试 |
返回#
响应为平台信封,data 字段:
audioUrlstring必填音频地址。完整地址可直接播放,以 /audio/ 开头时按基址拼成 https://open.shengzhiai.com/tts/audio/...
durationstring必填时长,单位秒
formatstring必填音频格式
SDK 的结果模型同时给出原始地址与可直接播放的完整地址。