Corps de la requête
Timeout des requêtes synchrones : cet endpoint non-chat attend que le modèle routé termine son traitement. Les entrées volumineuses, les longs fichiers audio ou les grands lots peuvent dépasser les valeurs par défaut courantes de 30s côté client ; configurez donc le timeout de votre client HTTP à au moins120s.
Les champs optionnels pris en charge varient selon la famille de modèles. TokenLab valide cette matrice avant le routage : OpenAI TTS accepte voice, instructions, response_format, stream_format et speed ; MiniMax speech accepte voice, voice_id, response_format, stream_format et speed ; Gemini TTS accepte prompt, language_code, voice, response_format, stream_format, speed et temperature ; les routes TTS plus strictes de type Vidu/Kling peuvent n’accepter que input et stream_format. Les champs de premier niveau inconnus, y compris user, renvoient 400 unsupported_parameter au lieu d’être ignorés.
Modèle TTS. Exemples :
tts-1, gpt-4o-mini-tts, speech-02-hd et gemini-2.5-flash-tts. Consultez GET /v1/models?recommended_for=tts pour la sélection actuelle.Le texte pour lequel générer l’audio. Maximum 4096 caractères.
Sélecteur de voix. Passez un nom intégré comme
nova, une voix Gemini comme Kore, ou un objet comme { "id": "voice-id" } pour les voix personnalisées compatibles.Sélecteur vocal natif du fournisseur pour les modèles speech compatibles MiniMax.
Instructions optionnelles de style ou de rendu pour les modèles TTS compatibles OpenAI qui les prennent en charge.
Prompt optionnel de style de parole pour les modèles Gemini TTS.
Code de langue optionnel, par exemple
en-US, pour les routes Gemini, xAI et TTS compatibles.Format audio. Les valeurs courantes incluent
mp3, opus, aac, flac, wav et pcm ; les valeurs prises en charge varient selon la famille de modèles.Format de livraison TokenLab :
audio ou sse. stream_format=sse n’est pas pris en charge pour tts-1 ni tts-1-hd.Vitesse de parole pour les familles de modèles qui la prennent en charge (0.25 à 4.0).
Température d’échantillonnage pour les routes TTS compatibles Gemini (0 à 2).
Réponse
Retourne le fichier audio dans le format demandé.Exemples de voix
| Voix | Description |
|---|---|
alloy | Neutre, équilibrée |
ash | Calme, mesurée |
ballad | Mélodique, expressive |
coral | Chaleureuse, accueillante |
echo | Chaleureuse, conversationnelle |
fable | Expressif, narratif |
nova | Amicale, claire |
onyx | Grave, autoritaire |
sage | Sage, réfléchie |
shimmer | Douce, délicate |
verse | Dynamique, polyvalente |
Exemple de réponse
Champs importants
Type d’événement ou de message retourné par l’API.
Corps brut de la réponse. Enregistrez-le directement sans le parser en JSON.