Skip to main content

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 minimal 120s. 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.
string
default:"tts-1"
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.
string
wajib
Teks untuk menghasilkan audio. Maksimum 4096 karakter.
string | object
Selector suara. Kirim nama bawaan seperti nova, suara Gemini seperti Kore, atau objek seperti { "id": "voice-id" } untuk suara kustom yang kompatibel.
string
Selector suara native provider untuk model speech yang kompatibel dengan MiniMax.
string
Instruksi gaya atau delivery opsional untuk model TTS kompatibel OpenAI yang mendukungnya.
string
Prompt gaya bicara opsional untuk model Gemini TTS.
string
Kode bahasa opsional, misalnya en-US, untuk route Gemini, xAI, dan TTS kompatibel.
string
Format audio. Nilai umum mencakup mp3, opus, aac, flac, wav, dan pcm; nilai yang didukung berbeda menurut family model.
string
default:"audio"
Format delivery TokenLab: audio atau sse. stream_format=sse tidak didukung untuk tts-1 atau tts-1-hd.
number
Kecepatan bicara untuk family model yang mendukungnya (0.25 hingga 4.0).
number
Sampling temperature untuk route TTS kompatibel Gemini (0 hingga 2).

Respons

Mengembalikan file audio dalam format yang diminta.

Sampel Voice

Contoh respons

Field penting

string
Tipe event atau message yang dikembalikan API.
binary
Body respons mentah. Simpan langsung, jangan parse sebagai JSON.