POST https://api.acedata.cloud/suno/projects es la interfaz Beta para gestionar proyectos multipista. Se distinguen la creación, guardado, generación de candidatos, envío de candidatos y exportación mediante action.
retrieve, cada operación requiere Idempotency-Key. La misma clave y la misma solicitud solo vuelven a leer el resultado original; la misma clave con solicitudes diferentes devuelve 409. Cuando una generación con coste encuentra un tiempo de espera de red o el resultado del envío es incierto, primero consulte usando el ID de tarea original o la misma clave de idempotencia; no cambie directamente la clave para reenviar.
Identificadores y unidades de tiempo
start_seconds / end_seconds son segundos dentro del audio fuente; start_beats / end_beats son pulsos en la línea de tiempo del proyecto. state.timing.bps es el número de pulsos por segundo, con un valor predeterminado de 2. Por ejemplo, un fragmento de 41 segundos que comienza en el pulso 0 tiene como punto final predeterminado el pulso 82. El intervalo en segundos de generate_track se usa para especificar la referencia de generación y no garantiza que el candidato tenga solo la duración de dicho intervalo.
Flujo de operaciones
Si solo se realiza un reemplazo local, basta con tener audio fuente disponible y no es necesario ejecutar primero
render; si el audio fuente ya está en el proyecto, también se pueden omitir upload y add_track. render_audio_id es solo una referencia obligatoria para generate_track.
Al enviar una operación asíncrona, primero se devuelve { "task_id": "...", "trace_id": "..." }, lo cual no indica que la generación haya tenido éxito. Sondeo:
finished_at y su response.success es true; cuando response.success=false, lea response.error. Aunque save puede incluir task_id, se completa de forma síncrona dentro de esta interfaz. upload, render, generate_track y replace_section no modifican la versión del proyecto; tras el éxito de save, add_track, commit_candidate y remove_track, se debe obtener el nuevo version_id.
Convenciones de solicitud
Los siguientes ejemplos muestran de forma encadenada la transmisión de ID y versiones entre las operaciones. Las respuestas solo enumeran los campos relacionados con el paso actual; durante la integración, sustituya los ID de ejemplo por los valores de respuesta de la aplicación actual.

