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

创建音色（Qwen-Audio-TTS：复刻 / 设计）

POST

/api/v1/qwen-audio-create-voice

同一个接口同时承载声音复刻与声音设计：

同时传 voice_prompt + preview_text → 走声音设计；

否则（传 url 或上传 file）→ 走声音复刻。

target_model 仅接受 Qwen-Audio-TTS 三个模型。

音频来源二选一：url（公网可访问）或 multipart/form-data 上传字段 file（wav/mp3/m4a，≤10MB）。

上游契约：model=voice-enrollment、input.action=create_voice；响应音色字段为 voice_id。

请求参数

Header 参数

Body 参数

application/json

必填

示例

声音复刻（音频 URL）声音设计（voice_prompt + preview_text）

{
    "voice_name": "我的音色",
    "target_model": "qwen-audio-3.0-tts-flash",
    "url": "https://your-audio-url.wav",
    "language_hints": [
        "zh"
    ],
    "enable_preprocess": true,
    "max_prompt_audio_length": 10,
    "prefix": "yuntts"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

声音复刻（音频 URL）声音设计（voice_prompt + preview_text）

curl --location '/api/v1/qwen-audio-create-voice' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "voice_name": "我的音色",
    "target_model": "qwen-audio-3.0-tts-flash",
    "url": "https://your-audio-url.wav",
    "language_hints": [
        "zh"
    ],
    "enable_preprocess": true,
    "max_prompt_audio_length": 10,
    "prefix": "yuntts"
}'

返回响应

🟢200

application/json

创建成功

Bodyapplication/json

示例

{
    "code": 200,
    "message": "音色创建成功",
    "data": {
        "voice_id": "qwen-audio-3.0-tts-flash-yuntts-xxxxxxxx"
    },
    "database_saved": true
}

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

语音合成（Qwen-Audio-TTS）

更新音色（Qwen-Audio-TTS 复刻音色）