OpenAI-Compatible TTS

Utilisez ce point de terminaison lorsqu'un client attend le contrat OpenAI POST /v1/audio/speech. Il est destiné aux intégrations telles que le fournisseur Custom OpenAI Protocol TTS de Tavo.

Pour une intégration native de Kitta Audio avec le contrat de demande complet, utilisez Sync HTTP.

Point de terminaison

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

URL complète :

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

Conservez la clé API sur un serveur approuvé ou dans le champ d'informations d'identification protégé API du fournisseur tiers. Créez une clé distincte pour chaque client ou intégration afin qu'elle puisse être surveillée et révoquée indépendamment.

Demande

{
  "model": "fishaudio-s21pro-flash",
  "input": "Hello from Kitta Audio.",
  "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "response_format": "mp3",
  "speed": 1
}

Obtenez les identifiants vocaux de GET /api/open/v1/voices. Pour un test de connexion rapide, utilisez la voix du système public 00a1b221-6137-4b73-ad62-b0cbce134167. Utilisez un identifiant de modèle Kitta Audio TTS pris en charge ; Les noms de modèles OpenAI tels que tts-1 ne sont pas des alias pour les modèles Kitta Audio.

Certains clients tiers découvrent les voix via une liste vocale compatible OpenAI. Ils peuvent appeler :

GET /v1/audio/voices
Authorization: Bearer YOUR_API_KEY

Utilisez une valeur voices[].id renvoyée comme voice dans une requête vocale.

Réponse

Une requête réussie renvoie l'audio binaire :

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

<binary audio data>

Le client doit enregistrer ou lire la réponse selon Content-Type. Les erreurs sont des réponses JSON et utilisent le même comportement d'authentification, de quota et de génération que le point de terminaison de synchronisation natif.

curl Exemple

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

Connecter Tavo

Pour la configuration de la clé API, de l'URL de base, du modèle, de la voix et de la liaison de caractères, suivez le [guide Kitta Audio TTS pour Tavo] dédié (/fr/docs/integration-guides/third-party/tavo).

Erreurs