ElevenLabs V3 API 接入文档

使用 VezAPI 密钥接入 ElevenLabs V3。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

ElevenLabs对话文生语音V3

POST/api/v1/jobs/createTask

模型标识： elevenlabs/text-to-dialogue-v3

参数	类型	说明与限制
`model` 必填	`string`	用于生成的模型名称。必填字段。 - 此端点必须使用 `elevenlabs/text-to-dialogue-v3` 可选值：`"elevenlabs/text-to-dialogue-v3"` 默认：`"elevenlabs/text-to-dialogue-v3"`
`callBackUrl` 可选	`string`	接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法
`input` 必填	`object`	生成任务的输入参数
`input.dialogue` 必填	`array`	对话项数组。每个项包含文本和语音角色。所有文本字段的总字符数不得超过 5000 个字符。
`input.dialogue[].text` 必填	`string`	对话文本内容。对话数组中所有文本字段的总字符数不得超过 5000 个字符。
`input.dialogue[].voice` 必填	`string`	用于此对话行的语音。可为预设名称（如 Adam、Brian）或 voice_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 - 舒缓、沉稳可选值："EkK5I93UQWFDigLMpZcX", "Z3R5wn05IrDiVCyEkUrK", "NNl6r8mD7vthiJatiJt1", "YOq2y2Up4RgXP2HyXjE5", "B8gJV1IhpuegLxdpXFOE", "2zRM7PkgwBPiau2jvVXc", "1SM7GgM6IMuvQlz2BwM3", "5l5f8iK3YPeGga21rQIX", "scOwDtmlUjD3prqpp97I", "NOpBlnGInO9m6vDvFkFC", "BZgkqPqms7Kj9ulSkVzn", "wo6udizrrtpIxWGp2qJk", "gU0LNdkMOQCOrPrwtbee", "DGzg6RaUqxGRTHSBjfgF", "x70vRnQBMBu4FAYhjJbO", "Sm1seazb4gs7RSlUVw7c", "P1bg08DkjqiVEzOn76yG", "qDuRKMlYmrm8trt5QyBn", "qXpMhyvQqiRxWQs4qSSB", "TX3LPaxmHKxFdv7VOQHJ", "N2lVS1w4EtoT3dr4eOWO", "FGY2WhTYpPnrIDTdsKH5", "kPzsL2i3teMYv0FxEYQ6", "UgBBYS2sOqTuMpoF3BR0", "hpp4J3VqNfWAUOO0d1Us", "nPczCjzI2devNBz1zQrb", "uYXf8XasLslADfZ2MB4u", "gs0tAILXbY5DNrJrsM6F", "DTKMou8ccj1ZaWGBiotd", "vBKc2FfBKJfcZNyEt1n6", "DYkrAHD8iwork3YSUBbs", "56AoDkrOh6qfVPDXZ7Pt", "eR40ATw9ArzDf9h3v7t7", "g6xIsTj2HwM6VR4iXFCw", "lcMyyd2HUfFzxdCaC4Ta", "6aDn1KB0hjpdcocrUkmq", "Sq93GQT4X1lKDXsQcixO", "flHkNRp1BlvT73UL6gyz", "9yzdeviXkFddZ4Oz8Mok", "pPdl9cQBQq4p6mRkZy2Z", "zYcjlYFOd3taleS0gkk3", "nzeAacJi50IvxcyDnMXa", "ruirxsoakN0GWmGNIo04", "TC0Zp7WVFzhA8zpTlRqV", "ljo9gAlSqKOvF6D8sOsX", "PPzYpIqttlTYA83688JI", "8JVbfL6oEdmuxKn5DK2C", "iCrDUkL56s3C8sCRl7wb", "wJqPPQ618aTW29mptyoc", "EiNlNiXeDU1pqqOPrYMO", "4YYIPFl9wE5c4L2eu2Gb", "6F5Zhi321D3Oq7v1oNT4", "YXpFCvM1S3JbWEJhoskW", "LG95yZDEHg6fCZdQjLqj", "CeNX9CMwmxDxUF5Q2Inm", "aD6riP1btT197c6dACmy", "mtrellq69YZsNwzUSyXh", "dHd5gvgSOzSfduK4CvEg", "eVItLK1UvXctxuaRV2Oq", "esy0r39YPLQjOczyOib8", "Tsns2HvNFKfGiNjllgqo", "1U02n4nD6AdIZ9CjF053", "AeRdCCKzvd23BpJoofzx", "LruHrtVF6PSyGItzMNHS", "1wGbFxmAM3Fgw63G1zZJ", "hqfrgApggtO1785R4Fsn", "MJ0RnG71ty4LH3dvNfSd" 默认：`"EkK5I93UQWFDigLMpZcX"`
`input.stability` 可选	`number`	声音稳定性调节参数。必须是以下值之一：0.0、0.5 或 1.0 可选值：`0, 0.5, 1` 默认：`0.5`
`input.language_code` 可选	`string`	语言代码。默认为空字符串或不传，代表自动检测语言。可选值：`"af", "ar", "hy", "as", "az", "be", "bn", "bs", "bg", "ca", "ceb", "ny", "hr", "cs", "da", "nl", "en", "et", "fil", "fi", "fr", "gl", "ka", "de", "el", "gu", "ha", "he", "hi", "hu", "is", "id", "ga", "it", "ja", "jv", "kn", "kk", "ky", "ko", "lv", "ln", "lt", "lb", "mk", "ms", "ml", "zh", "mr", "ne", "no", "ps", "fa", "pl", "pt", "pa", "ro", "ru", "sr", "sd", "sk", "sl", "so", "es", "sw", "sv", "ta", "te", "th", "tr", "uk", "ur", "vi", "cy"`

请求示例

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-dialogue-v3",
  "input": {
    "dialogue": [
      {
        "text": "I have a pen, I have an apple, ah, Apple pen~",
        "voice": "EkK5I93UQWFDigLMpZcX"
      },
      {
        "text": "a happy dog",
        "voice": "Z3R5wn05IrDiVCyEkUrK"
      },
      {
        "text": "a happy cat",
        "voice": "NNl6r8mD7vthiJatiJt1"
      }
    ]
  }
}'

返回值与错误

HTTP 200

请求成功

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 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。