TTS compatible con Fish Audio

Utilice este punto final cuando un cliente codifique la forma de solicitud fish.audio POST /v1/tts. Asigna esa carga útil al canal Fish Audio Open TTS mientras mantiene la autenticación de clave, la cuota y la facturación de API en su cuenta Fish Audio.

Para una integración nativa de Open API, prefiera Sync HTTP. Para clientes OpenAI POST /v1/audio/speech, utilice OpenAI compatible con TTS.

Punto final

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

URL completa:

https://fishaudio.org/v1/tts

Si la aplicación de terceros solicita una base Fish Audio API como https://api.fish.audio, configúrela en https://fishaudio.org y deje la ruta como /v1/tts.

Mantenga la clave API en el campo de credenciales protegidas del cliente. Cree una clave dedicada para cada aplicación para que pueda monitorearla o revocarla de forma independiente.

Pedido

{
  "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
  }
}

Mapeo del encabezado del modelo

Los valores de encabezado desconocidos se ignoran y se aplica el motor predeterminado del servidor. También puede enviar una identificación de motor nativa como fishaudio-s21pro-flash en el encabezado.

Obtenga ID de voz de GET /api/open/v1/voices. Para una prueba de conexión rápida, utilice la voz del sistema público 00a1b221-6137-4b73-ad62-b0cbce134167.

Respuesta

Una solicitud exitosa devuelve audio binario:

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

<binary audio data>

Los errores son JSON y comparten el comportamiento de autenticación, cuota y generación con Sync HTTP.

Ejemplo curl

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

Conectar RikkaHub

Para la clave API, la URL base, el modelo y la configuración de voz en RikkaHub, siga la [guía de configuración RikkaHub] dedicada (/es/docs/integration-guides/third-party/rikkahub).

Errores