Suno Upload Reference Audio API Integration Instructions

SUNO permite que carreguemos áudio de referência para recriação. Este documento explica como integrar as APIs relacionadas. O upload normal requer apenas audio_url, que é um endereço de CDN de áudio acessível publicamente. O mode é padrão como standard, portanto, chamadas existentes não precisam ser modificadas. O upload normal bem-sucedido consome 0,06 Créditos; falhas no upload não geram custos. Aqui, o audio_url que inserimos é https://cdn.acedata.cloud/suno_demo.mp3, que é um endereço de CDN acessível publicamente.

curl -X POST 'https://api.acedata.cloud/suno/upload' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "https://cdn.acedata.cloud/suno_demo.mp3"
}'

O resultado é o seguinte:

{
  "success": true,
  "task_id": "058f8450-3df4-4f8b-8b64-ebc2e59ed3bc",
  "data": {
    "audio_id": "00135f7d-cda1-4d70-b007-779f07143586",
    "lyric": "[Intro]\nHa-ha-ha-ha-ha-ha\n[Verse 1]\nCandy skies are dripping blue\nStuck in world of chewed up glue\nThe sun's a lollipop melting slow\nDripped in sugar on the ground below\nOh-oh\n[Chorus]\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nCandy chaos in disguise\n[Verse 2]\nJellybean mountains crumble fast\nRainbows made of soda blast\nEvery step's a gummy bear trap\nMy sugar rush is taking a nap\nOh-oh\n[Bridge]\nChew it up (ha-ha-ha-ha)\nSpit it out (ha-ha-ha-ha)\nRound and round (ha-ha-ha-ha)\nWithout a doubt (ha-ha-ha-ha)\n[Chorus]\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\n[Outro]\nCotton candy clouds collapse\nChocolate rivers running laps\nEverywhere's a sugar flood\nMy shoes are drowning caramel\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise",
    "style": "Upbeat bubblegum pop track with a high-energy electronic production style. The song features a bright, processed female vocal with a youthful and energetic tone, often layered with harmonies and occasional pitch-shifted ad-libs. The instrumentation is dominated by bouncy, staccato synthesizer chords, a driving four-on-the-floor electronic drum beat with crisp claps on the backbeat, and a prominent, melodic bassline. The tempo is approximately 128 BPM in a major key, utilizing a standard pop chord progression of I-V-vi-IV. Production elements include heavy use of sidechain compression, vocal chops, and shimmering sound effects that contribute to a sugary, hyper-pop aesthetic. The structure follows a verse-chorus-verse-chorus-bridge-chorus format with a high-energy build-up leading into the explosive, hook-driven choruses.",
    "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-001",
    "image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-002",
    "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
    "title": "up-d6c3970d-6db1-41e3-b966-90539c93678a",
    "duration": 131.16
  }
}

Pode-se ver que o campo audio_id de data é o ID da música após o upload. Com o ID da música, podemos usar a Suno Audios Generation API para gerar músicas personalizadas, por exemplo, passando action como upload_extend e audio_id como o ID da música retornado, podemos gerar uma nova música com base no áudio de referência.

Modo de Upload Aprimorado

Quando o upload normal não pode processar o áudio que você possui ou tem autorização para usar, você pode definir mode como enhanced. Este modo também deve fornecer um name de 1 a 100 caracteres e usar um audio_url HTTPS acessível publicamente. O upload aprimorado é sempre processado de forma assíncrona, geralmente levando 2 minutos ou mais. O processamento bem-sucedido consome 1,87 Créditos; falhas no processamento não geram custos.

curl -X POST 'https://api.acedata.cloud/suno/upload' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "audio_url": "https://cdn.acedata.cloud/suno_demo.mp3",
    "mode": "enhanced",
    "name": "My Song"
  }'

A interface retornará imediatamente task_id e trace_id. Use a Suno Tasks API para consultar a tarefa, e após o sucesso, leia o ID do áudio carregado de response.data.audio_id. Você também pode fornecer um callback_url HTTPS para receber o estado final. O audio_id obtido com o upload aprimorado pode ser usado para Cover, Samples e Mashup. A extração de acompanhamento e MIDI, separação de faixas completas e separação de voz/acompanhamento ainda podem estar sujeitas a restrições da conta à qual o áudio pertence; operações não listadas não garantem suporte para uso entre contas. Quanto mais curto o áudio, maior a taxa de sucesso do processamento.

Primeiros passos

Chat AI

Imagem AI

Vídeo AI

Áudio AI

Web e Dados

CAPTCHA

Identidade

Proxy

Avançado

Coding

Suno Upload Reference Audio API Integration Instructions

Modo de Upload Aprimorado

​Modo de Upload Aprimorado

Modo de Upload Aprimorado