​
音频生成接口

​
接口信息

  • 接口路径: /api/tts/v1/voice/api/generate
  • 请求方式: POST
  • 认证方式: Header 中的 X-API-Key

​
请求头

参数名类型必填说明
X-API-Keyaa是应用密钥
注意： X-API-Key 用于验证账户信息，可在 账户管理>接口密钥 中查看。

​
请求参数

参数名类型必填说明
voiceIdstring是音色ID，例如：jingcheng、bochuan、zhining、nianan
generateTextstring是需要转换的文本内容，最大长度500字符
emotionClassstring否情感类别（可选）

​
请求示例

curl -X POST "https://api.vuilabs.cn/api/tts/v1/voice/api/generate" \
  -H "X-API-Key: your-secret-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "voiceId": "jingcheng",
    "generateText": "你好，欢迎使用TTS服务。",
    "emotionClass": ""
  }'

​
响应参数

参数名类型说明
audioUrlstring生成的音频文件URL
traceIdstring请求追踪ID，用于问题排查

​
成功响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "audioUrl": "https://lunalab-res.oss-cn-hangzhou.aliyuncs.com/audioResult/20251027104221_e3704e2d.wav",
    "traceId": "a1b2c3d4e5f6"
  }
}

​
错误响应示例

{
  "code": 10501,
  "msg": "文本长度超出限制",
  "data": null
}