本文档由云音工坊自动生成，如有疑问，请联系客服微信：yuntts ！

语音合成（Qwen3-TTS）

POST

/api/v1/qwen3-synthesize

Qwen3-TTS 非实时语音合成，走上游 multimodal-generation 端点。

指令字段为 instructions（复数），且位于 input 内（本插件已在扣费前构建好请求体）。

instructions / optimize_instructions 仅 qwen3-tts-instruct-flash 系列支持。

文本长度限制：qwen3-tts 系列最多 600 字符（超出直接 400，请勿按上游 512 Token 口径理解）。

stream=true 时返回 SSE；非流式返回 data.audio.url（有效期 24 小时）。

请求参数

Header 参数

Body 参数application/json必填

示例

qwen3-tts-flashqwen3-tts-instruct-flash

{
    "model": "qwen3-tts-flash",
    "voice": "Cherry",
    "text": "你好，这是 Qwen3 语音合成测试。",
    "language_type": "Chinese",
    "stream": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

qwen3-tts-flashqwen3-tts-instruct-flash

curl --location '/api/v1/qwen3-synthesize' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "qwen3-tts-flash",
    "voice": "Cherry",
    "text": "你好，这是 Qwen3 语音合成测试。",
    "language_type": "Chinese",
    "stream": false
}'

返回响应

🟢200

application/json

非流式返回 JSON；流式返回 text/event-stream

Bodyapplication/json

示例

{
    "code": 200,
    "message": "语音合成成功",
    "data": {
        "finish_reason": "stop",
        "audio": {
            "data": "",
            "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.wav?Expires=1766113409&...",
            "id": "audio_5c63c65c-cad8-4bf4-959d-xxxxxxxxxxxx",
            "expires_at": 1766113409
        }
    },
    "char_count": 15,
    "cost": 0
}

修改于 2026-10-14 06:24:56

删除音色（CosyVoice）

创建音色 · 声音复刻（Qwen3-TTS）