POST https://api.acedata.cloud/suno/projects — це Beta-інтерфейс для керування багатодоріжковими проєктами. Створення, збереження, генерація кандидатів, підтвердження кандидатів та експорт розрізняються через action.
retrieve, кожна операція потребує Idempotency-Key. Той самий ключ із тим самим запитом лише повертає початковий результат; той самий ключ із іншим запитом повертає 409. Якщо платна генерація стикається з мережевим тайм-аутом або результат підтвердження є невизначеним, спочатку виконайте запит за початковим ID завдання або тим самим ключем ідемпотентності; не можна безпосередньо змінювати ключ і надсилати запит повторно.
Ідентифікатори та одиниці часу
start_seconds / end_seconds — це секунди у вихідному аудіо; start_beats / end_beats — це кількість ударів на часовій шкалі проєкту. state.timing.bps — це кількість ударів за секунду, за замовчуванням 2. Наприклад, для фрагмента тривалістю 41 секунду, що починається з удару 0, кінцева точка за замовчуванням — удар 82. Діапазон секунд generate_track використовується для визначення посилання для генерації та не гарантує, що кандидат матиме довжину лише цього діапазону.
Робочий процес операцій
Якщо виконується лише локальна заміна, достатньо наявного придатного вихідного аудіо, і спочатку не потрібно виконувати
render; якщо вихідне аудіо вже є в проєкті, також можна пропустити upload і add_track. render_audio_id є лише обов’язковим посиланням для generate_track.
Під час подання асинхронної операції спочатку повертається { "task_id": "...", "trace_id": "..." }, що не означає успішну генерацію. Опитування:
finished_at, а response.success у ньому дорівнює true; коли response.success=false, прочитайте response.error. Хоча save може містити task_id, він завершується синхронно в межах цього інтерфейсу. upload, render, generate_track, replace_section не змінюють версію проєкту; після успішного save, add_track, commit_candidate, remove_track слід отримати новий version_id.
Умови запитів
Наведені нижче приклади послідовно демонструють передачу ID і версій між операціями. Відповіді містять лише поля, пов’язані з поточним кроком; під час інтеграції замініть приклади ID значеннями відповідей поточного застосунку.

