Fish Model Create API Integração

Esta interface é baseada na API Model do Fish Audio e é utilizada para criar um modelo de voz clonada reutilizável a longo prazo com base em uma amostra de áudio. O endereço é POST https://api.acedata.cloud/fish/model.

Se você precisa usar uma voz de referência temporariamente, não é necessário criar um modelo, você pode usar diretamente o references da API Fish TTS para clonagem instantânea. Para pesquisar vozes existentes, consulte a API Fish Model Query; para consultar detalhes de uma única voz pelo _id, consulte a API Fish Model Get.

Processo de Solicitação

Para usar a API Fish Model, primeiro acesse o console da Ace Data Cloud para obter seu Token de API, que deve ser guardado.

Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, onde será convidado a se registrar e logar. Após a conclusão, você será redirecionado de volta para a página atual. Um Token de API é suficiente para acessar todos os serviços da plataforma, não é necessário solicitar um para cada serviço. A primeira solicitação oferece um crédito gratuito para que você possa experimentar; se o crédito acabar, você pode recarregar o saldo geral no console.

📘 Documentação completa: API Fish Model →

Campos do Corpo da Solicitação

Campo	Tipo	Obrigatório	Descrição
`title`	string	Sim	Nome da voz, usado para identificação na lista do console.
`voices`	string	Sim	URL HTTP(S) da amostra de áudio (uma única string, não um array). Esta interface não suporta upload multipart/binário, coloque o áudio em qualquer armazenamento de objetos acessível publicamente.
`description`	string	Não	Descrição da voz.
`cover_image`	string	Não	URL HTTP(S) da imagem de capa.
`tags`	string[]	Não	Tags de pesquisa da biblioteca pública, por exemplo, `["male","narration","zh"]`.
`texts`	string[]	Não	Texto de referência correspondente à amostra (para correção de pronúncia).
`enhance_audio_quality`	boolean	Não	Se deve melhorar a qualidade do áudio da amostra antes do treinamento.
`generate_sample`	boolean	Não	Se deve gerar automaticamente um exemplo de áudio após a conclusão do treinamento.

Os campos são idênticos aos da interface anterior, consulte também a documentação oficial do Fish.

Exemplo: Criar uma voz clonada privada

curl -X POST 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "title": "Minha voz clonada",
    "description": "Voz em chinês clonada a partir de uma gravação de podcast",
    "voices": "https://example.com/sample-voice.mp3",
    "cover_image": "https://cdn.acedata.cloud/e724d7f13d.png"
  }'

Atenção: voices deve ser uma string (uma única URL de áudio), não um array. Se for passado como ["..."], a interface anterior irá rejeitar.

A resposta bem-sucedida retorna diretamente o objeto ModelEntity da plataforma Fish (o exemplo abaixo é a voz mínima utilizável que testamos, com alguns campos longos removidos para facilitar a leitura):

{
  "_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
  "type": "tts",
  "title": "copilot-smoke-test",
  "description": "smoke test from api.acedata.cloud",
  "cover_image": "coverimage/e5c6db52c3ed417f9cb2e5a33fb04667",
  "train_mode": "fast",
  "state": "trained",
  "tags": [],
  "samples": [
    {
      "title": "Default Sample",
      "text": "师父，[语气坚定]我真的受够了这山上的清冷日子！...",
      "task_id": "6a1bf398dfae49dca0e23159214342a0",
      "audio": "https://platform.r2.fish.audio/task/6a1bf398dfae49dca0e23159214342a0.mp3"
    }
  ],
  "created_at": "2026-05-10T03:52:55.601000Z",
  "updated_at": "2026-05-10T03:52:55.601000Z",
  "languages": ["zh"],
  "visibility": "public",
  "default_text": "师父，[语气坚定]我真的受够了这山上的清冷日子！...",
  "like_count": 0,
  "mark_count": 0,
  "shared_count": 0,
  "task_count": 0,
  "author": {
    "_id": "780f2b2f862d41a08c0507bbbda77eb6",
    "nickname": "Penny Conrad",
    "avatar": "avatars/780f2b2f862d41a08c0507bbbda77eb6.jpg"
  }
}

_id pode ser usado como o valor do campo reference_id na API Fish TTS para sintetizar voz usando essa voz clonada:

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "Olá, esta é uma voz sintetizada usando a voz clonada que acabei de criar.",
    "reference_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
    "format": "mp3"
  }'

Requisitos da Amostra

Valores recomendados (consistente com a interface anterior, consulte a documentação oficial do Fish):

Duração recomendada de mais de 30 segundos e até 5 minutos; mais de 10 minutos tem um retorno marginal baixo.
Taxa de amostragem de 16 kHz ou mais, mono ou estéreo.
O conteúdo deve ser o mais limpo possível: sem música de fundo, eco, ruído ambiental evidente; com o mesmo falante.
Formato recomendado mp3 / wav.

Se você não tiver certeza da qualidade da amostra, pode passar enhance_audio_quality: true para que a interface anterior faça a melhoria da qualidade do áudio.

Informações de Cobrança

Criar um modelo de voz clonada (POST /fish/model) é gratuito, não há cobrança; as interfaces de consulta de voz (Fish Model Query, Fish Model Get) também não têm custo. A cobrança ocorre apenas ao chamar a API Fish TTS para sintetizar voz, conforme o uso.

Tratamento de Erros

400 token_mismatched：Parâmetros de solicitação ausentes ou inválidos (o mais comum é que voices não seja uma URL ou tenha sido passado como um array).
401 invalid_token：Token de autenticação inexistente ou inválido.
429 too_many_requests：Limite de taxa da conta acionado.
500 api_error：Erro interno do servidor.

Exemplo de resposta de erro:

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "voices é obrigatório e deve ser uma URL HTTP(S) apontando para um arquivo de áudio"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusão

Para chamar esta interface, basta preparar uma URL de áudio de amostra acessível publicamente, colocá-la no campo voices para obter o _id, e então fornecer o reference_id para /fish/tts, completando assim o processo de “clonagem → síntese”. Um ponto comum de erro é que voices deve ser uma string, não pode ser um array.

Primeiros passos

Chat AI

Imagem AI

Vídeo AI

Áudio AI

Web e Dados

CAPTCHA

Identidade

Proxy

Avançado

Coding

Fish Model Create API Integração

Processo de Solicitação

Campos do Corpo da Solicitação

Exemplo: Criar uma voz clonada privada

Requisitos da Amostra

Informações de Cobrança

Tratamento de Erros

Conclusão

​Processo de Solicitação

​Campos do Corpo da Solicitação

​Exemplo: Criar uma voz clonada privada

​Requisitos da Amostra

​Informações de Cobrança

​Tratamento de Erros

​Conclusão

Processo de Solicitação

Campos do Corpo da Solicitação

Exemplo: Criar uma voz clonada privada

Requisitos da Amostra

Informações de Cobrança

Tratamento de Erros

Conclusão