List voices
List system voices, your MiniMax cloned voices or your Doubao cloned voices; free.
/v1/get_voiceMiniMax and Doubao share this path; pick a series below to see its request body and response.
MiniMax Speech 2.8: voice_type voice_cloning lists your cloned voices, system lists system voices, and all lists everything; voice_generation is always empty. Categories you did not request are null in the response. Cloned voices include only voices in your account that were cloned successfully and have not been deleted or expired. You can also see system voices in System voices.
Doubao Voice Cloning 2.0: the body must include "model": "seed-icl-2.0". Without voice_id, the response has a voices array listing all your cloned voices; with it, the response is that voice object alone, and a voice that does not exist or is not in your account returns 400 unknown_voice.
Headers
Bearer sk-…: an API key created in the console under API keys; its group must include the requested model
Body parametersJSON
Voice category to list
Valuessystemvoice_cloningvoice_generationall
Always seed-icl-2.0, required; HopBase uses it to route the request to Doubao Voice Cloning
Valuesseed-icl-2.0
Look up only this cloned voice; omit it to list them all
Returns
200Voice list
System voices; null if not requested
Your cloned voices; null if not requested
The voice name you chose
Always an empty array
Creation date, YYYY-MM-DD (UTC)
Always an empty array; null if not requested
{"status_code": 0, "status_msg": "success"} on success; errors do not come here but as a non-200 status code with an error object
0 on success
success on success
Returned without voice_id: all your cloned voices. With voice_id, the response is that voice object itself (same fields as the array items)
Cloned voice ID (starting with hbv_); pass it as voice on /v1/audio/speech
ready can synthesize; training is still training, check again later; failed training failed, retrain by passing the voice_id or delete it
Valuesreadytrainingfailed
Language code of the recording
Trainings left for this voice (15 per voice in total); once used up, delete it and clone again
Creation time, Unix seconds
Errors
voice_type must be one of system, voice_cloning, voice_generation, all, or an unknown field is present. Doubao: missing model, an unknown field, or unknown_voice (the voice_id does not exist)missing_api_key / invalid_api_key / api_key_expired)request body is too largevoice registry is temporarily unavailable; please retry)