Fish Model Get API Integração

Esta interface é baseada na API Model oficial da Fish Audio e é utilizada para consultar os detalhes completos de um único clone de voz pelo _id. O endereço é GET https://api.acedata.cloud/fish/model/{id}.

Para criar uma voz, consulte a API Fish Model Create; para pesquisa paginada, consulte a API Fish Model Query.

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 para uso futuro.

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 sendo necessário solicitar um para cada serviço individualmente. A primeira solicitação oferece um crédito gratuito para que você possa experimentar; quando o crédito acabar, você pode recarregar o saldo geral no console.

📘 Documentação completa: API Fish Model →

Parâmetros de Caminho

Parâmetro	Obrigatório	Descrição
`id`	Sim	O `_id` da voz (string hexadecimal de 32 bits). Pode ser retornado ao criar através do Fish Model Create ou obtido através da Fish Model Query.

Sem corpo de solicitação, sem parâmetros de consulta.

Exemplo: Obter detalhes completos de uma voz pública em espanhol

curl 'https://api.acedata.cloud/fish/model/8d2c17a9b26d4d83888ea67a1ee565b2' \
  -H 'authorization: Bearer {token}'

Retorno (testado, a string de consulta da assinatura em samples[].audio foi removida para facilitar a leitura):

{
  "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
  "type": "tts",
  "title": "Valentino Narración Biblica Fer",
  "description": "Uma voz masculina madura e autoritária com um tom calmo e espiritual. É bem adequada para narrações religiosas, conteúdo educacional e contação de histórias profissionais em espanhol.",
  "cover_image": "coverimage/8d2c17a9b26d4d83888ea67a1ee565b2",
  "train_mode": "fast",
  "state": "trained",
  "tags": [
    "male", "old", "narration", "calm", "serious",
    "authoritative", "professional", "clear", "Spanish"
  ],
  "samples": [
    {
      "title": "Amostra Padrão",
      "text": "Hermanos míos, recordemos las palabras del Señor en estos tiempos difíciles. Como dice la Escritura, la fe mueve montañas, y el amor de Dios nos guía en cada paso del camino. Mantengamos firme nuestra confianza en Su divina providencia.",
      "task_id": "59ce7df6935c42249759327ddf70f37b",
      "audio": "https://c97f3361a1c971323738e24f451a0225.r2.cloudflarestorage.com/fish-platform-data/task/59ce7df6935c42249759327ddf70f37b.mp3?X-Amz-...signed..."
    }
  ],
  "created_at": "2025-03-13T08:11:10.326000Z",
  "updated_at": "2026-05-03T09:01:41.437000Z",
  "languages": ["es"],
  "visibility": "public",
  "lock_visibility": false,
  "dmca_taken_down": false,
  "default_text": "Hermanos míos, recordemos las palabras del Señor...",
  "quality": null,
  "like_count": 4344,
  "mark_count": 4409,
  "shared_count": 590,
  "task_count": 708461,
  "unliked": false,
  "liked": false,
  "marked": false,
  "author": {
    "_id": "1b82fb6a329c4462b67aa9ee0a42046f",
    "nickname": "Fernando Caicedo",
    "avatar": "avatars/1b82fb6a329c4462b67aa9ee0a42046f.jpg"
  }
}

O _id obtido pode ser diretamente fornecido ao reference_id da Fish TTS para sintetizar a voz correspondente:

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "Hermanos míos, hoy es un buen día.",
    "reference_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
    "format": "mp3"
  }'

Diferenças em relação à interface de lista

Campo	`GET /fish/model` (lista)	`GET /fish/model/{id}` (detalhes)
`samples[].audio`	URL de cache R2 de curto prazo	Link direto R2 assinado (inclui assinatura de consulta)
`unliked` / `liked` / `marked` / `dmca_taken_down`	Também existem	Também existem
`default_text` / `lock_visibility`	Também existem	Também existem

Se você só deseja ouvir, o samples[].audio na interface de lista já é suficiente; para links de download mais estáveis, recomenda-se usar esta interface.

Campos de Resposta (trecho)

Campo	Tipo	Descrição
`_id`	string	ID da voz (usado como `reference_id` em `/fish/tts`).
`type`	string	Tipo de modelo, geralmente `tts`.
`title`	string	Nome da voz.
`description`	string	Descrição longa.
`state`	string	Estado de treinamento: `trained` significa disponível, `training` significa que ainda está em treinamento.
`tags`	string[]	Tags da biblioteca pública.
`samples`	object[]	Amostras pré-definidas, contendo `title`, `text`, `task_id`, `audio` link direto.
`languages`	string[]	Códigos de idiomas em que a voz é proficiente.
`visibility`	string	`public` ou `private`.
`like_count`	integer	Número de curtidas na biblioteca pública.
`task_count`	integer	Número de sínteses históricas (pode ser usado como referência para popularidade).
`author`	object	Informações do autor: `_id` / `nickname` / `avatar`.
`created_at`	string	Data de criação em ISO 8601.
`updated_at`	string	Última data de atualização em ISO 8601.

Informações de Cobrança

Esta interface não gera cobrança — consultar os detalhes de uma única voz pelo ID é uma operação gratuita. Criar uma voz (Fish Model Create) também é gratuito, e a cobrança ocorre apenas ao chamar a Fish TTS para sintetizar a voz, com base no uso.

Tratamento de Erros

400 token_mismatched: O id no caminho não está em um formato válido, ou o upstream retorna “Model not found”.
401 invalid_token: O token de autenticação não existe ou é inválido.
404 not_found: O _id especificado não é visível no upstream do Fish (o timbre foi excluído, é privado ou pertence a outra conta).
429 too_many_requests: Limite de taxa da conta acionado.
500 api_error: Erro interno do servidor.

Quando uma solicitação é feita para um ID inexistente, o upstream retorna diretamente 400 Model not found (testado na prática):

curl 'https://api.acedata.cloud/fish/model/test123' \
  -H 'authorization: Bearer {token}'

Retorno:

{ "status": 400, "message": "Model not found" }

Exemplo de resposta de erro:

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusão

Ao saber o _id do timbre, use diretamente esta interface para obter o ModelEntity completo. Os usos mais comuns são: (1) ouvir samples[].audio, (2) fornecer o _id para o reference_id de /fish/tts para completar a síntese. Se você tiver apenas o título ou as tags, primeiro use Fish Model Query para pesquisar.

Primeiros passos

Chat AI

Imagem AI

Vídeo AI

Áudio AI

Web e Dados

CAPTCHA

Identidade

Proxy

Avançado

Coding

Fish Model Get API Integração

Processo de Solicitação

Parâmetros de Caminho

Exemplo: Obter detalhes completos de uma voz pública em espanhol

Diferenças em relação à interface de lista

Campos de Resposta (trecho)

Informações de Cobrança

Tratamento de Erros

Conclusão

​Processo de Solicitação

​Parâmetros de Caminho

​Exemplo: Obter detalhes completos de uma voz pública em espanhol

​Diferenças em relação à interface de lista

​Campos de Resposta (trecho)

​Informações de Cobrança

​Tratamento de Erros

​Conclusão

Processo de Solicitação

Parâmetros de Caminho

Exemplo: Obter detalhes completos de uma voz pública em espanhol

Diferenças em relação à interface de lista

Campos de Resposta (trecho)

Informações de Cobrança

Tratamento de Erros

Conclusão