Elevenlabs Text to Speech API 接入文档
使用 VezAPI 密钥接入 Elevenlabs Text to Speech。下列操作共用同一个账号余额和鉴权方式。
https://api.vezapi.com请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。
ElevenLabs文生语音 多语言V2
/api/v1/jobs/createTask模型标识： elevenlabs/text-to-speech-multilingual-v2
| 参数 | 类型 | 说明与限制 |
|---|---|---|
model必填 | string | 用于生成的模型名称。必填字段。 - 此端点必须使用 `elevenlabs/text-to-speech-multilingual-v2` 可选值： 默认： |
callBackUrl可选 | string | 接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法 |
input必填 | object | 生成任务的输入参数 |
input.text必填 | string | 要转换为语音的文本（最大长度：5000 个字符）
|
input.voice必填 | string | 填下表中的音色 ID。可在浏览器中打开 [see VezAPI documentation]<voice_id>.mp3 试听（将 <voice_id> 替换为实际语音 ID）。例如：[see VezAPI documentation] 可用语音列表： EkK5I93UQWFDigLMpZcX - James - 沙哑、引人入胜、大胆 Z3R5wn05IrDiVCyEkUrK - Arabella - 神秘、富有情感 NNl6r8mD7vthiJatiJt1 - Bradford - 富有表现力、口齿清晰 YOq2y2Up4RgXP2HyXjE5 - Xavier - 霸气、金属感播音员 B8gJV1IhpuegLxdpXFOE - Kuon - 开朗、清晰、稳定 2zRM7PkgwBPiau2jvVXc - Monika Sogam - 低沉、自然 1SM7GgM6IMuvQlz2BwM3 - Mark - 随意、放松、轻快 5l5f8iK3YPeGga21rQIX - Adeline - 女性化、对话式 scOwDtmlUjD3prqpp97I - Sam - 客服代理 NOpBlnGInO9m6vDvFkFC - Spuds Oxley - 睿智、平易近人 BZgkqPqms7Kj9ulSkVzn - Eve - 真实、充满活力、快乐 wo6udizrrtpIxWGp2qJk - Northern Terry gU0LNdkMOQCOrPrwtbee - British Football Announcer - 英国足球解说员 DGzg6RaUqxGRTHSBjfgF - Brock - 威严、大声的军士 x70vRnQBMBu4FAYhjJbO - Nathan - 虚拟电台主持人 Sm1seazb4gs7RSlUVw7c - Anika - 活泼、友好、引人入胜 P1bg08DkjqiVEzOn76yG - Viraj - 丰富、柔和 qDuRKMlYmrm8trt5QyBn - Taksh - 平静、严肃、流畅 qXpMhyvQqiRxWQs4qSSB - Horatius - 充满活力的角色配音 TX3LPaxmHKxFdv7VOQHJ - Liam - 充满活力、社交媒体创作者 N2lVS1w4EtoT3dr4eOWO - Callum - 沙哑的骗子 FGY2WhTYpPnrIDTdsKH5 - Laura - 热情、古怪的态度 kPzsL2i3teMYv0FxEYQ6 - Brittney - 社交媒体语音 - 有趣、年轻、信息丰富 UgBBYS2sOqTuMpoF3BR0 - Mark - 自然对话 hpp4J3VqNfWAUOO0d1Us - Bella - 专业、明亮、温暖 nPczCjzI2devNBz1zQrb - Brian - 低沉、共鸣、令人安慰 uYXf8XasLslADfZ2MB4u - Hope - 活泼、八卦、少女感 gs0tAILXbY5DNrJrsM6F - Jeff - 优雅、共鸣、强劲 DTKMou8ccj1ZaWGBiotd - Jamahal - 年轻、充满活力、自然 vBKc2FfBKJfcZNyEt1n6 - Finn - 年轻、热切、充满活力 DYkrAHD8iwork3YSUBbs - Tom - 对话与书籍 56AoDkrOh6qfVPDXZ7Pt - Cassidy - 清脆、直接、清晰 eR40ATw9ArzDf9h3v7t7 - Addison 2.0 - 澳大利亚有声书与播客 g6xIsTj2HwM6VR4iXFCw - Jessica Anne Bogart - 健谈、友好 lcMyyd2HUfFzxdCaC4Ta - Lucy - 清新、随意 6aDn1KB0hjpdcocrUkmq - Tiffany - 自然、热情 Sq93GQT4X1lKDXsQcixO - Felix - 温暖、积极、现代RP flHkNRp1BlvT73UL6gyz - Jessica Anne Bogart - 雄辩的反派 9yzdeviXkFddZ4Oz8Mok - Lutz - 咯咯笑、欢快 pPdl9cQBQq4p6mRkZy2Z - Emma - 可爱、积极向上 zYcjlYFOd3taleS0gkk3 - Edward - 大声、自信、自负 nzeAacJi50IvxcyDnMXa - Marshal - 友好、幽默的教授 ruirxsoakN0GWmGNIo04 - John Morgan - 粗犷、坚韧的牛仔 TC0Zp7WVFzhA8zpTlRqV - Aria - 性感反派 ljo9gAlSqKOvF6D8sOsX - Viking Bjorn - 史诗中世纪掠夺者 PPzYpIqttlTYA83688JI - Pirate Marshal - 海盗元帅 8JVbfL6oEdmuxKn5DK2C - Johnny Kid - 严肃、平静的旁白 iCrDUkL56s3C8sCRl7wb - Hope - 诗意、浪漫、迷人 wJqPPQ618aTW29mptyoc - Ana Rita - 流畅、富有表现力、明亮 EiNlNiXeDU1pqqOPrYMO - John Doe - 低沉 4YYIPFl9wE5c4L2eu2Gb - Burt Reynolds™ - 低沉、流畅、清晰 6F5Zhi321D3Oq7v1oNT4 - Hank - 低沉、引人入胜的旁白 YXpFCvM1S3JbWEJhoskW - Wyatt - 睿智乡村牛仔 LG95yZDEHg6fCZdQjLqj - Phil - 爆发力、热情播音员 CeNX9CMwmxDxUF5Q2Inm - Johnny Dynamite - 复古电台DJ aD6riP1btT197c6dACmy - Rachel M - 专业英国电台主持人 mtrellq69YZsNwzUSyXh - Rex Thunder - 低沉强硬 dHd5gvgSOzSfduK4CvEg - Ed - 深夜播音员 eVItLK1UvXctxuaRV2Oq - Jean - 迷人、俏皮的蛇蝎美人 esy0r39YPLQjOczyOib8 - Britney - 冷静、算计的反派 Tsns2HvNFKfGiNjllgqo - Sven - 情感丰富、友善 1U02n4nD6AdIZ9CjF053 - Viraj - 流畅、温柔 AeRdCCKzvd23BpJoofzx - Nathaniel - 引人入胜、英式、平静 LruHrtVF6PSyGItzMNHS - Benjamin - 低沉、温暖、平静 1wGbFxmAM3Fgw63G1zZJ - Allison - 平静、舒缓、冥想 hqfrgApggtO1785R4Fsn - Theodore HQ - 宁静、沉稳 MJ0RnG71ty4LH3dvNfSd - Leon - 舒缓、沉稳 可选值： 默认： |
input.stability可选 | number | 语音稳定性（0-1）（最小值：0，最大值：1，步长：0.01）（步长：0.01） 默认：
|
input.similarity_boost可选 | number | 相似度提升（0-1）（最小值：0，最大值：1，步长：0.01）（步长：0.01） 默认：
|
input.style可选 | number | 风格夸张程度（0-1）（最小值：0，最大值：1，步长：0.01）（步长：0.01） 默认：
|
input.speed可选 | number | 语音速度（0.7-1.2）。低于 1.0 的值会减慢语音，高于 1.0 的值会加速语音。极端值可能会影响质量。（最小值：0.7，最大值：1.2，步长：0.01）（步长：0.01） 默认：
|
input.timestamps可选 | boolean | 是否返回生成语音中每个单词的时间戳（布尔值：true/false） |
input.previous_text可选 | string | 当前请求文本之前出现的文本。可以用来在连接多个生成时改善语音连续性，或者影响当前生成中的语音连续性。（最大长度：5000 个字符）
|
input.next_text可选 | string | 当前请求文本之后出现的文本。可以用来在连接多个生成时改善语音连续性，或者影响当前生成中的语音连续性。（最大长度：5000 个字符）
|
input.language_code可选 | string | 语言代码（ISO 639-1），用于为模型强制指定语言。目前只有 Turbo v2.5 和 Flash v2.5 支持语言强制。对于其他模型，如果提供了语言代码，将返回错误。（最大长度：500 个字符）
|
请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
-H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
-H 'Idempotency-Key: your-unique-request-id' \
-H 'Content-Type: application/json' \
-d '{
"model": "elevenlabs/text-to-speech-multilingual-v2",
"input": {
"text": "Unlock powerful API with Kie.ai! Affordable, scalable APl integration, free trial playground, and secure, reliable performance.",
"voice": "EkK5I93UQWFDigLMpZcX"
}
}'返回值与错误
HTTP 200
请求成功
| 参数 | 类型 | 说明与限制 |
|---|---|---|
code可选 | integer | Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying). 可选值： |
msg可选 | string | Response message, error description upon failure |
data必填 | object | |
data.taskId必填 | string | The task ID can be used with the "Get Task Details" endpoint to query the task status. |
HTTP 500
响应字段与业务状态码。
| 参数 | 类型 | 说明与限制 |
|---|---|---|
code必填 | integer | 业务状态码：200 请求成功；401 鉴权凭据缺失或无效；402 积分不足；404 资源或接口不存在；408 超过 10 分钟未返回结果；422 参数校验失败；429 请求频率超限；455 系统维护；500 处理请求时发生内部错误；501 内容生成失败；505 功能当前关闭。 |
msg必填 | string | 响应消息；失败时说明错误原因。 |
data必填 | object |
ElevenLabs Turbo 2.5文生语音
/api/v1/jobs/createTask模型标识： elevenlabs/text-to-speech-turbo-2-5
| 参数 | 类型 | 说明与限制 |
|---|---|---|
model必填 | string | 用于生成的模型名称。必填字段。 - 此端点必须使用 `elevenlabs/text-to-speech-turbo-2-5` 可选值： 默认： |
callBackUrl可选 | string | 接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法 |
input必填 | object | 生成任务的输入参数 |
input.text必填 | string | 要转换为语音的文本（最大长度：5000 个字符）
|
input.voice必填 | string | 填下表中的音色 ID。可在浏览器中打开 [see VezAPI documentation]<voice_id>.mp3 试听（将 <voice_id> 替换为实际语音 ID）。例如：[see VezAPI documentation] 可用语音列表： EkK5I93UQWFDigLMpZcX - James - 沙哑、引人入胜、大胆 Z3R5wn05IrDiVCyEkUrK - Arabella - 神秘、富有情感 NNl6r8mD7vthiJatiJt1 - Bradford - 富有表现力、口齿清晰 YOq2y2Up4RgXP2HyXjE5 - Xavier - 霸气、金属感播音员 B8gJV1IhpuegLxdpXFOE - Kuon - 开朗、清晰、稳定 2zRM7PkgwBPiau2jvVXc - Monika Sogam - 低沉、自然 1SM7GgM6IMuvQlz2BwM3 - Mark - 随意、放松、轻快 5l5f8iK3YPeGga21rQIX - Adeline - 女性化、对话式 scOwDtmlUjD3prqpp97I - Sam - 客服代理 NOpBlnGInO9m6vDvFkFC - Spuds Oxley - 睿智、平易近人 BZgkqPqms7Kj9ulSkVzn - Eve - 真实、充满活力、快乐 wo6udizrrtpIxWGp2qJk - Northern Terry gU0LNdkMOQCOrPrwtbee - British Football Announcer - 英国足球解说员 DGzg6RaUqxGRTHSBjfgF - Brock - 威严、大声的军士 x70vRnQBMBu4FAYhjJbO - Nathan - 虚拟电台主持人 Sm1seazb4gs7RSlUVw7c - Anika - 活泼、友好、引人入胜 P1bg08DkjqiVEzOn76yG - Viraj - 丰富、柔和 qDuRKMlYmrm8trt5QyBn - Taksh - 平静、严肃、流畅 qXpMhyvQqiRxWQs4qSSB - Horatius - 充满活力的角色配音 TX3LPaxmHKxFdv7VOQHJ - Liam - 充满活力、社交媒体创作者 N2lVS1w4EtoT3dr4eOWO - Callum - 沙哑的骗子 FGY2WhTYpPnrIDTdsKH5 - Laura - 热情、古怪的态度 kPzsL2i3teMYv0FxEYQ6 - Brittney - 社交媒体语音 - 有趣、年轻、信息丰富 UgBBYS2sOqTuMpoF3BR0 - Mark - 自然对话 hpp4J3VqNfWAUOO0d1Us - Bella - 专业、明亮、温暖 nPczCjzI2devNBz1zQrb - Brian - 低沉、共鸣、令人安慰 uYXf8XasLslADfZ2MB4u - Hope - 活泼、八卦、少女感 gs0tAILXbY5DNrJrsM6F - Jeff - 优雅、共鸣、强劲 DTKMou8ccj1ZaWGBiotd - Jamahal - 年轻、充满活力、自然 vBKc2FfBKJfcZNyEt1n6 - Finn - 年轻、热切、充满活力 DYkrAHD8iwork3YSUBbs - Tom - 对话与书籍 56AoDkrOh6qfVPDXZ7Pt - Cassidy - 清脆、直接、清晰 eR40ATw9ArzDf9h3v7t7 - Addison 2.0 - 澳大利亚有声书与播客 g6xIsTj2HwM6VR4iXFCw - Jessica Anne Bogart - 健谈、友好 lcMyyd2HUfFzxdCaC4Ta - Lucy - 清新、随意 6aDn1KB0hjpdcocrUkmq - Tiffany - 自然、热情 Sq93GQT4X1lKDXsQcixO - Felix - 温暖、积极、现代RP flHkNRp1BlvT73UL6gyz - Jessica Anne Bogart - 雄辩的反派 9yzdeviXkFddZ4Oz8Mok - Lutz - 咯咯笑、欢快 pPdl9cQBQq4p6mRkZy2Z - Emma - 可爱、积极向上 zYcjlYFOd3taleS0gkk3 - Edward - 大声、自信、自负 nzeAacJi50IvxcyDnMXa - Marshal - 友好、幽默的教授 ruirxsoakN0GWmGNIo04 - John Morgan - 粗犷、坚韧的牛仔 TC0Zp7WVFzhA8zpTlRqV - Aria - 性感反派 ljo9gAlSqKOvF6D8sOsX - Viking Bjorn - 史诗中世纪掠夺者 PPzYpIqttlTYA83688JI - Pirate Marshal - 海盗元帅 8JVbfL6oEdmuxKn5DK2C - Johnny Kid - 严肃、平静的旁白 iCrDUkL56s3C8sCRl7wb - Hope - 诗意、浪漫、迷人 wJqPPQ618aTW29mptyoc - Ana Rita - 流畅、富有表现力、明亮 EiNlNiXeDU1pqqOPrYMO - John Doe - 低沉 4YYIPFl9wE5c4L2eu2Gb - Burt Reynolds™ - 低沉、流畅、清晰 6F5Zhi321D3Oq7v1oNT4 - Hank - 低沉、引人入胜的旁白 YXpFCvM1S3JbWEJhoskW - Wyatt - 睿智乡村牛仔 LG95yZDEHg6fCZdQjLqj - Phil - 爆发力、热情播音员 CeNX9CMwmxDxUF5Q2Inm - Johnny Dynamite - 复古电台DJ aD6riP1btT197c6dACmy - Rachel M - 专业英国电台主持人 mtrellq69YZsNwzUSyXh - Rex Thunder - 低沉强硬 dHd5gvgSOzSfduK4CvEg - Ed - 深夜播音员 eVItLK1UvXctxuaRV2Oq - Jean - 迷人、俏皮的蛇蝎美人 esy0r39YPLQjOczyOib8 - Britney - 冷静、算计的反派 Tsns2HvNFKfGiNjllgqo - Sven - 情感丰富、友善 1U02n4nD6AdIZ9CjF053 - Viraj - 流畅、温柔 AeRdCCKzvd23BpJoofzx - Nathaniel - 引人入胜、英式、平静 LruHrtVF6PSyGItzMNHS - Benjamin - 低沉、温暖、平静 1wGbFxmAM3Fgw63G1zZJ - Allison - 平静、舒缓、冥想 hqfrgApggtO1785R4Fsn - Theodore HQ - 宁静、沉稳 MJ0RnG71ty4LH3dvNfSd - Leon - 舒缓、沉稳 可选值： 默认： |
input.stability可选 | number | 语音稳定性（0-1）（最小值：0，最大值：1，步长：0.01）（步长：0.01） 默认：
|
input.similarity_boost可选 | number | 相似度提升（0-1）（最小值：0，最大值：1，步长：0.01）（步长：0.01） 默认：
|
input.style可选 | number | 风格夸张程度（0-1）（最小值：0，最大值：1，步长：0.01）（步长：0.01） 默认：
|
input.speed可选 | number | 语音速度（0.7-1.2）。低于 1.0 的值会减慢语音，高于 1.0 的值会加速语音。极端值可能会影响质量。（最小值：0.7，最大值：1.2，步长：0.01）（步长：0.01） 默认：
|
input.timestamps可选 | boolean | 是否返回生成语音中每个单词的时间戳（布尔值：true/false） |
input.previous_text可选 | string | 当前请求文本之前出现的文本。可以用来在连接多个生成时改善语音连续性，或者影响当前生成中的语音连续性。（最大长度：5000 个字符）
|
input.next_text可选 | string | 当前请求文本之后出现的文本。可以用来在连接多个生成时改善语音连续性，或者影响当前生成中的语音连续性。（最大长度：5000 个字符）
|
input.language_code可选 | string | 语言代码（ISO 639-1），用于为模型强制指定语言。目前只有 Turbo v2.5 和 Flash v2.5 支持语言强制。对于其他模型，如果提供了语言代码，将返回错误。（最大长度：500 个字符）
|
请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
-H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
-H 'Idempotency-Key: your-unique-request-id' \
-H 'Content-Type: application/json' \
-d '{
"model": "elevenlabs/text-to-speech-turbo-2-5",
"input": {
"text": "Unlock powerful API with Kie.ai! Affordable, scalable APl integration, free trial playground, and secure, reliable performance."
}
}'返回值与错误
HTTP 200
请求成功
| 参数 | 类型 | 说明与限制 |
|---|---|---|
code可选 | integer | Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying). 可选值： |
msg可选 | string | Response message, error description when failed |
data必填 | object | |
data.taskId可选 | string | Task ID, can be used with Get Task Details endpoint to query task status |
data.recordId可选 | string | Record ID, can be used to get the record details |
HTTP 500
响应字段与业务状态码。
| 参数 | 类型 | 说明与限制 |
|---|---|---|
code必填 | integer | 业务状态码：200 请求成功；401 鉴权凭据缺失或无效；402 积分不足；404 资源或接口不存在；408 超过 10 分钟未返回结果；422 参数校验失败；429 请求频率超限；455 系统维护；500 处理请求时发生内部错误；501 内容生成失败；505 功能当前关闭。 |
msg必填 | string | 响应消息；失败时说明错误原因。 |
data必填 | object |
任务状态与回调
异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。
超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。
文件、日志与计费
生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。
调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。