> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poyo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs TTS Turbo v2.5

> ElevenLabs TTS Turbo v2.5 API 可将最多 40,000 个字符的文本转换为语音，支持选择音色、0.7 到 1.2 的语速，以及可选的 ISO 639-1 语言代码。可传入前文和后文，使多个请求之间的旁白保持连贯。

> [!TIP]
>
> 1. 提交后会返回 `task_id`。如果提供了 `callback_url`，当任务状态变为 `finished` 或 `failed` 时，系统会向 `callback_url` 发送 POST 请求。
> 2. 无论是否提供 `callback_url`，都可以通过统一的[查询任务状态](https://docs.poyo.ai/zh/api-manual/task-management/status.md)接口获取结果。

`elevenlabs-tts-turbo-2-5` 将文本输入转换为低延迟的多语言语音音频。结果以任务 `files` 返回，与图像、视频、3D 和音频任务的标准响应结构一致。

## 模型

* **elevenlabs-tts-turbo-2-5** - ElevenLabs TTS Turbo v2.5 文本转语音生成

## 必填参数

* **text**：要转换为语音的文本
  * 长度：`1-40000` 个字符
  * 将长篇旁白拆分为多个请求时，使用 `previous_text` 和 `next_text`

## 可选参数

* **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` 时，生成的音频可能附带时间戳数据
* **previous\_text**：可选，位于 `text` 之前的上下文，有助于保持长篇内容连贯
* **next\_text**：可选，位于 `text` 之后的上下文，有助于保持长篇内容连贯
* **language\_code**：可选的 ISO 639-1 代码，用于强制指定目标语言，例如 `en`、`fr`、`de`、`ja`、`vi`、`hu` 或 `no`
* **apply\_text\_normalization**：`auto`、`on` 或 `off`。默认：`auto`

## 示例

### 低延迟产品配音

```json theme={"dark"}
{
  "model": "elevenlabs-tts-turbo-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "text": "Welcome to NovaDesk. Your workspace is ready, your calendar is synced, and your first customer briefing starts in ten minutes.",
    "voice": "Rachel",
    "speed": 1.08,
    "stability": 0.55,
    "similarity_boost": 0.78,
    "style": 0.12,
    "timestamps": false,
    "apply_text_normalization": "auto"
  }
}
```

### 本地化取货通知

```json theme={"dark"}
{
  "model": "elevenlabs-tts-turbo-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "text": "Bonjour, votre commande est prete. Merci de presenter votre code de retrait a l'accueil.",
    "voice": "Aria",
    "language_code": "fr",
    "stability": 0.6,
    "similarity_boost": 0.75,
    "speed": 1,
    "timestamps": true,
    "apply_text_normalization": "auto"
  }
}
```

### 长篇内容连贯

```json theme={"dark"}
{
  "model": "elevenlabs-tts-turbo-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "previous_text": "The city lights faded behind the train.",
    "text": "Mira lowered her voice and said, keep the map close. By sunrise, everyone will be looking for it.",
    "next_text": "The carriage fell silent as the tunnel opened ahead.",
    "voice": "Sarah",
    "stability": 0.42,
    "similarity_boost": 0.82,
    "style": 0.35,
    "speed": 0.94,
    "apply_text_normalization": "auto"
  }
}
```

### 富有表现力的主持人开场

```json theme={"dark"}
{
  "model": "elevenlabs-tts-turbo-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "text": "Tonight, the gallery opens with a quiet piano note, then the host welcomes every guest with calm confidence.",
    "voice": "Laura",
    "stability": 0.48,
    "similarity_boost": 0.8,
    "style": 0.4,
    "speed": 0.98,
    "apply_text_normalization": "auto"
  }
}
```

## 注意事项

* PoYo 对外公开的参数名是 `text`。
* 通过标准任务状态 API 查询状态。
* 成功响应返回 `files`，其中生成的语音使用 `file_type: audio`。


## OpenAPI

````yaml zh/api-manual/music-series/elevenlabs-tts-turbo-2-5.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: PoYo AI - ElevenLabs TTS Turbo v2.5 API
  description: >-
    ElevenLabs TTS Turbo v2.5 API 将最多 40,000 个字符的文本转换为语音，可选择音色，语速范围 0.7 到
    1.2，并可指定可选的 ISO 639-1 语言代码。可传入前文和后文，使跨请求的旁白保持连贯。
  version: 1.0.0
servers:
  - url: https://api.poyo.ai
    description: 生产环境
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - ElevenLabs TTS Turbo v2.5
      summary: 提交 ElevenLabs TTS Turbo v2.5 任务
      description: 将文本转换为低延迟语音音频。
      operationId: submitElevenLabsTtsTurbo25Task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              product-voiceover:
                summary: 低延迟产品旁白
                value:
                  model: elevenlabs-tts-turbo-2-5
                  callback_url: https://your-domain.com/callback
                  input:
                    voice: Rachel
                    speed: 1.08
                    stability: 0.55
                    similarity_boost: 0.78
                    style: 0.12
                    timestamps: false
                    apply_text_normalization: auto
                    text: >-
                      Welcome to NovaDesk. Your workspace is ready, your
                      calendar is synced, and your first customer briefing
                      starts in ten minutes.
              localized-notification:
                summary: 本地化取件通知
                value:
                  model: elevenlabs-tts-turbo-2-5
                  callback_url: https://your-domain.com/callback
                  input:
                    voice: Aria
                    language_code: fr
                    stability: 0.6
                    similarity_boost: 0.75
                    speed: 1
                    timestamps: true
                    apply_text_normalization: auto
                    text: >-
                      Bonjour, votre commande est prete. Merci de presenter
                      votre code de retrait a l'accueil.
              long-form-continuity:
                summary: 长文本连贯性
                value:
                  model: elevenlabs-tts-turbo-2-5
                  callback_url: https://your-domain.com/callback
                  input:
                    previous_text: The city lights faded behind the train.
                    next_text: The carriage fell silent as the tunnel opened ahead.
                    voice: Sarah
                    stability: 0.42
                    similarity_boost: 0.82
                    style: 0.35
                    speed: 0.94
                    apply_text_normalization: auto
                    text: >-
                      Mira lowered her voice and said, keep the map close. By
                      sunrise, everyone will be looking for it.
              expressive-host-intro:
                summary: 富有表现力的主持人开场
                value:
                  model: elevenlabs-tts-turbo-2-5
                  callback_url: https://your-domain.com/callback
                  input:
                    voice: Laura
                    stability: 0.48
                    similarity_boost: 0.8
                    style: 0.4
                    speed: 0.98
                    apply_text_normalization: auto
                    text: >-
                      Tonight, the gallery opens with a quiet piano note, then
                      the host welcomes every guest with calm confidence.
      responses:
        '200':
          description: 任务提交成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
        '400':
          description: 请求参数无效
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: 未授权
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SubmitRequest:
      type: object
      required:
        - model
        - input
      additionalProperties: false
      properties:
        model:
          type: string
          description: 模型标识符。
          enum:
            - elevenlabs-tts-turbo-2-5
          example: elevenlabs-tts-turbo-2-5
        callback_url:
          type: string
          format: uri
          description: 接收结果通知的 Webhook 回调 URL
          example: https://your-domain.com/callback
        input:
          $ref: '#/components/schemas/ElevenLabsTtsTurbo25Input'
    SubmitResponse:
      type: object
      required:
        - code
        - data
      properties:
        code:
          type: integer
          example: 200
          enum:
            - 200
            - 400
            - 401
            - 402
            - 403
            - 404
            - 408
            - 429
            - 500
            - 502
            - 503
          description: >-
            业务状态码。`200` 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的
            `code` 为 `400`。


            - `200`：成功

            - `400`：请求参数无效

            - `401`：API Key 缺失或无效

            - `402`：积分不足

            - `403`：没有权限

            - `404`：资源不存在

            - `408`：请求超时

            - `429`：请求频率超限

            - `500`：服务器内部错误

            - `502`：上游服务错误

            - `503`：服务暂不可用


            详见[错误码](/zh/api-manual/error-codes)。
        data:
          type: object
          required:
            - task_id
            - status
            - created_time
          properties:
            task_id:
              type: string
              example: task-unified-1757165031-uyujaw3d
            status:
              type: string
              enum:
                - not_started
                - running
                - finished
                - failed
              example: not_started
              description: >-
                任务状态。提交后立即返回时始终为
                `not_started`。后续状态请通过[查询任务状态](/zh/api-manual/task-management/status)接口或
                `callback_url` 获取。


                - `not_started`：排队中，等待处理

                - `running`：生成中

                - `finished`：已完成，结果在 `files` 或 `output` 中

                - `failed`：失败，详情见 `error_message`
            created_time:
              type: string
              format: date-time
              example: '2026-06-25T10:30:00'
    ErrorResponse:
      type: object
      properties:
        code:
          type: integer
          enum:
            - 200
            - 400
            - 401
            - 402
            - 403
            - 404
            - 408
            - 429
            - 500
            - 502
            - 503
          description: >-
            业务状态码。`200` 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的
            `code` 为 `400`。


            - `200`：成功

            - `400`：请求参数无效

            - `401`：API Key 缺失或无效

            - `402`：积分不足

            - `403`：没有权限

            - `404`：资源不存在

            - `408`：请求超时

            - `429`：请求频率超限

            - `500`：服务器内部错误

            - `502`：上游服务错误

            - `503`：服务暂不可用


            详见[错误码](/zh/api-manual/error-codes)。
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
    ElevenLabsTtsTurbo25Input:
      type: object
      required:
        - text
      additionalProperties: false
      properties:
        voice:
          type: string
          description: 用于语音生成的音色名称或兼容的音色 ID。
          default: Rachel
          example: Rachel
        stability:
          type: number
          description: 音色稳定性，取值 0 到 1。
          minimum: 0
          maximum: 1
          default: 0.5
          example: 0.55
        similarity_boost:
          type: number
          description: 音色相似度增强，取值 0 到 1。
          minimum: 0
          maximum: 1
          default: 0.75
          example: 0.78
        style:
          type: number
          description: 风格夸张程度，取值 0 到 1。
          minimum: 0
          maximum: 1
          default: 0
          example: 0.12
        speed:
          type: number
          description: 语速，取值 0.7 到 1.2。小于 1 时语速变慢，大于 1 时语速变快。
          minimum: 0.7
          maximum: 1.2
          default: 1
          example: 1.08
        timestamps:
          type: boolean
          description: 是否在可用时请求词级时间戳。
          default: false
          example: false
        previous_text:
          type: string
          nullable: true
          description: 当前文本之前的文本。将长篇语音拆分为多个请求时，可用于提升连贯性。
          example: The city lights faded behind the train.
        next_text:
          type: string
          nullable: true
          description: 当前文本之后的文本。将长篇语音拆分为多个请求时，可用于提升连贯性。
          example: The carriage fell silent as the tunnel opened ahead.
        language_code:
          type: string
          nullable: true
          description: 可选的 ISO 639-1 语言代码，用于强制模型使用指定语言。
          example: fr
        apply_text_normalization:
          type: string
          description: 控制数字、日期、货币等内容的文本规范化。
          enum:
            - auto
            - 'on'
            - 'off'
          default: auto
          example: auto
        text:
          type: string
          description: 要转换为语音的文本。
          minLength: 1
          maxLength: 40000
          example: >-
            Welcome to NovaDesk. Your workspace is ready, your calendar is
            synced, and your first customer briefing starts in ten minutes.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        所有 API 接口都需要 Bearer Token 认证。


        创建 API Key：登录 PoYo，进入 **仪表盘 → API
        密钥**（[poyo.ai/zh/dashboard/api-key](https://poyo.ai/zh/dashboard/api-key)），点击创建
        Key。


        在请求头中添加：


        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.