POST https://api.acedata.cloud/suno/projects è l’interfaccia Beta per la gestione di progetti multi-traccia. Distingue tra creazione, salvataggio, generazione di candidati, invio di candidati ed esportazione tramite action.
retrieve, ogni operazione richiede Idempotency-Key. La stessa chiave con la stessa richiesta restituisce soltanto il risultato originale; la stessa chiave con richieste diverse restituisce 409. In caso di timeout di rete o risultato di invio incerto durante una generazione a pagamento, interrogare prima utilizzando l’ID dell’attività originale o la stessa chiave di idempotenza; non cambiare direttamente chiave e reinviare.
Identificatori e unità di tempo
start_seconds / end_seconds sono i secondi all’interno dell’audio sorgente; start_beats / end_beats sono i battiti sulla timeline del progetto. state.timing.bps indica i battiti al secondo, con valore predefinito 2. Ad esempio, un segmento di 41 secondi che inizia dal battito 0 termina per impostazione predefinita al battito 82. L’intervallo in secondi di generate_track è utilizzato per specificare il riferimento di generazione e non garantisce che il candidato abbia soltanto la durata di tale intervallo.
Flusso operativo
Se si esegue soltanto una sostituzione locale, è sufficiente disporre di audio sorgente utilizzabile e non è necessario eseguire prima
render; se l’audio sorgente è già nel progetto, è possibile saltare anche upload e add_track. render_audio_id è soltanto il riferimento obbligatorio di generate_track.
Al momento dell’invio di un’operazione asincrona viene restituito prima { "task_id": "...", "trace_id": "..." }, il che non indica che la generazione sia riuscita. Eseguire il polling:
finished_at e il relativo response.success è true; quando response.success=false, leggere response.error. Sebbene save possa contenere un task_id, viene completato in modo sincrono in questa interfaccia. upload, render, generate_track, replace_section non modificano la versione del progetto; dopo il successo di save, add_track, commit_candidate, remove_track è necessario ottenere il nuovo version_id.
Convenzioni delle richieste
Gli esempi seguenti mostrano in sequenza il passaggio di ID e versioni tra le operazioni. Le risposte elencano soltanto i campi rilevanti per il passaggio corrente; durante l’integrazione, sostituire gli ID di esempio con i valori di risposta dell’applicazione corrente.

