Fish Audio 文档
API 文档音色管理

删除音色

删除当前账户创建的个人音色。

删除音色

DELETE /api/open/v1/voices/{voiceId}
Authorization: Bearer YOUR_API_KEY

完整地址示例:

https://fishaudio.org/api/open/v1/voices/voice_abc123

voiceId 使用创建或查询接口返回的 voiceId。删除接口只适用于当前账户有权限管理的个人音色,不能删除平台公开音色。

路径参数

参数类型说明
voiceIdstring要删除的音色 ID

curl 示例

curl -X DELETE "https://fishaudio.org/api/open/v1/voices/voice_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应

{
  "voiceId": "voice_abc123"
}

删除成功后,客户端应从本地音色列表中移除该音色。历史生成记录仍可能引用这个 voiceId

错误行为

状态码场景
401API 密钥缺失或无效
403当前账户无权删除该音色
404音色不存在,或不属于当前账户
500删除供应商音色或写入用量记录失败

删除接口会写入 API 用量记录,但不会退还历史生成消耗。

本页内容