Suno Upload Referenzaudio API Integrationsanleitung

SUNO ermöglicht es uns, Referenzaudio für die sekundäre Kreation hochzuladen. Dieses Dokument erklärt die Integrationsmethoden der entsprechenden API. Der normale Upload benötigt nur audio_url, das ist eine öffentlich zugängliche Audio-CDN-Adresse. mode ist standardmäßig auf standard gesetzt, daher sind keine Änderungen an bestehenden Aufrufen erforderlich. Ein erfolgreicher normaler Upload verbraucht 0,06 Credits; bei einem fehlgeschlagenen Upload fallen keine Kosten an. Hier geben wir die audio_url als https://cdn.acedata.cloud/suno_demo.mp3 ein, die eine öffentlich zugängliche CDN-Adresse ist.

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"
}'

Das Ergebnis sieht wie folgt aus:

{
    "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
    }
}

Man kann sehen, dass das Feld audio_id in data die ID des nach dem Uploads erstellten Songs ist. Mit der Song-ID können wir die Suno Audios Generation API verwenden, um benutzerdefinierte Songs zu generieren. Wenn wir beispielsweise action mit upload_extend übergeben und gleichzeitig audio_id mit der zurückgegebenen Song-ID, können wir basierend auf dem Referenzaudio einen neuen Song generieren.

Verbesserter Upload-Modus

Wenn der normale Upload die Audioinhalte, die Sie besitzen oder für die Sie die Erlaubnis zur Nutzung haben, nicht verarbeiten kann, können Sie mode auf enhanced setzen. In diesem Modus muss auch ein name mit 1 bis 100 Zeichen bereitgestellt werden, und es muss eine öffentlich zugängliche HTTPS audio_url verwendet werden. Der verbesserte Upload erfolgt immer asynchron und benötigt normalerweise 2 Minuten oder länger. Ein erfolgreicher Prozess verbraucht 1,87 Credits; bei einem fehlgeschlagenen Prozess fallen keine Kosten an.

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"
  }'

Die Schnittstelle gibt sofort task_id und trace_id zurück. Verwenden Sie die Suno Tasks API, um den Status der Aufgabe abzufragen. Nach erfolgreicher Verarbeitung lesen Sie die hochgeladene Audio-ID aus response.data.audio_id. Sie können auch eine HTTPS callback_url bereitstellen, um den Endstatus zu empfangen. Die durch den verbesserten Upload erhaltene audio_id kann für Cover, Samples und Mashups verwendet werden. Begleitmusik und MIDI-Extraktion, vollständige Spurtrennung sowie Gesang/Begleitmusik-Trennung können weiterhin durch die Kontobeschränkungen des Audios eingeschränkt sein; nicht aufgeführte Operationen garantieren keine Unterstützung für die Nutzung über Konten hinweg. Je kürzer das Audio, desto höher ist in der Regel die Erfolgsquote der Verarbeitung.

Erste Schritte

KI Chat

KI Bild

KI Video

KI Audio

Web & Daten

CAPTCHA

Identität

Proxy

Erweitert

Coding

Suno Upload Referenzaudio API Integrationsanleitung

Verbesserter Upload-Modus

​Verbesserter Upload-Modus

Verbesserter Upload-Modus