TTS compatible Fish Audio

Utilisez ce point de terminaison lorsqu'un client code en dur la forme de requête fish.audio POST /v1/tts. Il mappe cette charge utile dans le pipeline Fish Audio Open TTS tout en conservant l'authentification, le quota et la facturation de la clé API sur votre compte Fish Audio.

Pour une intégration native Open API, préférez Sync HTTP. Pour les clients OpenAI POST /v1/audio/speech, utilisez OpenAI-Compatible TTS.

Point de terminaison

POST /v1/tts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
model: s2.1-pro

URL complète :

https://fishaudio.org/v1/tts

Si l'application tierce demande une base Fish Audio API telle que https://api.fish.audio, définissez-la sur https://fishaudio.org et laissez le chemin comme /v1/tts.

Conservez la clé API dans le champ d’informations d’identification protégé du client. Créez une clé dédiée pour chaque application afin de pouvoir la surveiller ou la révoquer indépendamment.

Demande

{
  "text": "Hello from Fish Audio.",
  "reference_id": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "format": "mp3",
  "temperature": 0.7,
  "top_p": 0.7,
  "normalize": true,
  "prosody": {
    "speed": 1
  }
}

Mappage de l'en-tête du modèle

Les valeurs d'en-tête inconnues sont ignorées et le moteur par défaut du serveur s'applique. Vous pouvez également envoyer un identifiant de moteur natif tel que fishaudio-s21pro-flash dans l'en-tête.

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.

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>

Les erreurs sont JSON et partagent le comportement d'authentification, de quota et de génération avec Sync HTTP.

curl Exemple

curl -X POST "https://fishaudio.org/v1/tts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "model: s2.1-pro" \
  -d '{
    "text": "Hello from Fish Audio.",
    "reference_id": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "format": "mp3",
    "prosody": { "speed": 1 }
  }' \
  --output speech.mp3

Connecter RikkaHub

Pour la clé API, l'URL de base, le modèle et la configuration vocale dans RikkaHub, suivez le [guide de configuration RikkaHub] dédié (/fr/docs/integration-guides/third-party/rikkahub).

Erreurs