Texto para fala (HTTP)

Clonagem de voz - criar modelo

Lip sync - criar tarefa

Perfil do usuário

Texto para fala (HTTP) (HTTP)

Síntese REST com ID de voz e opções do motor.

Texto para fala (HTTP)

Endpoint

POST /api/open/v1/speech/tts

Cabeçalhos da solicitação

// Parâmetros da solicitação
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY  // Chave API

// Parâmetros da solicitação
Content-Type: application/msgpack
Authorization: Bearer YOUR_API_KEY  // Chave API

Parâmetros da solicitação

Parâmetros de requisição de exemplo

Opções disponíveis:

  • • Texto para fala (HTTP): v1, v2, s1
  • • Texto para fala (HTTP v2): v3-turbo, v3-hd
  • • Opcional: Sintetize fala com um ID de voz e configurações opcionais.

Dados da resposta

// Dados da resposta (cache=false) - 200
Content-Type: audio/mpeg
<Múltiplos formatos>

// Dados da resposta (cache=true) - 200
Content-Type: application/json
{
  "success": boolean,        // Dados da resposta
  "audio_url": string,       // Fala para texto
  "format": string,          // Múltiplos formatos
  "characters_used": number, // Parâmetros da solicitação
  "quota_remaining": number  // Consulte cota restante da API e dados básicos da conta.
}

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

Exemplo CURL

# Parâmetros da solicitação - 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": "Fala para texto",
    "speed": 1.0,
    "volume": 0,
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# Parâmetros da solicitação - Opções disponíveis:
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": "Fala para texto",
    "speed": 1.0,
    "volume": 0,
    "emotion": "calm",
    "language": "zh",
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# Parâmetros da solicitação (undefined)

Depuração online

Códigos de status

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