快速开始

完成第一次配音

curl -X POST "https://unifiedtts.com/api/v1/speech" \
  -H "Authorization: Bearer $UNIFIEDTTS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id" \
  -d '{"model":"edge-tts-v2","voice":"zh-CN-XiaoxiaoNeural","text":"你好，世界。","parameters":{"speed":1}}'

curl "https://unifiedtts.com/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $UNIFIEDTTS_API_KEY"

将 TASK_ID 设置为提交响应中的 data.id。任务完成后，使用返回的 audioUrl、subtitleUrl 读取已有结果；缺少字幕时 subtitleUrl 为 null。

示例已使用本站接口地址。完成邮箱验证后创建 API Key，在服务端通过 Authorization: Bearer 发送；请妥善保存密钥。

Idempotency-Key 用于安全重试：同一账号的相同键与相同请求返回原任务，不重复预留；修改文案或参数时使用新键。

鉴权与常见错误

模型与音色目录可公开查询，其余接口使用当前账号的 Bearer 密钥。任务与结果文件均校验账号归属；密钥创建与停用在网页控制台完成。

错误统一返回 error.code 和 error.message。400 表示参数不正确，401/403 表示身份或权限问题，402 表示余额不足，409 表示幂等冲突、报价变化或结果未就绪，429 表示请求过频、免费额度或并发受限，503 表示模型停用或服务暂不可用。