Body Permintaan
Timeout permintaan sinkron: endpoint non-chat ini menunggu model yang dirutekan selesai. Input besar, audio panjang, atau batch besar dapat melebihi default client umum 30s, jadi atur timeout HTTP client Anda minimal120s.
Field opsional yang didukung berbeda menurut family model. TokenLab memvalidasi matriks field ini sebelum routing: OpenAI TTS menerima voice, instructions, response_format, stream_format, dan speed; MiniMax speech menerima voice, voice_id, response_format, stream_format, dan speed; Gemini TTS menerima prompt, language_code, voice, response_format, stream_format, speed, dan temperature; route TTS yang lebih sempit seperti Vidu/Kling mungkin hanya menerima input dan stream_format. Field top-level yang tidak dikenal, termasuk user, akan mengembalikan 400 unsupported_parameter alih-alih diabaikan.
Model TTS. Contohnya
tts-1, gpt-4o-mini-tts, speech-02-hd, dan gemini-2.5-flash-tts. Kueri GET /v1/models?recommended_for=tts untuk daftar terbaru.Teks untuk menghasilkan audio. Maksimum 4096 karakter.
Selector suara. Kirim nama bawaan seperti
nova, suara Gemini seperti Kore, atau objek seperti { "id": "voice-id" } untuk suara kustom yang kompatibel.Selector suara native provider untuk model speech yang kompatibel dengan MiniMax.
Instruksi gaya atau delivery opsional untuk model TTS kompatibel OpenAI yang mendukungnya.
Prompt gaya bicara opsional untuk model Gemini TTS.
Kode bahasa opsional, misalnya
en-US, untuk route Gemini, xAI, dan TTS kompatibel.Format audio. Nilai umum mencakup
mp3, opus, aac, flac, wav, dan pcm; nilai yang didukung berbeda menurut family model.Format delivery TokenLab:
audio atau sse. stream_format=sse tidak didukung untuk tts-1 atau tts-1-hd.Kecepatan bicara untuk family model yang mendukungnya (0.25 hingga 4.0).
Sampling temperature untuk route TTS kompatibel Gemini (0 hingga 2).
Respons
Mengembalikan file audio dalam format yang diminta.Sampel Voice
| Voice | Deskripsi |
|---|---|
alloy | Netral, seimbang |
ash | Tenang, terukur |
ballad | Melodis, ekspresif |
coral | Hangat, mengundang |
echo | Hangat, percakapan |
fable | Ekspresif, naratif |
nova | Ramah, jelas |
onyx | Dalam, berwibawa |
sage | Bijaksana, penuh pertimbangan |
shimmer | Lembut, halus |
verse | Dinamis, serbaguna |
Contoh respons
Field penting
Tipe event atau message yang dikembalikan API.
Body respons mentah. Simpan langsung, jangan parse sebagai JSON.