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/jsonVollständige URL:
https://fishaudio.org/v1/audio/speechBewahren 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
}| Feld | Geben Sie | ein Erforderlich | Notizen |
|---|---|---|---|
model | Zeichenfolge | Ja | Kitta Audio-Motormodell-ID, z. B. fishaudio-s21pro-flash |
input | Zeichenfolge | Ja | Zu synthetisierender Text |
voice | Zeichenfolge oder Objekt | Ja | Sprach-ID-Zeichenfolge oder ein Objekt wie { "id": "00a1b221-6137-4b73-ad62-b0cbce134167" } |
response_format | Zeichenfolge | Nein | mp3, wav oder pcm; Der Standardwert ist mp3 |
speed | Nummer | Nein | Sprechgeschwindigkeit 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_KEYVerwenden 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.mp3Tavo 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
| Status | Bedeutung | Aktion |
|---|---|---|
400 | Ungültige Eingabe, Sprache, Modell, Format oder Geschwindigkeit | Korrigieren Sie die Anfrage, bevor Sie es erneut versuchen |
401 | API-Schlüssel fehlt oder ist ungültig | Überprüfen oder ersetzen Sie den Integrationsschlüssel |
402 | API-Kontingent ist nicht ausreichend | Fügen Sie ein Kontingent hinzu, bevor Sie mehr Audio generieren |
429 | Anforderungsratenlimit überschritten | Mit exponentiellem Backoff erneut versuchen |
500 | TTS-Generierung fehlgeschlagen | Nur mit Erkennung doppelter Gebühren erneut versuchen |