Skip to content

Descripción general ​

Documentación de la API Suno ​

Información básica ​

Endpoints de la API ​

  • Predeterminados:
    https://{BASE_URL}/suno/submit/music
    https://{BASE_URL}/suno/fetch

Compatibilidad de modelos ​

Modelos compatibles ​

  • chirp-v3-0 (versión v3.0)
  • chirp-v3-5 (versión v3.5)
  • chirp-v4 (versión v4.0)
  • chirp-auk (versión v4.5)
  • chirp-v5 (versión v5.0)

Notificaciones de callback ​

  • Compatible con URL de callback notify_hook
  • Requisitos:
    • Método: POST
    • Datos recibidos: estructura de datos de la tarea

Pasos de uso ​

1. Crear una tarea Suno ​

2. Consultar el progreso de la tarea ​

Estructuras de datos ​

Objeto Task ​

CampoTipoEjemploDescripción
task_idstringf4a94d75-087b-4bb1-bd45-53ba293faf96ID de la tarea
actionstringMUSICTipo de tarea: MUSIC (generar canción), LYRICS (generar letra)
statusstringSUCCESSEstado: NOT_START (no iniciada), SUBMITTED (enviada), QUEUED (en cola), IN_PROGRESS (en curso), FAILURE (fallida), SUCCESS (correcta)
submitTimenumber1689231405854Hora de envío
startTimenumber1689231442755Hora de inicio
finishTimenumber1689231544312Hora de finalización
failReasonstring[Invalid parameter] Invalid valueMotivo del fallo (si falla)
dataobject-Datos: música (array) o letra (objeto único)

Continuación musical ​

  • Es necesario pasar el parámetro task_id para especificar la tarea