Skip to main content
POST
多角色对话合成
通过 inputs[] 列表合成多角色对话,每项包含 textvoiceId。对应 ElevenLabs Text to Dialogue:
  • 默认:POST /v1/text-to-dialogue/stream
  • withTimestamps=truePOST /v1/text-to-dialogue/stream/with-timestamps
这是一个异步任务。响应中包含 taskId — 使用获取任务状态轮询。成功时 resultaudioUrl。计费优先使用官方 characterCost,本地 textLength 作兜底。

限制

  • 每次请求最多 100 条台词(inputs
  • 最多 10 个不同的 voiceId
  • 每行文本 1–5000 字符;可含情感标签,如 [giggling][curious]

推荐流程

1

获取音色

调用获取音色列表拿到 voiceId(以及可选的 previewUrl)。
2

创建对话任务

调用 POST /eleven/dialogue,传入 inputs(以及可选的 modeloutputFormatwithTimestamps 等)。
3

轮询音频结果

轮询 GET /eleven/tasks?taskId=xxx 直至状态为 completed,再读取 result.audioUrl

模型

需要字符级时间戳时设置 withTimestamps: true。可用 settings.stability(0–1)控制表达稳定性。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
inputs
object[]
必填

对话台词列表,每项含 text + voiceId

Required array length: 1 - 100 elements
示例:
model
enum<string>

模型(Dialogue 官方默认 eleven_v3)

可用选项:
eleven_v3,
eleven_multilingual_v2,
eleven_turbo_v2_5,
eleven_flash_v2_5
示例:

"eleven_v3"

outputFormat
enum<string>

音频输出格式

可用选项:
mp3_22050_32,
mp3_24000_48,
mp3_44100_32,
mp3_44100_64,
mp3_44100_96,
mp3_44100_128,
mp3_44100_192,
pcm_8000,
pcm_16000,
pcm_22050,
pcm_24000,
pcm_32000,
pcm_44100,
pcm_48000,
ulaw_8000,
alaw_8000,
opus_48000_32,
opus_48000_64,
opus_48000_96,
opus_48000_128,
opus_48000_192
示例:

"mp3_44100_128"

withTimestamps
boolean
默认值:false

是否返回字符级时间戳。true 时走官方 stream/with-timestamps

示例:

false

languageCode
string

语言代码 ISO-639-1(部分模型支持)

示例:

"en"

settings
object

对话生成设置

seed
number

随机种子

示例:

12345

applyTextNormalization
enum<string>

文本归一化

可用选项:
auto,
on,
off
示例:

"auto"

响应

200 - application/json

任务创建成功

taskId
string
必填

任务 ID,用于后续查询结果