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

Campo	Tipo	Ejemplo	Descripción
task_id	string	f4a94d75-087b-4bb1-bd45-53ba293faf96	ID de la tarea
action	string	MUSIC	Tipo de tarea: MUSIC (generar canción), LYRICS (generar letra)
status	string	SUCCESS	Estado: NOT_START (no iniciada), SUBMITTED (enviada), QUEUED (en cola), IN_PROGRESS (en curso), FAILURE (fallida), SUCCESS (correcta)
submitTime	number	1689231405854	Hora de envío
startTime	number	1689231442755	Hora de inicio
finishTime	number	1689231544312	Hora de finalización
failReason	string	[Invalid parameter] Invalid value	Motivo del fallo (si falla)
data	object	-	Datos: música (array) o letra (objeto único)

Continuación musical

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