Zum Hauptinhalt springen
SUNO ermöglicht es uns, Referenzaudio für die Weiterverarbeitung hochzuladen. Dieses Dokument erläutert die Integrationsmethode für die entsprechende API. Für einen normalen Upload wird nur audio_url benötigt. Dies ist eine öffentlich zugängliche Audio-CDN-Adresse. mode ist standardmäßig standard, daher müssen bestehende Aufrufe nicht geändert werden. Ein erfolgreicher normaler Upload verbraucht 0.06 Credits; bei einem fehlgeschlagenen Upload fallen keine Kosten an. Hier ist die von uns eingegebene audio_url https://cdn.acedata.cloud/suno_demo.mp3, eine öffentlich zugängliche CDN-Adresse.
Das Ergebnis lautet wie folgt:
Wie zu sehen ist, ist data immer ein Objekt, und audio_id ist die Song-ID nach dem Upload. Analyseergebnisse wie lyric, style, duration, Titel und Medien-URLs sind optionale Felder; maßgeblich ist der konkret zurückgegebene Inhalt. Nachdem Sie die Song-ID erhalten haben, können Sie über die Suno Audios Generation API Vorgänge aufrufen, die audio_id benötigen, wie upload_extend, upload_cover oder Bereichs-Sampling. Wenn Sie über die Inspo-Inspirationsfunktion neue Musik auf Grundlage von 1 bis 4 vollständigen Referenzaudios erstellen möchten, rufen Sie direkt action=inspo auf und übergeben Sie die Liste der ursprünglichen öffentlichen Audio-URLs; der Dienst führt Upload und Analyse automatisch durch, ohne dass der Client Audio-Metadaten zusammenstellen muss.

Erweiterter Upload-Modus

audio_url ist die Eingabeadresse und wird direkt an den Audioverarbeitungsprozess übergeben; sie wird nicht vorab vom Dienst zur dauerhaften Speicherung von finalen Medien übertragen. Stellen Sie sicher, dass sie während der Aufgabenverarbeitung öffentlich zugänglich ist.
Wenn ein normaler Upload Audio nicht verarbeiten kann, das Ihnen gehört oder für dessen Nutzung Sie autorisiert sind, können Sie mode auf enhanced setzen. Dieser Modus muss außerdem einen name mit 1 bis 100 Zeichen bereitstellen und eine öffentlich zugängliche HTTPS-audio_url verwenden. Der erweiterte Upload verwendet fest asynchrone Verarbeitung und benötigt in der Regel 2 Minuten oder länger. Eine erfolgreiche Verarbeitung verbraucht 1.87 Credits; bei einer fehlgeschlagenen Verarbeitung fallen keine Kosten an.
Die Schnittstelle gibt sofort task_id und trace_id zurück. Verwenden Sie die Suno Tasks API, um die Aufgabe abzufragen, und lesen Sie nach Erfolg die ID des hochgeladenen Audios aus response.data.audio_id. Sie können auch eine HTTPS-callback_url bereitstellen, um den Endstatus zu empfangen. Die durch den erweiterten Upload erhaltene audio_id kann für Cover, Samples und Mashup verwendet werden. Die Extraktion von Instrumentalspuren und MIDI, die Trennung aller Spuren sowie die Trennung von Gesang/Instrumentalspuren können weiterhin durch das Konto eingeschränkt sein, dem das Audio gehört; für nicht aufgeführte Vorgänge wird die kontenübergreifende Nutzung nicht garantiert. Je kürzer das Audio ist, desto höher ist in der Regel die Erfolgsrate der Verarbeitung.