跳转到主要内容
声音复刻

声音复刻 HTTP API

声音复刻 HTTP API 概述,包含请求头、服务端点和音色状态说明。

声音复刻 API 支持通过上传音频创建自定义克隆音色,并管理音色的完整生命周期(创建、查询、更新、列表、删除)。 用户指南声音复刻

服务端点

POST https://dashscope.aliyuncs.com/api/v1/services/audio/tts/customization
所有声音复刻操作(创建、查询、更新、列表、删除)共享同一端点,通过请求体中的 action 字段区分操作类型。

请求头

参数类型是否必选说明
AuthorizationstringBearer $DASHSCOPE_API_KEY
Content-Typestring固定为 application/json

支持的模型

声音复刻支持两套 API:
模型适用场景支持的操作
voice-enrollment(CosyVoice)CosyVoice 系列模型的声音复刻创建、查询、更新、列表、删除
qwen-voice-enrollment(Qwen)Qwen-TTS 系列模型的声音复刻创建、列表、删除
两套 API 的操作互相独立:CosyVoice 创建的音色仅能用于 CosyVoice 合成,Qwen 创建的音色仅能用于 Qwen-TTS 合成。

音色状态说明

创建音色后,系统会自动进行审核。音色状态可通过查询音色详情接口获取。
状态说明
DEPLOYING审核中/处理中。
OK审核通过,可正常使用。
UNDEPLOYED审核未通过,不可使用。

API 索引

CosyVoice(voice-enrollment

操作页面
创建音色创建克隆音色
查询音色详情查询克隆音色
更新音色更新克隆音色
查询列表查询克隆音色列表
删除音色删除克隆音色

Qwen(qwen-voice-enrollment

操作页面
创建音色创建克隆音色
查询列表查询克隆音色列表
删除音色删除克隆音色