Text to speech

Minimax and voice cloning

Minimax voices and cloning your own voice.

High-quality multilingual TTS using Minimax models. 1 character = 1 credit. 481 voices across 30+ languages.

POST/api/minimax-tts

Synchronous (~5-30 s). The response body is the binary audio itself (Content-Type: audio/mpeg), not a URL — save it to a file. Response headers: X-Credits-Used, X-Credits-Remaining, X-Characters, X-Job-Id.

Request body

FieldTypeRequiredDescription
textstringyesUp to 500,000 chars per call.
voice_idstringyesNumeric Minimax voice_id from POST /api/minimax-tts/voices (e.g. 209533299589184 "Calm Woman", 209533299589198 "Captivating Storyteller"). Pass the voice_id the list returned, verbatim. Slug ids such as English_CalmWoman are still accepted as a legacy alias. An unknown voice returns HTTP 400 "Selected voice is not available..." before anything is charged.
speednumberno0.5–1.5 (default 1.0).

The upstream picks the model itself; model, language_boost, vol, pitch and emotion are accepted for backward compatibility but ignored.

cURL
curl -X POST "https://www.dubvoice.ai/api/minimax-tts" \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello world",
    "voice_id": "209533299589184"
  }' \
  --output out.mp3

POST/api/minimax-tts/voices

List Minimax voices (481 total). Empty body {} returns the first 100; page_size goes up to 500. Filter with tag_list (["Turkish"], ["Male", "Mature"]) and/or a free-text search (matches id, name, language, accent, tags and description).

Each voice in the response has both voice_id (numeric, e.g. 209533299589184) and voice_name (short display label, e.g. Calm Woman). Always pass the voice_id to /api/minimax-tts — the voice_name is for display only; sending it returns HTTP 400 "Selected voice is not available..." and nothing is charged.

sample_audio carries a playable preview URL for 480 of the 481 voices. Where it is still an empty string no precomputed preview exists upstream — synthesise one on demand by sending a few words through /api/minimax-tts with the desired voice_id.

cURL
curl -X POST "https://www.dubvoice.ai/api/minimax-tts/voices" \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{ "tag_list": ["Turkish"] }'

POST/api/voice-clone— Clone a voice

Free. Uploads a sample audio file and returns a cloned_voice_id. Cloned voices are used from the dashboard; they are not available through the public TTS API yet. Synthesis with a clone in the dashboard bills the standard 1 character = 1 credit.

Multipart body

FieldTypeRequiredDescription
filefileyesMP3 or WAV, 10 to 25 seconds of clear speech, max 10 MB. A longer MP3 or WAV is cut to its first 25 seconds; a longer file in another format is refused with HTTP 400.
voice_namestringnoDisplay name (default "My Voice").
language_tagstringnoPrimary language label (English / Turkish / Spanish / …). Default English.
gender_tagstringnomale / female (default male).
cURL
curl -X POST "https://www.dubvoice.ai/api/voice-clone" \
  -H "Authorization: Bearer sk_..." \
  -F "file=@sample.mp3" \
  -F "voice_name=Rachel Clone" \
  -F "language_tag=English" \
  -F "gender_tag=female"

→ { "success": true, "cloned_voice_id": "<voice_id from the clone response>", "voice_name": "Rachel Clone" }

The clone then appears in the dashboard voice picker.

GET/api/voice-clone— List cloned voices

cURL
curl "https://www.dubvoice.ai/api/voice-clone" \
  -H "Authorization: Bearer sk_..."

DELETE/api/voice-clone?voice_id=<id>

cURL
curl -X DELETE "https://www.dubvoice.ai/api/voice-clone?voice_id=<voice_id from the clone response>" \
  -H "Authorization: Bearer sk_..."

Search docs

Find a page or an endpoint