声音定制

删除音色

删除音色并释放配额。

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": "qwen-voice-design",
  "input": {
    "action": "delete",
    "voice": "qwen-tts-vd-announcer-voice-20251210145409-a1b2"
  }
}'

{
  "output": {
    "voice": "qwen-tts-vd-announcer-voice-20251210145409-a1b2"
  },
  "usage": {},
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

请求体

application/json

enum<string>

必填

语音设计模型，固定值为 qwen-voice-design。

可选值：qwen-voice-design

示例:qwen-voice-design

object

必填

显示子属性

enum<string>

必填

操作类型，固定值为 delete。

可选值：delete

示例:delete

string

必填

要删除的音色名称，可通过获取音色列表接口查询。

示例:qwen-tts-vd-announcer-voice-20251210145409-a1b2

响应

200-application/json

object

显示子属性

string

已删除的音色名称。

示例:qwen-tts-vd-announcer-voice-20251210145409-a1b2

object

用量信息（删除操作时为空）。

string

请求 ID，用于问题排查。

示例:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

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": "qwen-voice-design",
  "input": {
    "action": "delete",
    "voice": "qwen-tts-vd-announcer-voice-20251210145409-a1b2"
  }
}'

{
  "output": {
    "voice": "qwen-tts-vd-announcer-voice-20251210145409-a1b2"
  },
  "usage": {},
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}