API-Referenz

Text zu Sprache

POST/v1/audio/speech

Synthetisiert Sprache und liefert bei Erfolg modellabhängige Audiodaten. Das Standardformat bestimmt das gewählte Modell. Bei aktivierter Dateiarchivierung beschreiben Antwortheader wie X-Gloop-File-Id/X-Gloop-Storage-Status den Speicherungsstand. Audio nicht als JSON behandeln.

Authentifizierung und Berechtigungen

Verwenden Sie Ihren aktuellen GloopAPI-Schlüssel. Verfügbare Modelle, Funktionen und Berechtigungen hängen von seinem Katalog und der Endpunktdokumentation ab.

Authorization: Bearer $GLOOP_API_KEY

Authentifizierungsschemata: BearerAuth

Anfrage

Anfragekörper · application/json

Typ: object
Pflichtfelder: modelinputvoice

Anfragekörper erforderlich

modelstringErforderlich
inputstringErforderlich
Zu synthetisierender Text; Längenlimits hängen vom gewählten Modell ab. Es gibt kein allgemeines Limit von 4096 Zeichen.
voicestringErforderlich
Unterstützung und Grenzen hängen vom gewählten Modell ab; einheitliche Standardwerte sind nicht garantiert.
response_formatstringOptional
Angefordertes Audioausgabeformat; unterstützte Werte und Format bei Auslassung bestimmt das gewählte Modell. Der allgemeine Plattformendpunkt setzt mp3 nicht als Standard.
speednumberOptional
Unterstützung und Grenzen hängen vom gewählten Modell ab; einheitliche Standardwerte sind nicht garantiert.
instructionsstringOptional
Modellabhängige Sprachanweisungen.
stream_formatstringOptional
Modellabhängiges Streamingformat; SSE-Unterstützung ist nicht für alle Modelle garantiert.

Antworten und Fehler

HTTP 200

Audio erfolgreich generiert

audio/mpeg

Typ: string
Format: binary
Beschreibung: Audiobytestream; als Datei speichern.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/wav

Typ: string
Format: binary
Beschreibung: Audiobytestream; als Datei speichern.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/ogg

Typ: string
Format: binary
Beschreibung: Audiobytestream; als Datei speichern.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/flac

Typ: string
Format: binary
Beschreibung: Audiobytestream; als Datei speichern.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/aac

Typ: string
Format: binary
Beschreibung: Audiobytestream; als Datei speichern.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

application/octet-stream

Typ: string
Format: binary
Beschreibung: Audiobytestream; als Datei speichern.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

HTTP 401

Key fehlt, ist ungültig, abgelaufen oder widerrufen.

application/json

Typ: object
Pflichtfelder: error

errorobjectErforderlich
Unterfelder von error (4)
- codestringOptional
- messagestringOptional
- typestringOptional
- request_idstringOptional

HTTP 403

Unzureichende IP-, Konto-, Modell- oder Tool-Berechtigungen.

application/json

Typ: object
Pflichtfelder: error

errorobjectErforderlich
Unterfelder von error (4)
- codestringOptional
- messagestringOptional
- typestringOptional
- request_idstringOptional

HTTP 429

Anfrage-/Warteschlangenlimit.

application/json

Typ: object
Pflichtfelder: error

errorobjectErforderlich
Unterfelder von error (4)
- codestringOptional
- messagestringOptional
- typestringOptional
- request_idstringOptional

HTTP 500

Interner Authentifizierungs- oder Datenspeicherungsfehler.

application/json

Typ: object
Pflichtfelder: error

errorobjectErforderlich
Unterfelder von error (4)
- codestringOptional
- messagestringOptional
- typestringOptional
- request_idstringOptional