Qwen TTS语音合成API-通义千问qwen3-tts-flash文生语音-AutoRouter

通过文本、音色与语言参数合成语音。同步接口，提交后返回音频 URL。

基于文本与系统音色生成语音。支持自动检测或显式指定语种，同步返回可下载的音频 URL。

同步接口：提交后直接返回合成结果，无需轮询任务状态。音频链接有效期 24 小时。

Base URL

https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) 使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

Endpoints

POST `/v1/audio/speech`

创建语音合成请求

传入文本、音色和可选语言参数，返回合成音频的 URL。该路径与 Bilibili IndexTTS 共用，需通过 model 区分：Qwen 使用 qwen3-tts-flash。

Request Body

Content-Type: application/json

Example:

{
  "model": "qwen3-tts-flash",
  "input": "那我来给大家推荐一款T恤，这款呢真的是超级好看，这个颜色呢很显气质。",
  "voice": "Cherry"
}

Properties:

Name	Type	Required	Description
`model`	string	Yes	模型名称。固定为 `qwen3-tts-flash`
`input`	string	Yes	待合成文本，长度不超过 600 个字符
`voice`	string	Yes	系统音色名称。示例：`Cherry`、`Ethan`、`Serena`、`Chelsie`
`metadata`	object	No	语言等元数据
`metadata.language_type`	string	No	合成语种。默认 `Auto`。可选值：`Auto`、`Chinese`、`English`、`German`、`Italian`、`Portuguese`、`Spanish`、`Japanese`、`Korean`、`French`、`Russian`

metadataobject（可选）

语言等元数据。未传时按自动检测处理。

language_typestring（可选）

合成语种，大小写不敏感。默认 Auto（自动检测）。

Auto
Chinese
English
German
Italian
Portuguese
Spanish
Japanese
Korean
French
Russian

Responses

200: 合成成功，返回音频 URL

Content-Type: application/json

400: 请求参数错误

Content-Type: application/json

请求示例

curl -X POST "https://api.autorouter.top/v1/audio/speech" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
  "model": "qwen3-tts-flash",
  "input": "那我来给大家推荐一款T恤，这款呢真的是超级好看，这个颜色呢很显气质。",
  "voice": "Cherry"
}'

响应示例

{
  "request_id": "5c63c65c-cad8-4bf4-959d-xxxxxxxxxxxx",
  "code": "",
  "message": "",
  "output": {
    "finish_reason": "stop",
    "audio": {
      "data": "",
      "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xx/xxxxxxxx.wav?Expires=1766113409&OSSAccessKeyId=LTAI5xxxxxx&Signature=xxxxxx",
      "id": "audio_5c63c65c-cad8-4bf4-959d-xxxxxxxxxxxx",
      "expires_at": 1766113409
    }
  },
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "characters": 195
  }
}

响应字段说明：

Name	Type	Description
`request_id`	string	本次请求的唯一标识，用于追踪与排查问题
`code`	string	业务错误码。成功时为空字符串
`message`	string	业务错误信息。成功时为空字符串
`output`	object	合成输出
`output.finish_reason`	string \| null	结束原因。生成中为 `null`，完成时为 `stop`
`output.audio`	object	音频信息
`output.audio.url`	string	合成音频完整 URL，有效期 24 小时
`output.audio.data`	string	流式场景的 Base64 音频。同步模式下固定为空字符串
`output.audio.id`	string	音频标识
`output.audio.expires_at`	integer	音频 URL 过期时间戳
`usage`	object	用量统计
`usage.characters`	integer	输入字符数，用于计费
`usage.input_tokens`	integer	固定为 `0`
`usage.output_tokens`	integer	固定为 `0`

错误处理

HTTP 400 参数错误

场景	响应
未传 `input` / `voice` / `model`	`{"error":{"message":"...","type":"invalid_request_error","code":"...","param":"..."}}`
`input` 超过 600 字符	`{"error":{"message":"...","type":"invalid_request_error","code":"...","param":"input"}}`

HTTP 401 / 403 鉴权错误

401 Unauthorized：API Key 无效或已过期
403 Forbidden：API Key 无权访问此模型（检查 token 的模型白名单）

HTTP 402 余额不足

返回 insufficient user quota。请前往 AutoRouter 控制台充值。

语音合成

metadataobject（可选）

属性

目录