Delete voice

POST/v1/delete_voice

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.

Delete voice

curl https://api.hop-base.com/v1/delete_voice \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_type": "voice_cloning",
    "voice_id": "MyNarrator01"
  }'

200application/json

{
  "voice_id": "MyNarrator01",
  "created_time": "1790380920",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Headers

Authorization:requiredstring

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

Body parametersJSON

voice_type:requiredstring

Always voice_cloning

Valuesvoice_cloning

voice_id:requiredstring

Name of the cloned voice to delete

Returns

200Deleted

voice_id:optionalstring

Name of the deleted voice

created_time:optionalstring

Voice creation time, Unix seconds as a string

base_resp:optionalobject

{"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

400voice_type must be "voice_cloning", voice_id "…" does not exist, or an unknown field is present

401Missing, invalid or expired API key (missing_api_key / invalid_api_key / api_key_expired)

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)

Headers

Body parametersJSON

Returns

Errors

Related