OpenAI 删除自定义音色

删除音色

delete /audio/voices/{voice_id}

删除从文本提示或音频样本创建的音色。

需要音色写入权限及对音色所属项目的访问权。从录音创建的音色仅向符合条件的客户开放。参阅自定义音色指南。

删除音色不会删除其授权录音。删除已删除的音色会返回404错误。

路径参数

• voice_id: string

要删除的音色 ID。

返回值

• VoiceDeleted object { id, deleted, object }

• id: string

音色标识。

• deleted: boolean

音色是否已删除。

• object: "audio.voice.deleted"

对象类型，固定为audio.voice.deleted。

• "audio.voice.deleted"

示例

## [中文] 发送DELETE请求；将示例API凭证及呼叫标识替换为应用使用的值。
curl https://api.openai.com/v1/audio/voices/$VOICE_ID \
    -X DELETE \
    -H "Authorization: Bearer $OPENAI_API_KEY"

响应

中文说明：以下为原文配置、命令或事件示例，字段名、枚举、标识符及数值保留。

{
  "id": "voice_1234",
  "deleted": true,
  "object": "audio.voice.deleted"
}

示例

## [中文] 发送DELETE请求；将示例API凭证及呼叫标识替换为应用使用的值。
curl https://api.openai.com/v1/audio/voices/voice_1234 \
  -X DELETE \
  -H "Authorization: Bearer $OPENAI_API_KEY"

响应

中文说明：以下为原文配置、命令或事件示例，字段名、枚举、标识符及数值保留。

{
  "id": "voice_1234",
  "object": "audio.voice.deleted",
  "deleted": true
}