Przejdź do głównej treści
SUNO umożliwia przesyłanie referencyjnego audio do dalszej twórczości, ten dokument wyjaśnia metody integracji powiązanego API. Zwykłe przesyłanie wymaga jedynie audio_url, czyli publicznie dostępnego adresu audio CDN. mode domyślnie ma wartość standard, dlatego istniejące wywołania nie wymagają modyfikacji. Pomyślne zwykłe przesłanie zużywa 0.06 Credits; nieudane przesłanie nie wiąże się z opłatą. Wprowadzony tutaj audio_url to https://cdn.acedata.cloud/suno_demo.mp3, czyli publicznie dostępny adres CDN.
Wynik jest następujący:
Jak widać, data zawsze jest obiektem, a audio_id jest ID utworu po przesłaniu. Wyniki analizy, takie jak lyric, style, duration, tytuł i media URL, są polami opcjonalnymi, a szczegóły zależą od zwróconej treści. Po uzyskaniu ID utworu można za pomocą Suno Audios Generation API wywoływać operacje wymagające audio_id, takie jak upload_extend, upload_cover lub próbkowanie zakresu. Aby korzystać z funkcji tworzenia na podstawie inspiracji Inspo i tworzyć nową muzykę na podstawie od 1 do 4 pełnych referencyjnych nagrań audio, należy bezpośrednio wywołać action=inspo i przekazać listę oryginalnych publicznych adresów URL audio; usługa automatycznie zakończy przesyłanie i analizę, bez potrzeby składania metadanych audio po stronie klienta.

Tryb rozszerzonego przesyłania

audio_url jest adresem wejściowym i zostanie bezpośrednio przekazany do procesu przetwarzania audio; nie zostanie wcześniej zapisany przez usługę trwałego przechowywania mediów końcowych. Upewnij się, że jest publicznie dostępny w czasie przetwarzania zadania.
Gdy zwykłe przesyłanie nie może przetworzyć audio, którego jesteś właścicielem lub masz upoważnienie do używania, możesz ustawić mode na enhanced. Ten tryb musi również zawierać name o długości od 1 do 100 znaków i korzystać z publicznie dostępnego HTTPS audio_url. Rozszerzone przesyłanie zawsze korzysta z przetwarzania asynchronicznego i zazwyczaj wymaga 2 minut lub więcej. Pomyślne przetwarzanie zużywa 1.87 Credits; nieudane przetwarzanie nie wiąże się z opłatą.
Interfejs natychmiast zwróci task_id i trace_id. Użyj Suno Tasks API, aby sprawdzić zadanie, a po pomyślnym zakończeniu odczytaj ID przesłanego audio z response.data.audio_id. Można również podać HTTPS callback_url, aby otrzymać stan końcowy. audio_id uzyskany z rozszerzonego przesyłania może być używany dla Cover, Samples i Mashup. Ekstrakcja podkładu i MIDI, separacja wszystkich ścieżek oraz separacja wokalu/podkładu mogą nadal podlegać ograniczeniom konta, do którego należy audio; dla niewymienionych operacji nie gwarantuje się obsługi między kontami. Im krótsze audio, tym zazwyczaj wyższy wskaźnik powodzenia przetwarzania.