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

创建音色 · 声音设计（Qwen3-TTS）

POST

/api/v1/qwen3-create-design-voice

Qwen3-TTS 声音设计。

上游契约：model=qwen-voice-design、input.action=create、参数 voice，预览参数在顶层 parameters。

声音描述 voice_prompt 仅支持中文和英文，≤2048 字符；preview_text ≤1024 字符。

响应音色字段为 voice。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "voice_name": "沉稳播音",
    "target_model": "qwen3-tts-vd-2026-01-26",
    "voice_prompt": "沉稳的中年男性，音色低沉浑厚",
    "preview_text": "各位听众朋友，大家好",
    "preferred_name": "yuntts",
    "language": "zh",
    "sample_rate": 24000,
    "response_format": "wav"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/qwen3-create-design-voice' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "voice_name": "沉稳播音",
    "target_model": "qwen3-tts-vd-2026-01-26",
    "voice_prompt": "沉稳的中年男性，音色低沉浑厚",
    "preview_text": "各位听众朋友，大家好",
    "preferred_name": "yuntts",
    "language": "zh",
    "sample_rate": 24000,
    "response_format": "wav"
}'

返回响应

🟢200

application/json

创建成功

Bodyapplication/json

示例

{
    "code": 200,
    "message": "设计声音创建成功",
    "data": {
        "voice": "yourVoice",
        "preview_audio": {
            "data": "{base64_encoded_audio}",
            "sample_rate": 24000,
            "response_format": "wav"
        },
        "target_model": "qwen3-tts-vd-2026-01-26"
    },
    "database_saved": true
}

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

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

删除音色（Qwen3-TTS）