Kitta Audio Docs
API ReferenceVoice Management

Delete Voice

Delete a personal voice owned by the current account.

CN API paths use a separate contract

This English reference describes the global FishAudio Open API. For Kitta Audio China integrations, use the CN API Reference, API Playground, and API Keys in this site.

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.

Continue with runnable API checks

Docs and executable requests stay in the same CN-site surface. After reading the reference, open the API Playground for curl examples or manage API keys in the developer workspace.

On this page