Anfragekörper
Timeout für synchrone Anfragen: Dieser Nicht-Chat-Endpunkt wartet, bis das geroutete Modell fertig ist. Große Eingaben, lange Audiodateien oder große Batches können übliche 30s-Client-Defaults überschreiten; setzen Sie das Timeout Ihres HTTP-Clients daher auf mindestens120s.
Unterstützte optionale Felder unterscheiden sich je nach Modellfamilie. TokenLab validiert diese Feldmatrix vor dem Routing: OpenAI TTS akzeptiert voice, instructions, response_format, stream_format und speed; MiniMax Speech akzeptiert voice, voice_id, response_format, stream_format und speed; Gemini TTS akzeptiert prompt, language_code, voice, response_format, stream_format, speed und temperature; engere Vidu/Kling-artige TTS-Routen akzeptieren möglicherweise nur input und stream_format. Unbekannte Top-Level-Felder, einschließlich user, werden nicht ignoriert, sondern mit 400 unsupported_parameter abgelehnt.
TTS-Modell. Beispiele sind
tts-1, gpt-4o-mini-tts, speech-02-hd und gemini-2.5-flash-tts. Fragen Sie GET /v1/models?recommended_for=tts für die aktuelle Auswahl ab.Der Text, für den Audio erzeugt werden soll. Maximal 4096 Zeichen.
Stimm-Auswahl. Übergeben Sie einen integrierten Namen wie
nova, eine Gemini-Stimme wie Kore oder ein Objekt wie { "id": "voice-id" } für kompatible benutzerdefinierte Stimmen.Provider-nativer Stimm-Selector für MiniMax-kompatible Speech-Modelle.
Optionale Stil- oder Vortragsanweisungen für OpenAI-kompatible TTS-Modelle, die dieses Feld unterstützen.
Optionaler Prompt für den Sprechstil bei Gemini TTS-Modellen.
Optionaler Sprachcode, zum Beispiel
en-US, für Gemini-, xAI- und kompatible TTS-Routen.Audioformat. Häufige Werte sind
mp3, opus, aac, flac, wav und pcm; unterstützte Werte variieren je nach Modellfamilie.TokenLab-Auslieferungsformat:
audio oder sse. stream_format=sse wird für tts-1 und tts-1-hd nicht unterstützt.Sprechgeschwindigkeit für Modellfamilien, die sie unterstützen (0.25 bis 4.0).
Sampling-Temperatur für Gemini-kompatible TTS-Routen (0 bis 2).
Antwort
Gibt die Audiodatei im angeforderten Format zurück.Sprachbeispiele
| Stimme | Beschreibung |
|---|---|
alloy | Neutral, ausgewogen |
ash | Ruhig, bedacht |
ballad | Melodisch, ausdrucksstark |
coral | Warm, einladend |
echo | Warm, dialogorientiert |
fable | Ausdrucksstark, erzählerisch |
nova | Freundlich, klar |
onyx | Tief, autoritativ |
sage | Weise, nachdenklich |
shimmer | Sanft, weich |
verse | Dynamisch, vielseitig |
Antwortbeispiel
Wichtige Felder
Von der API zurückgegebener Event- oder Nachrichtentyp.
Roher Antwortkörper. Direkt speichern, nicht als JSON parsen.