Texto a voz (HTTP)

Clonación de voz - crear modelo

Lip sync - crear tarea

Perfil de usuario

Texto a voz (HTTP) — HTTP v2

Sintetiza voz con un ID de voz y ajustes opcionales del motor.

Texto a voz (HTTP v2)

Sintetiza voz con un ID de voz y ajustes opcionales del motor.

Endpoint

POST /api/open/v2/speech/tts

Encabezados de solicitud

Content-Type
stringheaderObligatorio
application/json
Authorization
stringheaderObligatorio
Bearer <token> (API Key)

Parámetros de solicitud

application/json
voiceId
stringObligatorio
Clonación de voz - listar modelos
modelId
stringOpcionalOpcional: engine
Clonación de voz - crear modelo
Opciones disponibles:fishaudio-s2profishaudio-s1minimax-2.8-turbominimax-2.8-hdminimax-2.6-turbominimax-2.6-hdqwen3-tts-flash
text
stringObligatorio
Voz a texto
format
stringOpcionalOpcional: mp3
Múltiples formatos
Opciones disponibles:mp3wavogg
speed
numberOpcionalOpcional: 1
Generación rápida
volume
numberOpcionalOpcional: 0
Opciones disponibles:
stability
numberOpcional
Sincronía audio-visual
similarity
numberOpcional
Clonación de voz - crear modelo
pitch
numberOpcional
Opciones disponibles:
language
stringOpcional
Opciones disponibles:
emotion
stringOpcional
Creatividad ilimitada
Opciones disponibles:happysadangryfearfuldisgustedsurprisedcalm
token
string // Optional if Authorization: Bearer is set
Consulta cuota API restante e información básica.

Datos de respuesta

// Datos de respuesta - 200
Content-Type: audio/mpeg (or audio/wav / audio/ogg depending on format)
<Múltiples formatos>

// Datos de respuesta

// Consulta fallida
{
  "code": string,
  "message": string,
  "requestId"?: string
}

Ejemplo CURL

curl -X POST https://fishspeech.vercel.app/api/open/v2/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "voiceId": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "modelId": "fishaudio-s2pro",
    "text": "Hello, world.",
    "format": "wav",
    "speed": 1,
    "volume": 0
  }' \
  --output output.wav

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