API 文档音色管理
删除音色
删除当前账户创建的个人音色。
删除音色
DELETE /api/open/v1/voices/{voiceId}
Authorization: Bearer YOUR_API_KEY完整地址示例:
https://fishaudio.org/api/open/v1/voices/voice_abc123voiceId 使用创建或查询接口返回的 voiceId。删除接口只适用于当前账户有权限管理的个人音色,不能删除平台公开音色。
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
voiceId | string | 要删除的音色 ID |
curl 示例
curl -X DELETE "https://fishaudio.org/api/open/v1/voices/voice_abc123" \
-H "Authorization: Bearer YOUR_API_KEY"响应
{
"voiceId": "voice_abc123"
}删除成功后,客户端应从本地音色列表中移除该音色。历史生成记录仍可能引用这个 voiceId。
错误行为
| 状态码 | 场景 |
|---|---|
401 | API 密钥缺失或无效 |
403 | 当前账户无权删除该音色 |
404 | 音色不存在,或不属于当前账户 |
500 | 删除供应商音色或写入用量记录失败 |
删除接口会写入 API 用量记录,但不会退还历史生成消耗。