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를 대체하십시오.

