Saltar para o conteúdo principal

​
Introdução

Suno é um serviço de áudio AI fornecido pela Ace Data Cloud, para geração de música AI Suno. Através da API unificada da Ace Data Cloud, você pode usar cURL para chamar rapidamente o Suno e realizar funções como geração de música a partir de texto, letras personalizadas, continuação de músicas, covers, separação de voz e geração de letras.

​
Pré-requisitos

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

​
Uso Básico

O endpoint principal para chamar a API Suno é: 
POST https://api.acedata.cloud/suno/audios
Este exemplo usa o modelo chirp-v5.
Modelos disponíveis incluem: chirp-v5, v4-5-plus, v4-5, v4, v3-5. Exemplo completo do comando cURL: 
curl -X POST https://api.acedata.cloud/suno/audios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "A cheerful pop song about summer vacation", "model": "chirp-v5", "custom": false}'
Substitua YOUR_API_TOKEN pelo token real obtido na plataforma Ace Data Cloud.

​
Exemplo de Resposta

Após uma chamada bem-sucedida, retorna dados 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/suno/audios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "A cheerful pop song about summer vacation", "model": "chirp-v5", "custom": false}' | jq .

​
Tratamento de Erros

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

​
Próximos Passos