Fish Audio Docs
Back to site

Início rápido

Crie uma chave API e gere seu primeiro áudio de fala.

Início rápido

Esta página ajuda você a concluir rapidamente uma solicitação real de conversão de texto em voz. Comece com TTS síncrono porque ele retorna o áudio diretamente e é o caminho mais fácil de testar.

1. Crie uma chave API

Crie uma chave API na sua conta Fish Audio:

Abrir configurações API

A chave API completa é mostrada apenas uma vez. Armazene-o em uma variável de ambiente do lado do servidor. Não o envie em código de navegador, aplicativos móveis ou repositórios públicos.

export FISHAUDIO_API_KEY="YOUR_API_KEY"

2. Escolha uma voz

Liste as vozes disponíveis para sua conta:

curl "https://fishaudio.org/api/open/v1/voices" \
  -H "Authorization: Bearer $FISHAUDIO_API_KEY"

Copie o ID de voz retornado e use-o como voiceId. Para testar a conexão imediatamente, use a voz de teste do sistema público 00a1b221-6137-4b73-ad62-b0cbce134167 e substitua-a posteriormente pela sua voz preferida.

3. Gerar fala

curl -X POST "https://fishaudio.org/api/open/v1/speech/tts" \
  -H "Authorization: Bearer $FISHAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -o speech.audio \
  -d '{
    "text": "Hello from Fish Audio.",
    "voiceId": "00a1b221-6137-4b73-ad62-b0cbce134167"
  }'

Se a solicitação for bem-sucedida, speech.audio será salvo em seu diretório atual. Use o cabeçalho de resposta Content-Type para escolher a extensão de arquivo final.

Próximas etapas

NecessidadeLeia
Escolha fluxos sincronizados, assíncronos ou em loteEscolha um API
Ler contratos de endpointReferência API
Entenda a autenticaçãoAutenticação
Gerar falaTexto em fala
Solicitações de teste no navegadorParque API