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 Fish 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 Fish 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 Fish Audio TTS pris en charge ; Les noms de modèles OpenAI tels que tts-1 ne sont pas des alias pour les modèles Fish 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 Fish 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 Fish Audio TTS pour Tavo] dédié (/fr/docs/integration-guides/third-party/tavo).

Erreurs