POST https://api.acedata.cloud/suno/projects ist die Beta-Schnittstelle zur Verwaltung von Mehrspurprojekten. Über action werden Erstellen, Speichern, Generieren von Kandidaten, Übermitteln von Kandidaten und Exportieren unterschieden.
retrieve ist für jede Operation ein Idempotency-Key erforderlich. Derselbe Schlüssel und dieselbe Anfrage lesen nur das ursprüngliche Ergebnis zurück; derselbe Schlüssel mit einer anderen Anfrage gibt 409 zurück. Wenn bei kostenpflichtiger Generierung ein Netzwerk-Timeout auftritt oder das Übermittlungsergebnis ungewiss ist, fragen Sie zuerst mit der ursprünglichen Aufgaben-ID oder demselben Idempotenzschlüssel ab und senden Sie nicht direkt mit einem neuen Schlüssel erneut.
Kennungen und Zeiteinheiten
start_seconds / end_seconds sind Sekunden innerhalb des Quellaudios; start_beats / end_beats sind Schläge auf der Projekt-Zeitachse. state.timing.bps ist die Anzahl der Schläge pro Sekunde, standardmäßig 2. Beispielsweise beginnt ein 41-Sekunden-Clip bei Schlag 0, und sein Standardendpunkt ist Schlag 82. Der Sekundenbereich von generate_track dient zur Angabe der Generierungsreferenz und garantiert nicht, dass ein Kandidat nur die Länge dieses Bereichs hat.
Operationsablauf
Wenn nur eine lokale Ersetzung durchgeführt wird, genügt vorhandenes verwendbares Quellaudio, ein vorheriges
render ist nicht erforderlich; wenn sich das Quellaudio bereits im Projekt befindet, können upload und add_track ebenfalls übersprungen werden. render_audio_id ist nur die erforderliche Referenz für generate_track.
Bei der Übermittlung einer asynchronen Operation wird zuerst { "task_id": "...", "trace_id": "..." } zurückgegeben, was nicht bedeutet, dass die Generierung erfolgreich war. Abfrage:
finished_at enthält und darin response.success den Wert true hat; bei response.success=false lesen Sie response.error. Obwohl save möglicherweise eine task_id enthält, wird es innerhalb dieser Schnittstelle synchron abgeschlossen. upload, render, generate_track, replace_section ändern die Projektversion nicht; nach erfolgreichem save, add_track, commit_candidate, remove_track sollte die neue version_id übernommen werden.
Anfragerichtlinien
Die folgenden Beispiele zeigen zusammenhängend die Übergabe von IDs und Versionen zwischen den einzelnen Operationen. Die Antworten enthalten nur die für den aktuellen Schritt relevanten Felder; ersetzen Sie bei der Integration die Beispiel-IDs durch die Antwortwerte der aktuellen Anwendung.

