如何使用 Eleven Flash v2.5 API：文字转语音接入指南（2026）
Eleven Flash v2.5 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。
Eleven Flash v2.5 是一款文字转语音模型（由 ElevenLabs 提供）：Our ultra low latency model in 32 languages. Ideal for conversational use cases.在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.010。
TL;DR
· 任务类型：文字转语音，由 ElevenLabs 提供
· 价格：典型一次约 $0.010（$1 = 100 积分），按量计费无订阅
· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入
· 可调参数：4 个（见下方参数表）
· 无平台水印，商用可用（遵守服务条款）
用 Eleven Flash v2.5 能做什么？
视频配音与旁白：为短视频、课程、广告快速生成多语言人声。
有声内容生产：把文章、新闻、小说批量转成可发布的音频。
产品语音界面：为应用和智能硬件生成一致的品牌语音。
怎么调用这个 API？
1. 在 NamiFusion 注册并在 API Keys 页面创建密钥（注册送免费积分）。
2. 用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
3. 用返回的 task_uuid 轮询任务状态，完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/eleven_flash_v2_5" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"voice_id": "JBFqnCBsd6RMkjVDRZzb",
"language_code": "en",
"similarity_boost": 0.8,
"stability": 0.55
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"有哪些参数？
voice_id（声音id）：必填
language_code（ISO 639-1语言code）：可选
similarity_boost（相似度）：可选，默认 0.75
stability（稳定性）：可选，默认 0.5
价格是多少？
按次积分计价，典型一次调用约 $0.010（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。
Eleven Flash v2.5
高性价比、无冷启动的高质量文本转语音模型。
Flash V2.5 是 ElevenLabs 在 WaveSpeed AI 平台提供的文本转语音模型，面向需要快速、稳定、自然语音输出的开发者与内容生产场景。该模型兼顾生成速度、语音自然度与成本效率，支持多语种语音库、自定义 voice_id，以及对语气稳定性和音色相似度的精细控制。
🚀 关键特性
- 无冷启动体验：适合高频调用与在线业务场景，减少等待时间，提升可用性。
- 自然流畅的语音表现：具备清晰发音、平滑节奏与更接近真人的语调，适用于旁白、解说与数字内容生成。
- 多语种语音库：内置丰富的多语种声音选择，并支持自定义 voice_id，便于品牌化语音输出。
- 可控的音色与稳定性：通过
similarity与stability调整音色贴合度和表达一致性，在表现力与稳定性之间取得平衡。 - 英文数字与单位朗读优化：启用 Speaker Boost 后，可提升英文数字、时间、日期和计量单位的可读性。
- 适合批量内容生产：按字符计费，价格透明，适合播客、教育内容、客服语音与营销素材生成。
🛠️ 技术规格
| 项目 | 说明 |
|---|---|
| 模型名称 | Flash V2.5 |
| 模型 ID | elevenlabs/flash-v2.5 |
| 模型类型 | 文本转语音（TTS） |
| 输入 | 文本 |
| 输出 | 音频 |
| 输出格式 | MP3 |
| 最大输入长度 | 10000 字符 |
| 计费单位 | 按实际字符数计费，价格按每 1000 字符展示 |
| voice_id | 默认 Alice，支持内置与自定义 voice_id |
| similarity | 0.0–1.0，默认 1.0，用于控制目标音色相似度与清晰度 |
| stability | 0.0–1.0，默认 0.5，用于控制语音表达稳定性 |
| use_speaker_boost | 布尔值，默认开启；优化英文数字、时间、单位等文本归一化表现 |
| 停顿控制 | 可在词语之间使用 <#x#> 控制停顿时长（0.01–99.99 秒） |
| 延迟 | 平台侧强调快速生成与无冷启动；实际耗时取决于文本长度与任务负载 |
| 适用语言 | 支持多语种语音场景，英文数字与日期朗读表现尤为突出 |
示例提示词
注：该模型为文本转语音模型，以下示例为输入文本示例，而非图片类提示词。
Welcome to our product demo. Today we'll walk through the key features, pricing, and setup in under two minutes.Your appointment is scheduled for 3:45 PM on September 18th. Please arrive 10 minutes early.The package weighs 2.5 kilograms and will arrive in 3 to 5 business days.<#0.5#>Thank you for your order.
💰 价格
| 计费项 | 价格 |
|---|---|
| 每 1000 字符生成语音 | $0.05 |
FAQ
可以先免费试用吗？+
注册即送积分，但赠送积分目前仅适用于应用内的部分换脸功能；本模型按量积分计费。Playground 仍可无代码试玩，提交前会显示准确报价。
生成内容可以商用吗？有水印吗？+
可以商用，NamiFusion 不给生成结果加平台水印；使用须遵守服务条款与适用法律。
内容政策是什么？+
NamiFusion 是无过滤引擎，不做武断限制、对 NSFW 友好，但禁止违法内容与非自愿的真人素材，详见服务条款。
Eleven Flash v2.5 的任务要跑多久？+
取决于参数，图像通常数秒到数十秒，视频通常数十秒到几分钟；API 返回 task_uuid 供轮询。
分辨率/时长上限是多少？+
以模型参数表为准：每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。