Texto a voz (HTTP)

Clonación de voz - crear modelo

Lip sync - crear tarea

Perfil de usuario

Texto a voz (HTTP) (HTTP)

Síntesis REST con el ID de voz y opciones del motor.

Texto a voz (HTTP)

Endpoint

POST /api/open/v1/speech/tts

Encabezados de solicitud

// Parámetros de solicitud
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY  // API Key

// Parámetros de solicitud
Content-Type: application/msgpack
Authorization: Bearer YOUR_API_KEY  // API Key

Parámetros de solicitud

Parámetros de solicitud de ejemplo

Opciones disponibles:

  • • Texto a voz (HTTP): v1, v2, s1
  • • Texto a voz (HTTP v2): v3-turbo, v3-hd
  • • Opcional: Sintetiza voz con un ID de voz y ajustes opcionales del motor.

Datos de respuesta

// Datos de respuesta (cache=false) - 200
Content-Type: audio/mpeg
<Múltiples formatos>

// Datos de respuesta (cache=true) - 200
Content-Type: application/json
{
  "success": boolean,        // Datos de respuesta
  "audio_url": string,       // Voz a texto
  "format": string,          // Múltiples formatos
  "characters_used": number, // Parámetros de solicitud
  "quota_remaining": number  // Consulta cuota API restante e información básica.
}

// Consulta fallida
{
  "error": string     // Consulta fallida
}

Ejemplo CURL

# Parámetros de solicitud - Opcional
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voiceId": "your_voice_id",
    "modelId": "fishaudio-s21pro-flash",
    "text": "Voz a texto",
    "speed": 1.0,
    "volume": 0,
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# Parámetros de solicitud - Opciones disponibles:
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voiceId": "your_voice_id",
    "modelId": "minimax-2.8-hd",
    "text": "Voz a texto",
    "speed": 1.0,
    "volume": 0,
    "emotion": "calm",
    "language": "zh",
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# Parámetros de solicitud (undefined)

Depuración en línea

Códigos de estado

200: Success
400: Bad Request
401: Unauthorized
403: Forbidden
404: Not Found
429: Too Many Requests
500: Internal Server Error