Fish Audio Docs
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_KEY

Full URL example:

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

Use 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

ParameterTypeDescription
voiceIdstringVoice 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

StatusMeaning
401API key is missing or invalid
403Account cannot delete this voice
404Voice does not exist or does not belong to account
500Provider deletion or usage logging failed

Deleting a voice records Open API usage. It does not refund prior generation usage.

On this page