Kitta Audio Docs
API ReferenzText-to-Speech

OpenAI-kompatibel TTS

Verbinden Sie Tavo und andere OpenAI-kompatible Sprach-Clients mit Kitta Audio TTS.

OpenAI-kompatibel TTS

Verwenden Sie diesen Endpunkt, wenn ein Client den OpenAI POST /v1/audio/speech-Vertrag erwartet. Es ist für Integrationen wie Tavos Custom OpenAI Protocol TTS-Anbieter gedacht.

Für eine native Kitta Audio-Integration mit dem vollständigen Anforderungsvertrag verwenden Sie Sync HTTP.

Endpunkt

POST /v1/audio/speech
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Vollständige URL:

https://fishaudio.org/v1/audio/speech

Bewahren Sie den API-Schlüssel auf einem vertrauenswürdigen Server oder im geschützten API-Anmeldeinformationsfeld des Drittanbieters auf. Erstellen Sie für jeden Kunden oder jede Integration einen separaten Schlüssel, damit dieser unabhängig überwacht und widerrufen werden kann.

Anfrage

{
  "model": "fishaudio-s21pro-flash",
  "input": "Hello from Kitta Audio.",
  "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "response_format": "mp3",
  "speed": 1
}
FeldGeben Sieein ErforderlichNotizen
modelZeichenfolgeJaKitta Audio-Motormodell-ID, z. B. fishaudio-s21pro-flash
inputZeichenfolgeJaZu synthetisierender Text
voiceZeichenfolge oder ObjektJaSprach-ID-Zeichenfolge oder ein Objekt wie { "id": "00a1b221-6137-4b73-ad62-b0cbce134167" }
response_formatZeichenfolgeNeinmp3, wav oder pcm; Der Standardwert ist mp3
speedNummerNeinSprechgeschwindigkeit von 0.5 bis 2; Der Standardwert ist 1

Rufen Sie Sprach-IDs von GET /api/open/v1/voices ab. Für einen schnellen Verbindungstest nutzen Sie die öffentliche Systemstimme 00a1b221-6137-4b73-ad62-b0cbce134167. Verwenden Sie eine unterstützte Kitta Audio TTS-Modell-ID. OpenAI-Modellnamen wie tts-1 sind keine Aliase für Kitta Audio-Modelle.

Einige Clients von Drittanbietern erkennen Stimmen über eine OpenAI-kompatible Stimmenliste. Sie können anrufen:

GET /v1/audio/voices
Authorization: Bearer YOUR_API_KEY

Verwenden Sie einen zurückgegebenen voices[].id-Wert als voice in einer Sprachanforderung.

Antwort

Eine erfolgreiche Anfrage gibt binäres Audio zurück:

HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-OpenAPI-Quota-Remaining: 987988
X-OpenAPI-Credits-Used: 12

<binary audio data>

Der Client sollte die Antwort gemäß Content-Type speichern oder abspielen. Fehler sind JSON-Antworten und verwenden dasselbe Authentifizierungs-, Kontingent- und Generierungsverhalten wie der native Synchronisierungsendpunkt.

curl Beispiel

curl -X POST "https://fishaudio.org/v1/audio/speech" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fishaudio-s21pro-flash",
    "input": "Hello from Kitta Audio.",
    "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "response_format": "mp3",
    "speed": 1
  }' \
  --output speech.mp3

Tavo verbinden

Befolgen Sie für die Einrichtung von API-Taste, Basis-URL, Modell, Stimme und Zeichenbindung die spezielle Kitta Audio TTS für Tavo-Anleitung.

Fehler

StatusBedeutungAktion
400Ungültige Eingabe, Sprache, Modell, Format oder GeschwindigkeitKorrigieren Sie die Anfrage, bevor Sie es erneut versuchen
401API-Schlüssel fehlt oder ist ungültigÜberprüfen oder ersetzen Sie den Integrationsschlüssel
402API-Kontingent ist nicht ausreichendFügen Sie ein Kontingent hinzu, bevor Sie mehr Audio generieren
429Anforderungsratenlimit überschrittenMit exponentiellem Backoff erneut versuchen
500TTS-Generierung fehlgeschlagenNur mit Erkennung doppelter Gebühren erneut versuchen