İstek Gövdesi
Senkron istek zaman aşımı: Bu chat dışı endpoint, yönlendirilen modelin tamamlanmasını bekler. Büyük girdiler, uzun sesler veya büyük batch’ler yaygın 30s istemci varsayılanlarını aşabilir; bu yüzden HTTP istemcisi zaman aşımını en az120s olarak ayarlayın.
Desteklenen isteğe bağlı alanlar model ailesine göre değişir. TokenLab bu alan matrisini yönlendirmeden önce doğrular: OpenAI TTS voice, instructions, response_format, stream_format ve speed kabul eder; MiniMax speech voice, voice_id, response_format, stream_format ve speed kabul eder; Gemini TTS prompt, language_code, voice, response_format, stream_format, speed ve temperature kabul eder; daha dar Vidu/Kling tarzı TTS rotaları yalnızca input ve stream_format kabul edebilir. user dahil bilinmeyen üst seviye alanlar yok sayılmaz, 400 unsupported_parameter döndürür.
TTS modeli. Örnekler:
tts-1, gpt-4o-mini-tts, speech-02-hd ve gemini-2.5-flash-tts. Güncel liste için GET /v1/models?recommended_for=tts sorgulayın.Ses üretilecek metin. Maksimum 4096 karakter.
Ses seçici.
nova gibi yerleşik bir ses, Kore gibi Gemini sesi veya uyumlu özel sesler için { "id": "voice-id" } gibi bir nesne gönderin.MiniMax uyumlu speech modelleri için sağlayıcıya özgü ses seçici.
Destekleyen OpenAI uyumlu TTS modelleri için isteğe bağlı stil veya okuma talimatları.
Gemini TTS modelleri için isteğe bağlı konuşma stili prompt’u.
Gemini, xAI ve uyumlu TTS route’ları için isteğe bağlı dil kodu, örneğin
en-US.Ses formatı. Yaygın değerler
mp3, opus, aac, flac, wav ve pcm; desteklenen değerler model ailesine göre değişir.TokenLab teslim formatı:
audio veya sse. tts-1 ve tts-1-hd için stream_format=sse desteklenmez.Destekleyen model aileleri için konuşma hızı (0.25 ile 4.0 arası).
Gemini uyumlu TTS route’ları için sampling temperature (0 ile 2 arası).
Yanıt
İstenen formatta ses dosyasını döndürür.Ses Örnekleri
| Ses | Açıklama |
|---|---|
alloy | Nötr, dengeli |
ash | Sakin, ölçülü |
ballad | Melodik, etkileyici |
coral | Sıcak, davetkar |
echo | Sıcak, konuşma tarzında |
fable | Etkileyici, anlatımsal |
nova | Dostane, net |
onyx | Derin, otoriter |
sage | Bilge, düşünceli |
shimmer | Yumuşak, nazik |
verse | Dinamik, çok yönlü |
Yanıt örneği
Önemli alanlar
API tarafından dönen event veya message type.
Ham yanıt gövdesi. JSON olarak parse etmeden doğrudan kaydedin.