action de la solicitud determina el tipo de operación. La clave principal del Project utiliza uniformemente id; version_id representa la versión actual del proyecto, y todas las operaciones de modificación y exportación deben enviar la versión más reciente para evitar sobrescrituras simultáneas.
Resumen de operaciones
Las operaciones asíncronas devuelven inmediatamente un
task_id. Utilice la interfaz gratuita /suno/tasks para realizar sondeo, o proporcione callback_url para recibir resultados finales.
Crear y leer
Idempotency-Key único. Tras una creación exitosa, el data.id de la respuesta es el ID del Project. Un nuevo proyecto vacío podría no tener version_id antes del primer guardado.
state completo. Se recomienda leer primero, luego modificar y guardar basándose en el valor devuelto; no construya manualmente desde cero las estructuras internas de ritmo y pistas.
Guardar el estado completo
version_id; después de que el primer guardado genere una versión, los guardados posteriores deben enviar el valor más reciente. Si la versión ya ha cambiado, la interfaz devuelve HTTP 409. En este caso, vuelva a realizar retrieve, fusione las modificaciones y envíe de nuevo con una nueva clave de idempotencia; no reintente ciegamente la solicitud anterior.
Cargar y añadir pistas
audio_id candidato. Luego añádalo al proyecto:
Generar y reemplazar
generate_track genera candidatos de pistas de audio para un intervalo del proyecto; replace_section devuelve dos candidatos de reemplazo local. Ninguna de las dos operaciones selecciona automáticamente el resultado artístico.
Exportar la canción completa
render_id, audio_id, audio_url y la duración. El proyecto está vinculado al entorno de ejecución en el que fue creado, y no puede migrarse entre entornos ni realizar una conmutación por error automática.
Solo puede cargar o procesar audio sobre el que tenga derechos legales de uso. La API de proyectos se encuentra actualmente en Beta; conserve las URL de audio finales de los resultados importantes.