Qwen3 TTS VD 语音合成

授权

Authorization

string

header

必填

##所有接口均需要使用Bearer Token进行认证##

获取 API Key：

访问 API Key 管理页面获取您的 API Key

使用时在请求头中添加：

Authorization: Bearer YOUR_API_KEY

请求体

application/json

model

enum<string>

默认值:qwen3-tts-vd

必填

模型名称

可用选项:

qwen3-tts-vd

示例:

"qwen3-tts-vd"

prompt

string

必填

待合成的文本

约束：

最大 600 字符

Maximum string length: 600

示例:

"各位听众朋友，大家好，欢迎收听晚间新闻。"

voice

string

必填

音色名称

必须先通过 Qwen Voice Design 创建音色
从 Voice Design 任务结果的 result_data.voice 获取
不支持系统内置音色

示例:

"qwen-tts-vd-announcer-voice-20260402-a1b2"

language_type

enum<string>

语种提示，帮助模型选择发音规则

不传时自动检测

可用选项:

Auto,

Chinese,

English,

Japanese,

Korean,

French,

German,

Spanish,

Italian,

Russian,

Portuguese

示例:

"Auto"

callback_url

string<uri>

任务完成后的HTTPS回调地址

回调时机：

任务完成（completed）、失败（failed）或取消（cancelled）时触发
在计费确认完成后发送

安全限制：

仅支持HTTPS协议
禁止回调到内网IP地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x等）
URL长度不超过2048字符

回调机制：

超时时间：10秒
失败后最多重试3次（会分别在失败的1秒/2秒/4秒后进行重试）
回调响应体格式与任务查询接口返回的格式一致
回调地址若返回2xx状态码视为成功，其他状态码会触发重试

示例:

"https://your-domain.com/webhooks/tts-completed"

响应

语音合成任务创建成功

created

integer

任务创建时间戳

示例:

1775122733

string

任务ID

示例:

"task-unified-1775122733-lozyt2i5"

model

string

实际使用的模型名称

示例:

"qwen3-tts-vd"

object

enum<string>

任务的具体类型

可用选项:

audio.generation.task

progress

integer

任务进度百分比 (0-100)

必填范围: 0 <= x <= 100

示例:

0

status

enum<string>

任务状态

可用选项:

pending,

processing,

completed,

failed

示例:

"pending"

task_info

object

音频任务详细信息

Show child attributes

type

enum<string>

任务的输出类型

可用选项:

audio

示例:

"audio"

usage

object

使用量和计费信息

Show child attributes