Saltar para o conteúdo principal

​
Introdução

Fish TTS é um serviço de áudio AI fornecido pela Ace Data Cloud, um serviço de síntese de voz Fish. Através da API unificada da Ace Data Cloud, você pode usar cURL para chamar rapidamente o Fish TTS e realizar conversão de texto em fala, múltiplas vozes, personalização de voz, entre outras funcionalidades.

​
Pré-requisitos

  • Ter uma conta na Ace Data Cloud e obter o API Token
  • Ambiente de terminal com cURL instalado

​
Uso Básico

O endpoint principal para chamar a API Fish TTS é: 
POST https://api.acedata.cloud/fish/audios
Este exemplo usa o modelo fish-tts.
Modelos disponíveis incluem: fish-tts. Exemplo completo de comando cURL: 
curl -X POST https://api.acedata.cloud/fish/audios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "speech", "prompt": "你好，欢迎使用 Ace Data Cloud 的语音合成服务", "voice_id": "d7900c21663f485ab63ebdb7e5905036", "model": "fish-tts"}'
Substitua YOUR_API_TOKEN pelo Token real obtido na plataforma Ace Data Cloud.

​
Exemplo de Resposta

Após uma chamada bem-sucedida, será retornado um dado no formato JSON, por exemplo: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Usando jq para Processar a Resposta

Recomenda-se usar a ferramenta jq para formatar a saída: 
curl -s -X POST https://api.acedata.cloud/fish/audios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "speech", "prompt": "你好，欢迎使用 Ace Data Cloud 的语音合成服务", "voice_id": "d7900c21663f485ab63ebdb7e5905036", "model": "fish-tts"}' | jq .

​
Tratamento de Erros

Códigos de erro comuns:
CódigoDescrição
401Falha na autenticação, verifique o API Token
403Saldo insuficiente ou acesso negado
429Limite de requisições excedido
500Erro interno do servidor

​
Próximos Passos