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

语音合成（CosyVoice）

POST

/api/v1/cosyvoice-synthesize

非实时语音合成，支持非流式与流式（stream=true 时返回 SSE）。

适用模型：CosyVoice 全系（后端与 Qwen-Audio-TTS 共用同一处理器；Qwen-Audio-TTS 模型见「Qwen-Audio-TTS」分组）。

指令参数：instruction（单数）。cosyvoice-v3-plus 不支持任意指令（本插件白名单未含该模型）。

流式说明：中间分片 output.audio.data 为 Base64 音频片段，最后一片 output.audio.url 为完整音频地址（有效期 24 小时）。

计费字符口径：汉字按 2 计，其余按 1 计；启用 SSML 时标签本身不计费。

enable_markdown_filter 仅 cosyvoice-v3-flash 复刻音色可用；hot_fix 在 cosyvoice-v2 不支持。

请求参数

Header 参数

Body 参数application/json必填

示例

CosyVoice 合成Qwen-Audio-TTS 合成（含情感标签与指令）

{
    "model": "cosyvoice-v3-flash",
    "voice": "longanyang",
    "text": "你好，这是语音合成测试。",
    "format": "mp3",
    "sample_rate": 22050,
    "volume": 50,
    "rate": 1,
    "pitch": 1,
    "seed": 0,
    "stream": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

CosyVoice 合成Qwen-Audio-TTS 合成（含情感标签与指令）

curl --location '/api/v1/cosyvoice-synthesize' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "cosyvoice-v3-flash",
    "voice": "longanyang",
    "text": "你好，这是语音合成测试。",
    "format": "mp3",
    "sample_rate": 22050,
    "volume": 50,
    "rate": 1,
    "pitch": 1,
    "seed": 0,
    "stream": false
}'

返回响应

🟢200

application/json

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

Body

示例

{
    "code": 200,
    "message": "语音合成成功",
    "data": {
        "finish_reason": "stop",
        "audio": {
            "data": "",
            "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/prod/cosyvoice-v3-flash/20260418/xxx/xxx.mp3?Expires=1776607233&...",
            "id": "audio_e112de2d-4dfd-90ea-bfe1-08150ee66b65",
            "expires_at": 1776607233
        }
    },
    "char_count": 22,
    "cost": 0
}

修改于 2026-10-15 09:53:13

获取音色

创建音色（CosyVoice：复刻 / 设计）