TTS
语音合成 API
通过统一接口调用 ElevenLabs 和 Minimax 语音合成服务,支持多语言、多音色的高质量 TTS。
快速开始
1
从控制台获取 API 密钥2
选择下方语音服务商3
发送 POST 请求创建任务4
轮询 GET 请求获取音频链接认证方式
所有请求需在 Header 中携带 Bearer Token:
Authorization: Bearer YOUR_API_KEY
接口端点
POST
/api/v1/audio/tts创建语音合成任务
GET
/api/v1/audio/tts?task_id=xxx查询任务状态并获取音频链接
API 参考
选择语音服务商查看对应的参数和示例
11labs
ElevenLabs
ElevenLabs 行业领先的文本转语音服务,超低延迟,支持 70+ 语言,表现力极强。
可用模型
ElevenLabs TTS Flash
eleven-tts-flash$0.0295/千字符
超快速,32 种语言
ElevenLabs TTS Turbo
eleven-tts-turbo$0.0295/千字符
低延迟,32 种语言
ElevenLabs TTS Multilingual
eleven-tts-multilingual$0.0589/千字符
高质量,29 种语言
ElevenLabs TTS v3
eleven-tts-v3$0.0736/千字符
最强表现力,70+ 种语言
请求参数
model必填
stringeleven-tts-flash / eleven-tts-turbo / eleven-tts-multilingual / eleven-tts-v3text必填
string要转换为语音的文本内容voice_id必填
string声音 ID,见下方常用声音列表language_code
string语言提示,如 "zh"、"en"、"ja",可提升多语言模型准确性callback_url
string任务完成后的回调 URL常用声音 ID
Rachel
对话风格女声
21m00Tcm4TlvDq8ikWAMAdam
低沉男声
pNInz6obpgDQGcFmaJgBBella
温暖女声
EXAVITQu4vr4xnSDxMaL说明
- -eleven-tts-flash 适合实时应用,延迟最低
- -eleven-tts-v3 支持音频标签,可控制情感表达
- -Voice ID 稳定不变,保存一次即可复用
代码示例
# Step 1: Create TTS task
curl -X POST https://apimodels.app/api/v1/audio/tts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "eleven-tts-v3",
"text": "Hello, this is a test of ElevenLabs text-to-speech.",
"voice_id": "21m00Tcm4TlvDq8ikWAM",
"language_code": "en"
}'
# Step 2: Poll status
curl "https://apimodels.app/api/v1/audio/tts?task_id=TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"响应格式
创建任务响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "pending"
}
}成功响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "completed",
"result": "https://cdn.example.com/audio.mp3",
"createTime": 1705123450000,
"completeTime": 1705123460000
}
}失败响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "failed",
"failMsg": "Invalid voice_id"
}
}任务状态
pending任务已排队,等待处理processing语音合成中completed合成成功,可获取音频链接failed合成失败错误码
400请求参数错误或缺失401API 密钥无效402积分不足404任务 ID 不存在500服务器内部错误注意事项
- -音频文件保存 7 天,请及时下载
- -建议每 3-5 秒轮询一次任务状态
- -生产环境建议使用 callback_url 回调
- -生产环境请妥善保管 API 密钥