跳转到主要内容
CosyVoice

查询设计音色详情(CosyVoice)

查询指定 CosyVoice 设计音色的详情,包括状态、创建时间等。

POST
/services/audio/tts/customization
cURL
curl -X POST https://dashscope.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "voice-enrollment",
  "input": {
    "action": "query_voice",
    "voice_id": "cosyvoice-v3-plus-myvoice-xxxxxx"
  }
}'
{
  "output": {
    "voice_id": "cosyvoice-v3.5-plus-vd-announcer-xxxxxx",
    "gmt_create": "2025-12-10 14:54:09",
    "gmt_modified": "2025-12-10 17:47:48",
    "target_model": "cosyvoice-v3.5-plus",
    "status": "OK",
    "voice_prompt": "沉稳的中年男性播音员,音色低沉浑厚",
    "preview_text": "各位听众朋友们,大家好"
  },
  "usage": {},
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

鉴权

string
header
必填

DashScope API Key。前往获取 API Key

请求体

application/json
enum<string>
必填

固定为 voice-enrollment

voice-enrollment
voice-enrollment
object
必填

响应

200-application/json
object
object

用量信息。查询接口返回空对象。

string

请求 ID,用于问题排查。

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx