API ReferenceVoice Management
Delete Voice
Delete a personal voice owned by the current account.
Delete Voice
DELETE /api/open/v1/voices/{voiceId}
Authorization: Bearer FISHAUDIO_API_KEYFull URL example:
https://fishaudio.org/api/open/v1/voices/voice_abc123Use the voiceId returned by list or create endpoints. This endpoint only deletes personal voices that the current account can manage. It cannot delete platform public voices.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
voiceId | string | Voice ID to delete |
curl Example
curl -X DELETE "https://fishaudio.org/api/open/v1/voices/voice_abc123" \
-H "Authorization: Bearer FISHAUDIO_API_KEY"Response
{
"voiceId": "voice_abc123"
}After deletion, remove the voice from your local selection list. Historical generation records may still reference the old voiceId.
Errors
| Status | Meaning |
|---|---|
401 | API key is missing or invalid |
403 | Account cannot delete this voice |
404 | Voice does not exist or does not belong to account |
500 | Provider deletion or usage logging failed |
Deleting a voice records Open API usage. It does not refund prior generation usage.