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

# Qwen3 TTS 语音合成 API

> Qwen 语音合成模型提供接近真人的自然表达声音，支持多语言及方言，使用单一音色生成多语言内容，并自动适应语气以处理复杂文本。

## 概述

Qwen3-TTS 是阿里云通义团队推出的文字转语音模型，支持将文本转化为自然流畅的语音，覆盖 10 种语言，包括中文、英语、日语、韩语、德语、法语、俄语、葡萄牙语、西班牙语和意大利语。\
提供三种强大模式：音色合成、音色克隆与音色设计。

#### 功能介绍

#### 语音合成：

输入待合成的文本，选择系统内置音色，即可生成语音。支持多语言混合输入。

#### 音色克隆：

仅需 3 秒音频，模型即可复刻该音色并朗读您提供的任意文本。克隆效果跨语言同样有效——克隆一段英语音色，即可用于朗读中文内容。

#### 音色设计：

用自然语言描述您想要的音色，模型将为您创建对应声音。例如"温暖的讲故事风格，语速舒缓"或"带英国口音的低沉男声"，模型将根据您的描述生成相匹配的语音。

#### 语音风格控制：

通过自然语言指令调整语音效果，可控制情感、语速与语气。模型根据文本语义自适应输出，自然停顿并突出重点词汇。

## 查询任务状态

提交任务后，使用统一查询端点查看进度并获取结果：

<Card title="获取任务信息" icon="magnifying-glass" href="/zh/models/common/get-task-info">
  了解如何查询任务状态及获取生成结果
</Card>

<Tip>
  对于生产环境，我们建议在创建任务时使用 `callback_url` 参数，以便在生成完成时自动接收通知，而非持续轮询状态端点。
</Tip>

## 相关资源

<CardGroup cols={2}>
  <Card title="模型概览" icon="store" href="/zh/models/quickstart">
    探索所有可用模型
  </Card>

  <Card title="通用 API" icon="gear" href="/zh/common-api/get-account-credits">
    查看账户剩余积分
  </Card>
</CardGroup>


## OpenAPI

````yaml zh/models/qwen/qwen-tts.json post /api/v1/client/job/CreateTask
openapi: 3.0.0
info:
  title: Crun Qwen TTS API
  description: crun.ai Qwen3 TTS API 文档
  version: 1.0.0
  contact:
    name: 技术支持
    email: support@crun.ai
servers:
  - url: https://api.crun.ai
    description: API 服务器
security:
  - ApiKeyAuth: []
paths:
  /api/v1/client/job/CreateTask:
    post:
      summary: qwen3 tts 语音合成
      operationId: qwen3-tts-speech-synthesis
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - input
              properties:
                model:
                  type: string
                  enum:
                    - qwen3-tts/speech-synthesis
                  description: |-
                    用于生成的模型名称，必填字段。

                    - 使用本端点时必须填写 `qwen3-tts/speech-synthesis`
                callback_url:
                  type: string
                  format: uri
                  description: |-
                    可选。用于接收任务完成通知的回调 URL。

                    - 生成完成后，系统将以 POST 方式向该 URL 推送任务状态与结果
                    - 回调数据结构与任务状态查询接口返回的 `data` 对象一致
                    - 您的回调端点需支持接收包含结果的 JSON 格式 POST 请求
                    - 成功接收后需返回 HTTP 200 状态码
                  example: https://your-domain.com/api/callback
                input:
                  type: object
                  description: Qwen3 TTS 语音合成任务的输入参数
                  required:
                    - text
                    - voice
                  properties:
                    text:
                      type: string
                      description: 待合成的文本内容，支持多语言混合输入。
                      minLength: 1
                      maxLength: 600
                      example: >-
                        The weather is lovely today. Let's take a walk in the
                        park.
                    voice:
                      type: string
                      description: >-
                        所使用的音色。请参考[系统支持的音色列表](https://www.alibabacloud.com/help/zh/model-studio/qwen-tts#bac280ddf5a1u)。
                      minLength: 1
                      maxLength: 600
                      example: Cherry
                    language_type:
                      type: string
                      enum:
                        - Auto
                        - Chinese
                        - English
                        - German
                        - Italian
                        - Portuguese
                        - Spanish
                        - Japanese
                        - Korean
                        - French
                      description: |-
                        合成语言类型。使用 `Auto` 可让系统自动检测语言。
                        - 当文本语言不确定或包含多种语言时使用。模型会自动匹配文本中不同语言段落的发音，但无法保证发音完全准确。
                        - 指定语言：当文本为单一语言时使用。指定确切语言可显著提升合成质量，通常优于 `Auto` 模式。支持以下值：
                      default: Auto
                      example: Chinese
                    instructions:
                      type: string
                      description: 可选。语音风格或表达方式指令，例如语气、情感或说话风格。仅支持中文和英文。
                      maxLength: 1600
                      example: Use a warm, friendly tone and a slightly slower pace.
                    optimize_instructions:
                      type: boolean
                      description: 对 `instructions` 进行优化，以提升语音合成的自然度和表现力。
                      default: false
                      example: true
            example:
              model: qwen3-tts/speech-synthesis
              callback_url: https://your-domain.com/api/callback
              input:
                text: >-
                  Welcome to Qwen3 TTS. We can synthesize natural speech in
                  multiple languages.
                voice: Serena
                language_type: English
                instructions: Speak clearly with a friendly, confident tone.
                optimize_instructions: true
      responses:
        '200':
          description: 请求成功
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          task_id:
                            type: string
                            description: 任务 ID，可通过获取任务详情接口查询任务状态
                            example: task_12345678
              example:
                code: 200
                message: success
                data:
                  task_id: task_12345678
        '422':
          description: 验证错误
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      errors:
                        type: array
                        description: 详细的验证错误信息
                        items:
                          type: string
                        example:
                          - specific error field message
              example:
                code: 422
                message: Missing Params or Type Error
                errors:
                  - specific error field message
        '500':
          $ref: '#/components/responses/Error'
components:
  schemas:
    ApiResponse:
      type: object
      properties:
        code:
          type: integer
          enum:
            - 200
            - 401
            - 402
            - 404
            - 422
            - 429
            - 455
            - 500
            - 501
            - 505
          description: |-
            响应状态码

            - **200**: 成功 - 请求已成功处理
            - **401**: 未授权 - 身份凭证缺失或无效
            - **402**: 额度不足 - 账户余额不足以完成本次操作
            - **404**: 未找到 - 请求的资源或端点不存在
            - **422**: 验证错误 - 请求参数未通过验证
            - **429**: 请求限速 - 该资源的请求次数已超出限制
            - **455**: 服务不可用 - 系统正在维护中
            - **500**: 服务器错误 - 处理请求时发生意外错误
            - **501**: 生成失败 - 内容生成任务失败
            - **505**: 功能已禁用 - 所请求的功能当前已被禁用
        message:
          type: string
          description: 响应消息，失败时为错误描述
          example: success
  responses:
    Error:
      description: 服务器错误
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: |-
        所有 API 均需通过 API Key 进行身份验证。

        获取 API Key：
        1. 访问 [API Key 管理页面](https://crun.ai/zh/user-api-key) 获取您的 API Key

        使用方式：
        将以下内容添加至请求头：

        x-api-key: YOUR_API_KEY

        注意事项：
        - 请妥善保管您的 API Key，切勿与他人共享
        - 若怀疑 API Key 已泄露，请立即在管理页面进行重置

````