01Router

ElevenLabs Eleven v4 API

ElevenLabs Eleven v4: expressive multilingual speech with audio tags, voice selection and delivery controls.

ElevenLabs·音频可用

低至$0.072/ 千字符$0.08省 10%

模型 IDelevenlabs-tts-v4

在 Playground 试用查看 API
text-to-speechvoicemultilingual

输入

文本

输出

音频

供应商

3 家供应商

Stability

0 – 1

Voice similarity

0 – 1

Seed

0 – 4294967295

近 7 天表现 · 近期请求较少，暂无统计数据。

ElevenLabs Eleven v4 价格

价格按单位计费；未指定供应商时，会路由到支持该参数组合且价格最低的供应商。

规格价格（美元）
全部规格
$0.072 / 千字符
1 积分$0.08省 10%

接入前先试用 ElevenLabs Eleven v4

写代码之前，先测试生成效果、对比各供应商价格并预估费用。

供应商
音频
预计费用

输入

prompt
0 / 5000
voice
stability
similarity_boost
language_code
seed
output_format
apply_text_normalization

结果

空闲
生成结果会显示在这里。

本次请求的各供应商报价

输入提示词即可对比各供应商价格。

ElevenLabs Eleven v4 提示词示例

可直接使用的提示词，一键载入 Playground 再调整。

来源
场景分类

共 5 条提示词

Resort escape ad

Advertising

[warmly] Picture this: the curtains open, and there's nothing but ocean. Breakfast takes as long as you like. Work can wait. [softly] Welcome to your week off.

Documentary narration

Narration

Deep beneath the ice, the water is darker than any night. Yet here, against every expectation, life has found a way to thrive.

Excited game announcer

Character

[excited] Ladies and gentlemen, the final round is about to begin! [whispering] And nobody saw this coming.

查看更多

ElevenLabs Eleven v4 API 文档

该模型的接口、请求字段与可直接运行的调用示例。

Base URL

https://01router.com/api/v1
llms.txt

快速开始

将 API_KEY 设为项目密钥，在服务端运行示例。示例中的媒体地址需替换为您自己的公开地址。

自动路由会选择支持当前请求的供应商。选择指定供应商，可查看它的参数约束和调用示例。

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "elevenlabs-tts-v4",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "voice": "Rachel",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "output_format": "mp3_44100_128",
    "apply_text_normalization": "auto"
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

接口列表

这里只列出当前模型相关的接口，路径已包含 /api/v1。点击接口可跳转到使用说明。

POST
/api/v1/generations

创建生成任务（扣积分） · 需要 API 密钥

GET
/api/v1/generations/{id}

查询任务；运行中会向上游拉取状态 · 需要 API 密钥

POST
/api/v1/generations/{id}/cancel

取消进行中的生成任务（退还积分） · 需要 API 密钥

POST
/api/v1/quote

对所有供应商报价（不扣费，无需 Key） · 公开 · 无需密钥

GET
/api/v1/models/elevenlabs-tts-v4

查询单个模型 · 公开 · 无需密钥

鉴权

以 Bearer Token 方式发送 API Key，费用从 Key 所属账户的积分中扣除。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
获取 API Key

输入参数

使用 Content-Type: application/json 发送请求。模型参数放在 input 中，model、provider、callback_url 放在最外层。

请求体

参数名类型必填说明
modelstring是"elevenlabs-tts-v4"
providerstring否指定供应商；不传则自动路由到最便宜的。可选： fal | wavespeed | openrouter
inputobject是模型参数，字段见下方 input 字段表。
callback_urlstring否可选的公开 HTTPS 回调地址，接收带签名的任务最终结果；仍可通过查询接口获取状态。

input · input 字段

必填字段已明确标记，其他字段省略时使用所列默认值。

参数名类型必填可选值默认值
prompt*string是maxLength: 5000—
voicestring否—Rachel
stabilitynumber否min: 0 · max: 10.5
similarity_boostnumber否min: 0 · max: 10.75
language_code
ISO 639-1, e.g. en or zh
string否——
seedinteger否min: 0 · max: 4294967295—
output_formatstring否mp3_22050_32 | mp3_44100_32 | mp3_44100_64 | mp3_44100_96 | mp3_44100_128 | mp3_44100_192 | pcm_8000 | pcm_16000 | pcm_22050 | pcm_24000 | pcm_44100 | pcm_48000 | ulaw_8000 | alaw_8000 | opus_48000_32 | opus_48000_64 | opus_48000_96 | opus_48000_128 | opus_48000_192mp3_44100_128
apply_text_normalizationstring否auto | on | offauto
任务回调 →

输出结果

创建任务成功不代表生成完成。保存 id，查询到 succeeded 或 failed 后，读取 outputs 或 error。示例金额仅作说明，实际费用由请求决定。

queued→processing→succeeded / failed

提交后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "elevenlabs-tts-v4",
  "type": "audio",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "voice": "Rachel",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "output_format": "mp3_44100_128",
    "apply_text_normalization": "auto"
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

完成后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "elevenlabs-tts-v4",
  "type": "audio",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "voice": "Rachel",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "output_format": "mp3_44100_128",
    "apply_text_normalization": "auto"
  },
  "outputs": [
    "https://example.com/output.wav"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

响应字段

参数名类型必填说明
idstring是任务 ID，用于查询或取消任务。
objectstring是generation
modelstring是elevenlabs-tts-v4
typestring是audio
providerstring是供应商
statusstring是queued → processing → succeeded / failed。进入任一终态后停止轮询。
inputobject是模型参数，字段见下方 input 字段表。
outputsstring[]是结果文件 URL 数组。处理中为空；成功后读取并及时下载保存。
errorstring | null是失败原因；无错误时为 null。
creditsnumber是本次请求扣除的积分。
price_usdnumber是本次请求的美元价格。
created_atstring是ISO 8601 格式的任务创建时间。
completed_atstring | null是ISO 8601 格式的完成时间；未完成时为 null。

获取结果

每隔几秒轮询，直到 status 为 succeeded 或 failed。输出链接由供应商托管，可能过期，请及时下载保存；也可以传 callback_url 接收推送。

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed。进入任一终态后停止轮询。 结果文件 URL 数组。处理中为空；成功后读取并及时下载保存。

取消任务

取消取决于供应商支持情况和任务状态。确认取消后返回 status: failed、error: Canceled by user；不支持取消或已完成的任务返回 409 not_cancelable。

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

报价

请求体与创建任务相同。返回按价格排序的可用供应商，以及无法处理该请求的供应商及原因。

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "elevenlabs-tts-v4",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "voice": "Rachel",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "output_format": "mp3_44100_128",
    "apply_text_normalization": "auto"
  }
}
JSON

模型信息与参数

此公开接口返回模型参数，以及各供应商支持的参数约束和价格。

curl "https://01router.com/api/v1/models/elevenlabs-tts-v4"

错误码

结合 HTTP 状态码和 error.message 排查。参数或认证错误需修正后再重试；生成任务失败则通过任务本身的 status 和 error 返回。

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400请求体或参数取值不合法

401缺少或无效的 API Key

402积分不足

404模型或任务不存在

409任务无法取消（已结束，或该供应商不支持取消）

429请求过于频繁，请稍后重试

502所有供应商都拒绝了任务（积分已退回）

鉴权、路由、计费与错误码详见 →

交给 AI 使用

将本模型文档交给编程助手：纯文本包含接口、输入约束、输出字段和请求示例。

打开 llms.txt

ElevenLabs Eleven v4 与同类模型对比

并排对比规格与起步价，选择前建议用同一提示词实测。

ElevenLabs Eleven v4ElevenLabs Eleven v4 TurboSuno V6Gemini 3.8 Flash TTS
厂商ElevenLabsElevenLabsSunoGoogle
起步价$0.072 / 千字符$0.036 / 千字符$0.045 / 次$0.041 / 千字符
输入文本文本文本文本
供应商3 家供应商3 家供应商4 家供应商5 家供应商
Stability0 – 10 – 1——
Voice similarity0 – 10 – 1——
Seed0 – 42949672950 – 4294967295——

ElevenLabs Eleven v4 API 常见问题

stability 和 similarity_boost 有什么作用？

stability 越低，表达越丰富多变；越高越平稳一致。similarity_boost 控制输出与所选音色的贴合程度。默认值分别是 0.5 和 0.75。

可以在文本里控制情绪吗？

可以。在文本中加入 [warmly]、[whispering]、[laughing]、[excited] 等标签，会影响其后文字的表达方式，但效果不能百分之百保证。

Eleven v4 和 v4 Turbo 有什么区别？

v4 追求最佳表现力和一致性，适合旁白和角色配音；v4 Turbo 延迟更低、价格约为一半，质量略有取舍，适合原型验证和短内容。

支持哪些输出格式和语言？

output_format 可选 MP3、PCM、Opus、μ-law、A-law，默认 mp3_44100_128。模型支持多语言，可用 language_code（ISO 639-1）指定语言。

在 01router 上怎么计费？

按输入文本每 1000 字符计费，空格、标点和标签都计入。具体价格见价格表，请求失败会退还积分。

相关模型

同一个 API Key 即可调用的其他模型。

音频 · ElevenLabs

ElevenLabs Eleven v4 Turbo

ElevenLabs Eleven v4 Turbo: expressive multilingual speech with audio tags, voice selection and delivery controls.

低至 $0.036 / 千字符查看 API
音频 · Suno

Suno V6

Suno V6 music generation: full songs with vocals or instrumentals from a description, or your own lyrics and style in custom mode. Each request returns two tracks.

低至 $0.045 / 次查看 API
音频 · Google

Gemini 3.8 Flash TTS

Google Gemini 3.8 Flash TTS: expressive speech in 30 voices with natural-language style control and inline vocal events like <laugh>.

低至 $0.041 / 千字符查看 API