Processo de solicitação
Para usar a API Fish Audios Generation, primeiro acesse o Console Ace Data Cloud para obter seu API Token e guarde-o para uso posterior.
Se você ainda não estiver conectado ou registrado, será automaticamente redirecionado para a página de login, onde será convidado a se registrar e fazer login; após a conclusão, retornará automaticamente à página atual.
Um API Token pode chamar todos os serviços da plataforma, sem a necessidade de solicitar separadamente para cada serviço. Na primeira solicitação, será concedida uma cota gratuita para experimentação; quando a cota for insuficiente, você poderá recarregar o saldo geral no console.
📘 Documentação completa: Fish Audios Generation API →
Exemplo de solicitação
A API Fish Tasks pode ser usada para consultar os resultados da API Fish Audios Generation. Sobre como usar a API Fish Audios Generation, consulte a documentação Fish Videos Generation API . Usamos como exemplo um ID de tarefa retornado pelo serviço API Fish Audios Generation para demonstrar como usar esta API. Suponha que temos um ID de tarefa: 2725a2d3-f87e-4905-9c53-9988d5a7b2f5, a seguir demonstramos como ao inserir um ID de tarefa.Imagem de exemplo da tarefa
Configurar os cabeçalhos e o corpo da solicitação
Request Headers incluem:accept: especifica o recebimento de resultados de resposta no formato JSON, aqui preenchido comoapplication/json.authorization: a chave para chamar a API, após a solicitação pode ser selecionada diretamente no menu suspenso.
id: o ID da tarefa enviada.action: a forma de operação da tarefa.
Exemplo de código
Pode-se perceber que vários códigos em diferentes linguagens já foram gerados automaticamente no lado direito da página, como mostrado na imagem:
CURL
Exemplo de resposta
Após a solicitação ser bem-sucedida, a API retornará as informações detalhadas da tarefa aqui. Por exemplo:id, o ID que gera esta tarefa, usado para identificar exclusivamente esta tarefa de geração.request, as informações da solicitação na consulta da tarefa.response, as informações de retorno na consulta da tarefa; quando for finalmente bem-sucedida, ocost.amountnela contido são os Credits efetivamente deduzidos nesta síntese.created_at, horário de criação da tarefa, timestamp Unix (segundos, ponto flutuante).started_at, horário de início da execução da tarefa, timestamp Unix (segundos, ponto flutuante).finished_at, horário de conclusão da tarefa, timestamp Unix (segundos, ponto flutuante). Este campo não é retornado quando a tarefa não foi concluída.elapsed, tempo de execução da tarefa, em segundos (ponto flutuante, mantendo 3 casas decimais). Este campo não é retornado quando a tarefa não foi concluída.
Operação de consulta em lote
Isto é para consultar detalhes de tarefas para vários IDs de tarefa; diferente do acima, é necessário selecionar action como retrieve_batch Request Body inclui:ids: array de IDs das tarefas enviadas.action: a forma de operação da tarefa.
Exemplo de código
Pode-se perceber que vários códigos em diferentes linguagens já foram gerados automaticamente no lado direito da página, como mostrado na imagem:
Exemplo de resposta
Após a solicitação ser bem-sucedida, a API retornará as informações detalhadas específicas de todas as tarefas em lote desta vez. Por exemplo:items contém as informações detalhadas específicas das tarefas em lote. As informações específicas de cada tarefa são as mesmas que os campos acima, e as informações dos campos são as seguintes.
items, todas as informações detalhadas específicas das tarefas em lote. É um array, e cada elemento do array tem o mesmo formato do resultado retornado ao consultar uma única tarefa acima.count, o número de tarefas consultadas em lote aqui.
CURL
Tratamento de erros
Ao chamar a API, se ocorrer um erro, a API retornará o código e a mensagem de erro correspondentes. Por exemplo:400 token_mismatched：Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.400 api_not_implemented：Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.401 invalid_token：Não autorizado, token de autorização inválido ou ausente.429 too_many_requests：Muitas solicitações, você excedeu o limite de taxa.500 api_error：Erro interno do servidor, algo deu errado no servidor.