Skip to content

Delete voice

Delete your MiniMax cloned voice or Doubao cloned voice; free.

POST/v1/delete_voice

MiniMax and Doubao share this path; pick a series below to see its request body and response.

MiniMax Speech 2.8: Only cloned voices can be deleted, and voice_type is always voice_cloning. After deletion, the same voice_id can be cloned again; synthesizing with a deleted voice returns 400.

Doubao Voice Cloning 2.0: the body must include "model": "seed-icl-2.0" and the voice_id to delete. After deletion that voice_id can no longer be used, and your cloned-voice allowance is freed right away so you can clone again.

Headers

Authorization:requiredstring

Bearer sk-…: an API key created in the console under API keys; its group must include the requested model

Body parametersJSON

Family
Model docs
voice_type:requiredstring

Always voice_cloning

Valuesvoice_cloning

voice_id:requiredstring

Name of the cloned voice to delete

Returns

200Deleted

Family
voice_id:optionalstring

Name of the deleted voice

created_time:optionalstring

Voice creation time, Unix seconds as a string

base_resp:requiredobject

{"status_code": 0, "status_msg": "success"} on success; errors do not come here but as a non-200 status code with an error object

Errors

400MiniMax: voice_type must be "voice_cloning", voice_id "…" does not exist, or an unknown field is present. Doubao: missing model, voice_id is required, an unknown field, or unknown_voice (the voice_id does not exist)
401Missing, invalid or expired API key (missing_api_key / invalid_api_key / api_key_expired)
409Doubao: voice_clone_in_progress, a clone or delete request from the same account has not finished
413Request body over 64 KiB: request body is too large
503Voice or file registry temporarily unavailable; retry later (e.g. voice registry is temporarily unavailable; please retry)

Related