优谷·雅言SDK 文档2.0.0

语音合成

文本合成为中文或英文语音,返回音频地址。

查看 Markdown
POSThttps://open.shengzhiai.com/api/v1/tts/generate

请求示例

Shell
# 语音合成。被签名参数为请求体顶层的非空标量字段,按键名排序
BODY='{"text":"你好世界","language":"zh-CN","voice":"xiaoyan","format":"mp3"}'
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
SIGN=$(printf 'format=mp3&language=zh-CN&text=你好世界&voice=xiaoyan' | openssl dgst -sha256 -hmac "$YUGU_SECRET_KEY" -binary | base64)

curl -sS https://open.shengzhiai.com/api/v1/tts/generate \
  -H "Content-Type: application/json" \
  -H "X-App-Key: $YUGU_APP_KEY" \
  -H "X-Timestamp: $TS" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGN" \
  -H "Idempotency-Key: $(openssl rand -hex 16)" \
  -d "$BODY"

返回示例

200
{
  "code": 0,
  "message": "success",
  "data": {
    "audioUrl": "https://ygyx.dragonai.tech/tts-local/0c02b59749694e518fa8c6c6a78c2377.mp3",
    "duration": "1.348",
    "format": "mp3",
    "warnings": []
  },
  "timestamp": 1791447692219
}

请求体#

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 的结果模型同时给出原始地址与可直接播放的完整地址。

更新于 2026-10-08