Zum Hauptinhalt springen
POST
Sprachausgabe erzeugen

Eine Stimme wählen

Setze voice auf oberster Ebene für portable Anfragen. Phaseo ordnet sie der Stimme des gerouteten Anbieters zu; eine voice, die der geroutete Anbieter und das Modell nicht akzeptieren, gibt 400 invalid_request_error mit param: "voice" zurück. Übergib für eleven-labs/eleven-v4 und eleven-labs/eleven-v4-turbo eine beliebige 20-stellige ID aus der ElevenLabs-Stimmenbibliothek, auch für einen eigenen Stimmenklon. Setze config.elevenlabs.voice_settings.stability und similarity_boost nach Bedarf. Eleven v4 unterstützt weder speed noch voice_settings.style.

Eine anbieternative Stimme übergeben

So verwendest du statt voice die eigene Stimmeinstellung eines Anbieters:
  • ElevenLabs: config.elevenlabs.voice_id, config.elevenlabs.voice oder config.elevenlabs.voiceName.
  • Google: config.google.voice_name oder config.google.voiceName.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

application/json
model
string
erforderlich
input
string
erforderlich
models
string[]

Optionale, geordnete Fallback-Modelle, die nach model versucht werden. model ist erforderlich und immer das primäre Modell. Schlägt ein Versuch mit 429, 500, 502, 503 oder 504 fehl, wird der nächste Eintrag versucht; andere Fehler werden unverändert zurückgegeben. Akzeptiert bis zu 25 Modell-IDs oder Presets; Duplikate und Einträge, die model entsprechen, werden ignoriert. Jeder Versuch wird als eigene Anfrage validiert, protokolliert und abgerechnet, und das Feld model der Antwort sowie der Routing-Trace zeigen das Modell, das die Anfrage bedient hat. Streaming-Anfragen weichen nur vor dem ersten Byte aus, Video- und Musikjobs nur bei der Übermittlung. Batch-, Realtime- und Council-Anfragen lehnen models ab. Auf einer dynamischen Route festgelegte Fallbacks haben Vorrang, und phaseo/auto kann nicht mit models kombiniert werden.

Required array length: 1 - 25 elements
Minimum string length: 1
Beispiel:
voice
string
speed
number
Erforderlicher Bereich: 0.25 <= x <= 4
format
enum<string>
Verfügbare Optionen:
mp3,
wav,
ogg,
aac
provider
object

Anbieterrouting-Präferenzen für die Auswahl durch das Gateway.

config
object

Antwort

200 - audio/mpeg

Audiodatei

The response is of type file.

Zuletzt geändert am 16. November 2026