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 は 1 秒あたりの拍数で、デフォルトは 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 を置き換えてください。

