POST https://api.acedata.cloud/suno/projects to interfejs Beta do zarządzania projektami wielościeżkowymi. Za pomocą action rozróżnia się tworzenie, zapisywanie, generowanie kandydatów, zatwierdzanie kandydatów i eksportowanie.
retrieve, każda operacja wymaga Idempotency-Key. Ten sam klucz i to samo żądanie jedynie zwracają ponownie pierwotny wynik; ten sam klucz z innym żądaniem zwraca 409. Gdy płatne generowanie napotka przekroczenie limitu czasu sieci lub wynik zatwierdzenia jest niepewny, najpierw użyj pierwotnego ID zadania lub tego samego klucza idempotencji do zapytania, nie można bezpośrednio zmienić klucza i wysłać ponownie.
Identyfikatory i jednostki czasu
start_seconds / end_seconds to liczba sekund w źródłowym audio; start_beats / end_beats to liczba beatów na osi czasu projektu. state.timing.bps to liczba beatów na sekundę, domyślnie 2. Na przykład fragment o długości 41 sekund, zaczynający się od beatu 0, ma domyślny punkt końcowy na beacie 82. Zakres sekund generate_track służy do określenia referencji generowania i nie gwarantuje, że kandydat będzie miał długość tylko tego zakresu.
Przepływ operacji
Jeśli wykonywane jest tylko częściowe zastąpienie, wystarczy istniejące dostępne źródłowe audio i nie trzeba najpierw używać
render; jeśli źródłowe audio jest już w projekcie, można również pominąć upload i add_track. render_audio_id jest jedynie obowiązkową referencją dla generate_track.
Podczas przesyłania operacji asynchronicznej najpierw zwracane jest { "task_id": "...", "trace_id": "..." }, co nie oznacza pomyślnego wygenerowania. Odpytywanie:
finished_at, a zawarte w nim response.success ma wartość true, uznaje się je za sukces; gdy response.success=false, odczytaj response.error. Chociaż save może zawierać task_id, w tym interfejsie jest wykonywane synchronicznie. upload, render, generate_track, replace_section nie modyfikują wersji projektu; po pomyślnym save, add_track, commit_candidate, remove_track należy pobrać nowe version_id.
Konwencje żądań
Poniższe przykłady w łańcuchu pokazują przekazywanie ID i wersji między poszczególnymi operacjami. Odpowiedzi zawierają tylko pola związane z bieżącym krokiem; podczas integracji zastąp przykładowe ID wartościami odpowiedzi bieżącej aplikacji.

