Saltar para o conteúdo principal
A principal função da API Suno Tasks é consultar o status de execução de uma tarefa inserindo o ID da tarefa gerada pela API Suno Audios Generation ou pela API Suno Lyrics Generation. Este documento apresentará em detalhes as instruções de integração da API Suno Tasks, ajudando você a integrar facilmente e aproveitar plenamente os poderosos recursos desta API. Por meio da API Suno Tasks, você pode facilmente consultar o status de execução das tarefas da API Suno Lyrics Generation ou da API Suno Audios Generation.

​
Processo de solicitação

Para usar a API Suno Audios Generation, primeiro obtenha seu API Token no Console Ace Data Cloud e guarde-o para uso posterior. Se você ainda não fez login ou se registrou, será automaticamente redirecionado para a página de login, onde será convidado a se registrar e fazer login; após concluir, você retornará automaticamente à página atual. Um API Token pode chamar todos os serviços da plataforma, não sendo necessário solicitar separadamente para cada serviço. Na primeira solicitação, serão concedidos créditos gratuitos para uma experiência sem custo; quando os créditos forem insuficientes, você poderá recarregar o saldo geral no console.
📘 Documentação completa: Suno Audios Generation API →

​
Exemplo de solicitação

A API Suno Tasks pode ser usada para consultar os resultados de duas APIs: Suno Audios Generation API e Suno Lyrics Generation API. Sobre como usar a API Suno Audios Generation, consulte a documentação Suno Audios Generation API . Sobre como usar a API Suno Lyrics Generation, consulte Suno Lyrics Generation API . Usaremos como exemplo um ID de tarefa retornado pelo serviço da API Suno Audios Generation para demonstrar como usar esta API. Suponha que temos um ID de tarefa: eae26f89-b64b-404d-a80c-761996660b1c, a seguir demonstraremos como por meio da inserção de um ID de tarefa.

​
Imagem de exemplo da tarefa

​
Configurar os cabeçalhos e o corpo da solicitação

Os Request Headers incluem:
  • accept: especifica o recebimento dos resultados de resposta no formato JSON; aqui, preencha com application/json.
  • authorization: a chave para chamar a API; após solicitá-la, você pode selecioná-la diretamente no menu suspenso.
O Request Body inclui:
  • id: o ID da tarefa enviada.
  • action: o método de operação na tarefa.
Configure conforme mostrado na imagem abaixo:

​
Exemplo de código

É possível observar que vários códigos em diferentes linguagens já foram gerados automaticamente no lado direito da página, conforme mostrado na imagem:

Alguns exemplos de código são os seguintes:

​
CURL

​
Python

​
Exemplo de resposta

Após a solicitação ser bem-sucedida, a API retornará as informações detalhadas da tarefa da música aqui. Por exemplo:
O resultado retornado contém vários campos. O campo request é o request body ao iniciar a tarefa, enquanto o campo response é o response body retornado após a conclusão da tarefa. A introdução dos campos é a seguinte.
  • id, o ID da tarefa de geração desta música, usado para identificar exclusivamente esta tarefa de geração de música.
  • request, as informações da solicitação na consulta da tarefa de música.
  • response, as informações de retorno na consulta da tarefa de música.
  • created_at, hora de criação da tarefa, timestamp Unix (segundos, ponto flutuante).
  • started_at, hora de início da execução da tarefa, timestamp Unix (segundos, ponto flutuante).
  • finished_at, hora de conclusão da tarefa, timestamp Unix (segundos, ponto flutuante). Este campo não é retornado quando a tarefa não está 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 está concluída.

​
Operação de consulta em lote

Isto é para consultar os detalhes das tarefas de música com base em vários IDs de tarefa. A diferença em relação ao acima é que é necessário selecionar retrieve_batch para action. Request Body inclui:
  • ids: array de IDs de tarefa enviados.
  • action: método de operação da tarefa.
Configure conforme mostrado na imagem abaixo:

​
Exemplo de código

Pode-se observar que vários códigos em diferentes linguagens foram gerados automaticamente no lado direito da página, conforme mostrado na imagem:

Alguns exemplos de código são os seguintes:

​
Exemplo de resposta

Após o sucesso da solicitação, a API retornará informações detalhadas específicas de todas as tarefas de música em lote desta vez. Por exemplo:
O resultado retornado contém vários campos, entre os quais items inclui as informações detalhadas específicas das tarefas de músicas em lote. As informações específicas de cada tarefa de música são iguais aos campos acima, e as informações dos campos são as seguintes.
  • items, todas as informações detalhadas específicas das tarefas de músicas em lote. É um array, e cada elemento do array tem o mesmo formato de resultado retornado da consulta de uma única tarefa acima.
  • count, o número de tarefas de músicas consultadas em lote desta vez.

​
CURL

​
Python

​
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.

​
Exemplo de resposta de erro

​
Conclusão

Por meio deste documento, você já aprendeu como usar a Suno Tasks API para consultar todas as informações detalhadas específicas de tarefas de músicas individuais ou em lote. Esperamos que este documento possa ajudá-lo a integrar e usar melhor esta API. Se tiver alguma dúvida, entre em contato com nossa equipe de suporte técnico a qualquer momento.