ElevenLabs Text to Dialogue v3 API

POST /v1/tasks

所有模型都通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称	elevenlabs/text-to-dialogue-v3
类型	音频生成（对话文生语音）
接口	POST /v1/tasks
价格	见 HiAPI 定价（按字符计费）

ElevenLabs Eleven v3 多说话人对话语音合成：把台词脚本逐句转成自然、情感饱满的对话音频，每句可指定不同音色，支持 70+ 语言，按字符计费。

生产建议

生产环境建议

生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。
长脚本按 5000 字符上限拆成多次调用；同一角色跨调用保持同一 voice_id，听感才连贯。

适用场景

有声剧 / 有声书

多角色台词逐句指定音色，一次调用生成整段对话，Eleven v3 的情感表现力适合叙事内容。

dialogue

播客 / 访谈开场

主持人 + 嘉宾双音色对话，适合播客开场白、新闻播报、访谈模拟等结构化对话。

dialoguestability

游戏 NPC / 互动剧情

每个角色固定一个 voice_id 保持声音一致，批量生成任务对白和剧情台词。

dialogue

多语言配音

支持 70+ 语言，默认自动检测；同一段脚本换语言重写 text 即可产出多语版本。

language_code

请求参数

POST https://api.hiapi.ai/v1/tasks

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
# 把 YOUR_API_KEY 换成你的账号 API Key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "elevenlabs/text-to-dialogue-v3",
  "input": {
    "dialogue": [
      {
        "text": "Welcome to HiAPI — one API for every AI model.",
        "voice": "EkK5I93UQWFDigLMpZcX"
      },
      {
        "text": "Really? Video, image and speech, all with the same key?",
        "voice": "Z3R5wn05IrDiVCyEkUrK"
      }
    ],
    "stability": 0.5
  }
}'

import requests, json

# 业务参数对象，字段随模型而定（见对应模型页）
payload = json.loads(r'''
{
  "model": "elevenlabs/text-to-dialogue-v3",
  "input": {
    "dialogue": [
      {
        "text": "Welcome to HiAPI — one API for every AI model.",
        "voice": "EkK5I93UQWFDigLMpZcX"
      },
      {
        "text": "Really? Video, image and speech, all with the same key?",
        "voice": "Z3R5wn05IrDiVCyEkUrK"
      }
    ],
    "stability": 0.5
  }
}
''')

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # 成功返回 { code, message, data: { taskId } }

// 提交异步任务，成功立即返回 taskId（不等待生成完成）
// 把 YOUR_API_KEY 换成你的账号 API Key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "elevenlabs/text-to-dialogue-v3",
  "input": {
    "dialogue": [
      {
        "text": "Welcome to HiAPI — one API for every AI model.",
        "voice": "EkK5I93UQWFDigLMpZcX"
      },
      {
        "text": "Really? Video, image and speech, all with the same key?",
        "voice": "Z3R5wn05IrDiVCyEkUrK"
      }
    ],
    "stability": 0.5
  }
}),
});
console.log(await resp.json()); // 成功返回 { code, message, data: { taskId } }

model string 必填

固定填 elevenlabs/text-to-dialogue-v3。

示例 elevenlabs/text-to-dialogue-v3

input object 必填

业务参数对象；ElevenLabs Text to Dialogue v3 的模型专属配置都放在这里。

dialogue object[] 必填

对话台词数组，每项 { text, voice }，按顺序合成为一段完整对话音频。 · 所有 text 的总字符数不得超过 5000，超出直接返回 400（不扣费） · 同一角色多句台词固定同一个 voice，听感更一致 · 全部 67 个预置音色见下方「预置音色」表

text string 必填

这一句台词的文本内容（至少 1 个字符）。

voice string 必填

这一句使用的音色 voice_id（预置 67 个，默认 James）。查看下方「预置音色」完整列表 ↓

默认 EkK5I93UQWFDigLMpZcX

language_code enum 可选

生成语音的语言（ISO 代码）。留空 = 自动检测台词语言。查看下方「支持语言」完整列表 ↓

默认 "" 可选值: ""afarhyasazbebnbsbg +65

stability enum 可选

音色稳定性：0 更有情感、更多变；0.5 均衡；1 最稳定、最一致。

默认 0.5 可选值: 00.51

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback

when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

预置音色（67 个）

dialogue[].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`

支持语言（73 种）

language_code 的全部可选值；留空（默认）自动检测台词语言。

展开全部 73 种语言

语言	代码
自动检测（默认）	`""`
南非荷兰语	`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`

用例示例

双人产品对话

两个角色交替对话（James × Arabella），默认稳定性 0.5。

请求体

{
  "model": "elevenlabs/text-to-dialogue-v3",
  "input": {
    "dialogue": [
      {
        "text": "欢迎来到 HiAPI，一个 API 接入所有 AI 模型。",
        "voice": "EkK5I93UQWFDigLMpZcX"
      },
      {
        "text": "真的吗？那视频、图像、语音都能用同一个 key？",
        "voice": "Z3R5wn05IrDiVCyEkUrK"
      },
      {
        "text": "没错，而且还能按量计费。",
        "voice": "EkK5I93UQWFDigLMpZcX"
      }
    ],
    "stability": 0.5
  }
}

播客开场（指定中文）

主持人 + 嘉宾对话，language_code 固定为 zh，稳定性调到 1 让播报更稳。

请求体

{
  "model": "elevenlabs/text-to-dialogue-v3",
  "input": {
    "dialogue": [
      {
        "text": "欢迎收听今天的播客。",
        "voice": "x70vRnQBMBu4FAYhjJbO"
      },
      {
        "text": "很高兴来到这里，今天想聊聊 AI 语音的未来。",
        "voice": "uYXf8XasLslADfZ2MB4u"
      }
    ],
    "language_code": "zh",
    "stability": 1
  }
}

获取结果

提交成功后立即返回 taskId（不等待生成完成）。
生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
status=success 后，从返回的 output[].url 下载生成的音频。
如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

怎么计费？

按对话总字符数计费：所有 text 字段的字符数合计（中文一个字算 1 个字符），乘以每千字符单价。实时单价以价格页为准。查看实时价格

一次最多能合成多少字？

单次调用所有台词的总字符数上限 5000，超出直接返回 400 且不扣费。长脚本请拆成多次调用，按段落切分听感最自然。

音色怎么选？

voice 传预置音色的 voice_id（共 67 个，男女声、旁白、角色音都有），完整列表见本页「预置音色」表；同一角色的多句台词固定同一个 voice_id。查看预置音色表

支持哪些语言？

支持 70+ 语言。默认自动检测台词语言；需要固定语言时传 language_code（如 zh / en / ja）。同一段对话建议使用同一种语言。

输出是什么格式？

生成结果为 MP3 音频（audio/mpeg）。status=success 后从 output[].url 下载；产物 URL 有有效期，建议及时转存到你自己的存储。