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

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

POST

/api/v1/cosyvoice-create-voice

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

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

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

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

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

请求参数

Header 参数

Body 参数

application/json

必填

示例

{
    "voice_name": "string",
    "target_model": "cosyvoice-v3.5-plus",
    "description": "string",
    "prefix": "string",
    "url": "string",
    "voice_prompt": "string",
    "preview_text": "string",
    "language_hints": [
        "zh"
    ],
    "enable_preprocess": false,
    "max_prompt_audio_length": 3,
    "enable_volume_normalization": false,
    "sample_rate": 24000,
    "response_format": "wav"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/cosyvoice-create-voice' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "voice_name": "string",
    "target_model": "cosyvoice-v3.5-plus",
    "description": "string",
    "prefix": "string",
    "url": "string",
    "voice_prompt": "string",
    "preview_text": "string",
    "language_hints": [
        "zh"
    ],
    "enable_preprocess": false,
    "max_prompt_audio_length": 3,
    "enable_volume_normalization": false,
    "sample_rate": 24000,
    "response_format": "wav"
}'

返回响应

🟢200

application/json

创建成功

Bodyapplication/json

示例

{
    "code": 200,
    "message": "音色创建成功",
    "data": {
        "voice_id": "cosyvoice-v3.5-plus-yuntts-xxxxxxxx"
    },
    "database_saved": true
}

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

语音合成（CosyVoice）

更新音色（CosyVoice 复刻音色）