ElevenLabs Turbo 2.5 TTS API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 状态 | 已上线 |
|---|---|
| HiAPI 模型 ID | elevenlabs/text-to-speech-turbo-2-5 |
| 售价 | $0.043 / 1,000 characters |
| 单次文本 | 1-5,000 字符 |
| 类型 | 音频生成（文生语音） |
ElevenLabs Turbo 2.5 TTS 是 ElevenLabs 的低延迟、高性价比文本转语音模型，适合语音助手、通知播报和大批量配音。HiAPI 通过统一异步任务接口提供 67 个预置音色，按 text 字符数计费。
生产建议
参数说明
- 公开 input 支持 text、voice、stability、similarity_boost、style、speed、timestamps、previous_text、next_text、language_code。
- 只按 text 的字符数计费（$0.043 / 1,000 characters），previous_text / next_text 不计费；text 超过 5,000 字符会在提交时被拒绝且不扣费。
- language_code 为两位 ISO 639-1 小写代码；省略时自动检测语言。
适用场景
语音助手与智能体
低延迟生成短回复与提示语。
textvoicespeed批量通知播报
把提醒、订单状态、客服话术批量转为语音。
textvoice指定语言输出
用 language_code 固定输出语言，避免混合文本误判。
textlanguage_code请求参数
model string 必填 固定填 elevenlabs/text-to-speech-turbo-2-5。
input object 必填 ElevenLabs Turbo 2.5 TTS 的语音合成参数。
text string 必填 待朗读文本，1-5,000 个字符；按 text 的字符数计费（$0.043 / 1,000 characters），中文每个汉字计 1 个字符。
voice string 必填 预置音色 voice_id，共 67 个。 查看预置音色
stability number 可选 0-1，越低越有表现力，越高越稳定。
similarity_boost number 可选 0-1，输出与所选音色的贴合程度。
style number 可选 0-1，风格夸张度，越高强调越明显。
speed number 可选 语速，0.7-1.2。
timestamps boolean 可选 是否返回逐词时间戳。
previous_text string 可选 本段之前的文本（≤5,000 字符），用于分段衔接，不计费。
next_text string 可选 本段之后的文本（≤5,000 字符），用于分段衔接，不计费。
language_code string 可选 可选，两位 ISO 639-1 语言码（如 zh、en、ja），强制输出语言；省略则自动检测。
callback object 可选 可选回调配置；任务进入终态时 HiAPI 主动通知你的服务。
url string 必填 传入 callback 时必填的 HTTPS 地址。
when enum 可选 回调触发时机，固定为 final。
预置音色（67 个）
input.voice 传下表中的 voice_id。
展开全部 67 个音色 收起目录
| 音色 | 风格 | voice_id |
|---|---|---|
| James | 沙哑有磁性，抓耳 | EkK5I93UQWFDigLMpZcX |
| Arabella | 神秘，情感丰富 | Z3R5wn05IrDiVCyEkUrK |
| Bradford | 表现力强，吐字清晰 | NNl6r8mD7vthiJatiJt1 |
| Xavier | 大胆的金属感播音 | YOq2y2Up4RgXP2HyXjE5 |
| Kuon | 开朗清晰，平稳 | B8gJV1IhpuegLxdpXFOE |
| Monika Sogam | 低沉自然 | 2zRM7PkgwBPiau2jvVXc |
| Mark | 随性放松 | 1SM7GgM6IMuvQlz2BwM3 |
| Adeline | 柔美口语化 | 5l5f8iK3YPeGga21rQIX |
| Sam | 客服风 | scOwDtmlUjD3prqpp97I |
| Spuds Oxley | 睿智亲和 | NOpBlnGInO9m6vDvFkFC |
| Eve | 真诚活泼，欢快 | BZgkqPqms7Kj9ulSkVzn |
| Northern Terry | 北英格兰口音 | wo6udizrrtpIxWGp2qJk |
| British Football Announcer | 英式足球解说 | gU0LNdkMOQCOrPrwtbee |
| Brock | 威严军士 | DGzg6RaUqxGRTHSBjfgF |
| Nathan | 虚拟电台主播 | x70vRnQBMBu4FAYhjJbO |
| Anika | 活泼友好，有感染力 | Sm1seazb4gs7RSlUVw7c |
| Viraj | 醇厚柔和 | P1bg08DkjqiVEzOn76yG |
| Taksh | 沉稳严肃，流畅 | qDuRKMlYmrm8trt5QyBn |
| Horatius | 活力角色音 | qXpMhyvQqiRxWQs4qSSB |
| Liam | 活力创作者 | TX3LPaxmHKxFdv7VOQHJ |
| Callum | 沙哑浪子 | N2lVS1w4EtoT3dr4eOWO |
| Laura | 温暖俏皮 | FGY2WhTYpPnrIDTdsKH5 |
| Brittney | 有趣年轻，科普感 | kPzsL2i3teMYv0FxEYQ6 |
| Mark | 自然对话 | UgBBYS2sOqTuMpoF3BR0 |
| Bella | 专业明亮，温暖 | hpp4J3VqNfWAUOO0d1Us |
| Brian | 低沉浑厚，令人安心 | nPczCjzI2devNBz1zQrb |
| Hope | 活泼八卦，年轻 | uYXf8XasLslADfZ2MB4u |
| Jeff | 优雅浑厚，有力 | gs0tAILXbY5DNrJrsM6F |
| Jamahal | 年轻活力，自然 | DTKMou8ccj1ZaWGBiotd |
| Finn | 年轻热切，有活力 | vBKc2FfBKJfcZNyEt1n6 |
| Tom | 对话与有声书 | DYkrAHD8iwork3YSUBbs |
| Cassidy | 干脆直接，清晰 | 56AoDkrOh6qfVPDXZ7Pt |
| Addison 2.0 | 澳洲有声书 | eR40ATw9ArzDf9h3v7t7 |
| Jessica Anne Bogart | 健谈友好 | g6xIsTj2HwM6VR4iXFCw |
| Lucy | 清新随性 | lcMyyd2HUfFzxdCaC4Ta |
| Tiffany | 自然温暖 | 6aDn1KB0hjpdcocrUkmq |
| Felix | 温暖积极，现代英音 | Sq93GQT4X1lKDXsQcixO |
| Jessica Anne Bogart | 雄辩反派 | flHkNRp1BlvT73UL6gyz |
| Lutz | 爱笑开朗 | 9yzdeviXkFddZ4Oz8Mok |
| Emma | 可爱欢快 | pPdl9cQBQq4p6mRkZy2Z |
| Edward | 洪亮自信，张扬 | zYcjlYFOd3taleS0gkk3 |
| Marshal | 友好机智的教授 | nzeAacJi50IvxcyDnMXa |
| John Morgan | 粗犷牛仔 | ruirxsoakN0GWmGNIo04 |
| Aria | 妩媚反派 | TC0Zp7WVFzhA8zpTlRqV |
| Viking Bjorn | 史诗中世纪战士 | ljo9gAlSqKOvF6D8sOsX |
| Pirate Marshal | 海盗风 | PPzYpIqttlTYA83688JI |
| Johnny Kid | 严肃平静的旁白 | 8JVbfL6oEdmuxKn5DK2C |
| Hope | 诗意浪漫，迷人 | iCrDUkL56s3C8sCRl7wb |
| Ana Rita | 流畅明亮，富表现力 | wJqPPQ618aTW29mptyoc |
| John Doe | 低沉 | EiNlNiXeDU1pqqOPrYMO |
| Burt Reynolds™ | 低沉流畅，清晰 | 4YYIPFl9wE5c4L2eu2Gb |
| Hank | 低沉引人的旁白 | 6F5Zhi321D3Oq7v1oNT4 |
| Wyatt | 睿智乡村牛仔 | YXpFCvM1S3JbWEJhoskW |
| Phil | 爆发力强的激情解说 | LG95yZDEHg6fCZdQjLqj |
| Johnny Dynamite | 复古电台 DJ | CeNX9CMwmxDxUF5Q2Inm |
| Rachel M | 专业英伦电台主持 | aD6riP1btT197c6dACmy |
| Rex Thunder | 低沉硬朗 | mtrellq69YZsNwzUSyXh |
| Ed | 深夜电台播音 | dHd5gvgSOzSfduK4CvEg |
| Jean | 迷人俏皮的蛇蝎美人 | eVItLK1UvXctxuaRV2Oq |
| Britney | 冷酷精明的反派 | esy0r39YPLQjOczyOib8 |
| Sven | 富有感情，亲切 | Tsns2HvNFKfGiNjllgqo |
| Viraj | 流畅温柔 | 1U02n4nD6AdIZ9CjF053 |
| Nathaniel | 英音平静，引人入胜 | AeRdCCKzvd23BpJoofzx |
| Benjamin | 低沉温暖，平静 | LruHrtVF6PSyGItzMNHS |
| Allison | 平静舒缓，冥想感 | 1wGbFxmAM3Fgw63G1zZJ |
| Theodore HQ | 安详从容 | hqfrgApggtO1785R4Fsn |
| Leon | 舒缓从容 | MJ0RnG71ty4LH3dvNfSd |
用例示例
基础语音请求
使用默认音色与参数。
请求体
{
"model": "elevenlabs/text-to-speech-turbo-2-5",
"input": {
"text": "欢迎收听今天的产品更新。我们会用三分钟介绍新功能，以及它如何帮你节省时间。",
"voice": "EkK5I93UQWFDigLMpZcX",
"stability": 0.5,
"similarity_boost": 0.75,
"speed": 1,
"language_code": "zh"
}
}分段衔接请求
previous_text / next_text 只提供上下文，不计费。
请求体
{
"model": "elevenlabs/text-to-speech-turbo-2-5",
"input": {
"text": "第二章，雨一直下到天亮。",
"voice": "EkK5I93UQWFDigLMpZcX",
"previous_text": "第一章结束时，她关上了窗。",
"next_text": "清晨的街道空无一人。",
"timestamps": true
}
}获取结果
- 提交成功立即返回 taskId。
- 生产环境优先使用 callback.url；本地调试可轮询 GET /v1/tasks/:id。
- status=success 后从 output[].url 下载音频并按需转存。
常见问题
如何调用这个模型？
在控制台创建 API 密钥，向 POST /v1/tasks 传入模型 ID 和 input，再用 taskId 查询结果或配置 callback。
价格是多少？
$0.043 / 1,000 characters，只计 text 的字符数。
中文字符怎么计算？
每个汉字、字母、数字、标点或空格都计 1 个字符，中文不翻倍。
单次最多多少文字？
5,000 字符；超出会在提交时被拒绝，不扣费。
Turbo 2.5 和 Multilingual v2 怎么选？
Turbo 2.5 更快、价格减半，并支持 language_code；Multilingual v2 音质与情感更稳定，适合长内容。
任务失败会扣费吗？
失败终态不计费；预扣的积分会自动退回。