> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# ElevenLabs TTS Turbo v2.5
> 使用 ElevenLabs Turbo v2.5 生成语音旁白，可调节语速、演绎风格和音色相似度，并可选返回文本对齐数据。
> [!TIP]
>
> 1. 提交后会返回 `task_id`。如果提供了 `callback_url`，当任务状态变为 `finished` 或 `failed` 时，系统会向 `callback_url` 发送 POST 请求。
> 2. 无论是否提供 `callback_url`，都可以通过统一的[查询任务状态](https://docs.vidgo.ai/zh/api-manual/task-management/status.md)接口获取结果。
使用 ElevenLabs Turbo v2.5 生成语音旁白，可调节语速、演绎风格和音色相似度，并可选返回文本对齐数据。
## 模型
* **elevenlabs/tts/turbo-v2.5** - 将文本转换为语音。
## 功能
* 将文本转换为语音。
* 可在生成音频的同时请求时间戳。
* 使用 `voice` 选择音色，使用 `language_code` 指定朗读语言。
## 高级参数
在请求根级设置 `model` 和可选的 `callback_url`。所有工作流程参数（包括输出选项）都放在 `input` 中。
以下参数定义该模型的 `input` 对象。
### 音色
* `voice`：可选。选择音色名称或兼容的音色 ID。字符串。默认：`Rachel`。
### 稳定性
* `stability`：可选。控制音色稳定性。数值 `0` 到 `1`。默认：`0.5`。
### 相似度增强
* `similarity_boost`：可选。控制音色相似度。数值 `0` 到 `1`。默认：`0.75`。
### 风格
* `style`：可选。设置音色风格强度。数值 `0` 到 `1`。默认：`0`。
### 语速
* `speed`：可选。设置语速。数值 `0.7` 到 `1.2`。默认：`1`。
### 时间戳
* `timestamps`：可选。在返回音频的同时请求时间戳信息。使用 `true` 或 `false`。默认：`false`。
### 前文
* `previous_text`：可选。提供前文作为语音上下文。字符串，也可为 `null`。
### 后文
* `next_text`：可选。提供后文作为语音上下文。字符串，也可为 `null`。
### 语言代码
* `language_code`：可选。使用 ISO 639-1 代码设置朗读语言，例如 `en`、`fr`、`de`、`ja`、`vi`、`hu` 或 `no`。也可为 `null`。
### 文本规范化
* `apply_text_normalization`：可选。控制朗读前如何处理数字、日期和货币：`auto` 自动选择是否规范化，`on` 启用规范化，`off` 直接朗读所给文本。默认：`auto`。
### 文本
* `text`：必填。要朗读的文本。去除首尾空白后长度为 **1-40,000 个 Unicode 字符**，且至少包含一个可见字符。
## 输出文件
* 读取返回的 `files` 数组中的每一项。
* 生成的音频 `file_type` 为 `"audio"`。
* 时间戳和对齐文件可能使用 `file_type: "other"`。如有可选的文件元数据，请一并保留。
## 示例
每个示例都包含请求、对应的已完成任务响应和生成的音频。将请求提交到 `POST https://api.vidgo.ai/api/generate/submit`，然后使用提交返回的任务 ID 查询 `GET https://api.vidgo.ai/api/generate/status/{task_id}`。
> [accordion] 一次折一折
>
> ```json Request theme={null}
> {
> "model": "elevenlabs/tts/turbo-v2.5",
> "input": {
> "similarity_boost": 0.75,
> "style": 0,
> "apply_text_normalization": "auto",
> "text": "Almost there. Fold the top corner down until it meets the center crease. Now press along the edge with your fingertip. That's it. Turn the paper over, and we'll make the next fold together.",
> "voice": "Rachel",
> "language_code": "en",
> "speed": 1.05,
> "stability": 0.5,
> "timestamps": false
> }
> }
> ```
>
> ```json Completed task response theme={null}
> {
> "code": 200,
> "data": {
> "task_id": "QKTPQMIP4AZY1LGE",
> "status": "finished",
> "files": [
> {
> "file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/01/output.mp3",
> "file_type": "audio"
> }
> ],
> "created_time": "2026-09-27T10:51:18",
> "error_message": null,
> "progress": 100
> }
> }
> ```
>
>
>
> [下载音频](https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/01/output.mp3)
> [accordion] 在夜空中寻找北方
>
> ```json Request theme={null}
> {
> "model": "elevenlabs/tts/turbo-v2.5",
> "input": {
> "similarity_boost": 0.75,
> "style": 0,
> "apply_text_normalization": "auto",
> "text": "今晚，我们先找到北斗七星，再从勺口两颗星的方向寻找北极星。它看起来并不耀眼，却能帮我们辨认北方。在黑暗中安静地等待片刻，你会发现，夜空远比第一眼看到的更丰富。",
> "voice": "Aria",
> "language_code": "zh",
> "speed": 0.95,
> "stability": 0.6,
> "timestamps": true
> }
> }
> ```
>
> ```json Completed task response theme={null}
> {
> "code": 200,
> "data": {
> "task_id": "2OAYYBTX2HQT9R8P",
> "status": "finished",
> "files": [
> {
> "file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/02/output.mp3",
> "file_type": "audio"
> },
> {
> "file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/02/attachment-1.json",
> "file_type": "other"
> }
> ],
> "created_time": "2026-09-27T10:54:18",
> "error_message": null,
> "progress": 100
> }
> }
> ```
>
>
>
> [下载音频](https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/02/output.mp3)
>
> [下载 attachment-1.json](https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/02/attachment-1.json)
> [accordion] 两杯茶
>
> ```json Request theme={null}
> {
> "model": "elevenlabs/tts/turbo-v2.5",
> "input": {
> "similarity_boost": 0.75,
> "style": 0,
> "apply_text_normalization": "auto",
> "text": "Hoy volví a la casa de mi abuela. En la cocina seguía el reloj de siempre, cinco minutos adelantado. Preparé dos tazas de té por costumbre y, al darme cuenta, sonreí. Algunos gestos también guardan recuerdos.",
> "voice": "Sarah",
> "language_code": "es",
> "speed": 0.98,
> "stability": 0.45,
> "timestamps": false,
> "previous_text": "Hacía años que no cruzaba aquella puerta.",
> "next_text": "Después abrí las ventanas para dejar entrar la luz."
> }
> }
> ```
>
> ```json Completed task response theme={null}
> {
> "code": 200,
> "data": {
> "task_id": "KAQOQIL83QO5TWA6",
> "status": "finished",
> "files": [
> {
> "file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/03/output.mp3",
> "file_type": "audio"
> }
> ],
> "created_time": "2026-09-27T10:52:07",
> "error_message": null,
> "progress": 100
> }
> }
> ```
>
>
>
> [下载音频](https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/03/output.mp3)
## OpenAPI
````yaml zh/api-manual/music-series/elevenlabs-tts-turbo-v2-5.json POST /api/generate/submit
openapi: 3.0.0
info:
title: Vidgo API - ElevenLabs TTS Turbo v2.5
description: 使用 ElevenLabs Turbo v2.5 生成语音旁白，可调节语速、演绎风格和音色相似度，并可选返回文本对齐数据。
version: 1.0.0
servers:
- url: https://api.vidgo.ai
security:
- BearerAuth: []
paths:
/api/generate/submit:
post:
tags:
- Audio Series
summary: ElevenLabs TTS Turbo v2.5
description: >-
模型参数放在 input 中。text 去除首尾空白后需包含 1 到 40,000 个 Unicode 字符。读取 files
中的每一项：生成的语音 file_type=audio。如有时间戳文件和可选的文件元数据，请一并保留。
operationId: submit_elevenlabs_tts_turbo_v2_5
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- model
- input
additionalProperties: true
properties:
model:
type: string
example: elevenlabs/tts/turbo-v2.5
input:
type: object
required:
- text
additionalProperties: false
properties:
voice:
type: string
default: Rachel
description: 音色名称或兼容的音色 ID，默认 Rachel。
stability:
type: number
minimum: 0
maximum: 1
default: 0.5
description: 音色稳定性，取值 0 到 1，默认 0.5。
similarity_boost:
type: number
minimum: 0
maximum: 1
default: 0.75
description: 音色相似度强度，取值 0 到 1，默认 0.75。
style:
type: number
minimum: 0
maximum: 1
default: 0
description: 风格夸张程度，取值 0 到 1，默认 0。
speed:
type: number
minimum: 0.7
maximum: 1.2
default: 1
description: 语速，取值 0.7 到 1.2。小于 1 放慢语速，大于 1 加快语速。默认 1。
timestamps:
type: boolean
default: false
description: 在生成音频的同时请求时间戳数据，默认 false。
previous_text:
type: string
nullable: true
description: 当前片段之前的文本，用于保持多段旁白之间的连贯性。
next_text:
type: string
nullable: true
description: 当前片段之后的文本，用于保持多段旁白之间的连贯性。
language_code:
type: string
nullable: true
description: 朗读语言的 ISO 639-1 语言代码，例如 en、fr、de、ja、vi、hu 或 no。
apply_text_normalization:
type: string
enum:
- auto
- 'on'
- 'off'
default: auto
description: >-
为朗读处理数字、日期和货币：auto 自动选择是否规范化，on 启用规范化，off 直接朗读所给文本。默认
auto。
text:
type: string
minLength: 1
maxLength: 40000
description: 要转换为语音的文本，去除首尾空白后需包含 1 到 40,000 个 Unicode 字符。
callback_url:
type: string
nullable: true
description: 可选的公开 HTTP(S) 接口，用于接收任务完成通知，建议使用 HTTPS。省略、设为 null 或空字符串即不回调。
description: 在请求根级放置 model 和可选的 callback_url，语音参数放在 input 中。
examples:
basic:
summary: 一次折一折
value:
model: elevenlabs/tts/turbo-v2.5
input:
similarity_boost: 0.75
style: 0
apply_text_normalization: auto
text: >-
Almost there. Fold the top corner down until it meets the
center crease. Now press along the edge with your
fingertip. That's it. Turn the paper over, and we'll make
the next fold together.
voice: Rachel
language_code: en
speed: 1.05
stability: 0.5
timestamps: false
turbo-stargazing-zh:
summary: 在夜空中寻找北方
value:
model: elevenlabs/tts/turbo-v2.5
input:
similarity_boost: 0.75
style: 0
apply_text_normalization: auto
text: >-
今晚，我们先找到北斗七星，再从勺口两颗星的方向寻找北极星。它看起来并不耀眼，却能帮我们辨认北方。在黑暗中安静地等待片刻，你会发现，夜空远比第一眼看到的更丰富。
voice: Aria
language_code: zh
speed: 0.95
stability: 0.6
timestamps: true
turbo-memory-es:
summary: 两杯茶
value:
model: elevenlabs/tts/turbo-v2.5
input:
similarity_boost: 0.75
style: 0
apply_text_normalization: auto
text: >-
Hoy volví a la casa de mi abuela. En la cocina seguía el
reloj de siempre, cinco minutos adelantado. Preparé dos
tazas de té por costumbre y, al darme cuenta, sonreí.
Algunos gestos también guardan recuerdos.
voice: Sarah
language_code: es
speed: 0.98
stability: 0.45
timestamps: false
previous_text: Hacía años que no cruzaba aquella puerta.
next_text: Después abrí las ventanas para dejar entrar la luz.
callback:
summary: 接收完成回调
value:
model: elevenlabs/tts/turbo-v2.5
input:
similarity_boost: 0.75
style: 0
apply_text_normalization: auto
text: >-
Almost there. Fold the top corner down until it meets the
center crease. Now press along the edge with your
fingertip. That's it. Turn the paper over, and we'll make
the next fold together.
voice: Rachel
language_code: en
speed: 1.05
stability: 0.5
timestamps: false
callback_url: https://your-domain.com/callback
responses:
'200':
description: 任务已提交
content:
application/json:
schema:
type: object
required:
- code
- data
properties:
code:
type: integer
enum:
- 200
data:
type: object
required:
- task_id
- status
- created_time
properties:
task_id:
type: string
status:
type: string
enum:
- not_started
- running
- finished
- failed
created_time:
type: string
format: date-time
example:
code: 200
data:
task_id: QKTPQMIP4AZY1LGE
status: running
created_time: '2026-09-27T10:51:18'
'400':
description: 请求校验错误。请检查 input 参数类型、文本长度和数值范围。
content:
application/json:
schema:
type: object
required:
- detail
properties:
detail:
oneOf:
- type: string
- type: object
additionalProperties: true
- type: array
items: {}
'401':
description: 凭证无效
content:
application/json:
schema:
type: object
required:
- detail
properties:
detail:
oneOf:
- type: string
- type: object
additionalProperties: true
- type: array
items: {}
'403':
description: 拒绝访问
content:
application/json:
schema:
type: object
required:
- detail
properties:
detail:
oneOf:
- type: string
- type: object
additionalProperties: true
- type: array
items: {}
'404':
description: 模型不存在或已停用
content:
application/json:
schema:
type: object
required:
- detail
properties:
detail:
oneOf:
- type: string
- type: object
additionalProperties: true
- type: array
items: {}
'408':
description: 请求超时
content:
text/plain:
schema:
type: string
example: Request timeout
'422':
description: JSON 无效或请求体不是对象
content:
application/json:
schema:
type: object
required:
- detail
properties:
detail:
oneOf:
- type: string
- type: object
additionalProperties: true
- type: array
items: {}
'429':
description: 超出速率限制或 API Key 积分限额
content:
application/json:
schema:
type: object
required:
- detail
properties:
detail:
oneOf:
- type: string
- type: object
additionalProperties: true
- type: array
items: {}
'500':
description: 内部错误
content:
application/json:
schema:
type: object
required:
- detail
properties:
detail:
oneOf:
- type: string
- type: object
additionalProperties: true
- type: array
items: {}
'502':
description: 任务创建错误。请确认服务状态后重试请求。
content:
application/json:
schema:
type: object
required:
- detail
properties:
detail:
oneOf:
- type: string
- type: object
additionalProperties: true
- type: array
items: {}
'503':
description: 请求的模型暂时不可用
content:
application/json:
schema:
type: object
required:
- detail
properties:
detail:
oneOf:
- type: string
- type: object
additionalProperties: true
- type: array
items: {}
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: 使用 VIDGO_API_KEY。
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.