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 значениями ответов текущего приложения.

