curl --request POST \
  --url https://api.evolink.ai/v1/audios/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno-v5-beta",
  "prompt": "A cheerful summer pop song about road trips and freedom"
}
'

{
  "created": 1766319090,
  "id": "task-unified-1766319089-oqs9cue4",
  "model": "suno-v5-beta",
  "object": "audio.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "audio",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 10,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: suno-v5-beta",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "No available channel for the requested model",
    "type": "api_error"
  }
}

Suno

Suno Generación de música Beta

Modelo de generación de música Suno AI, soporta la generación de música completa basada en descripciones de texto o letras
Soporta modo personalizado (control fino de estilo, título, letras) y modo simple (generación automática por IA)
Soporta la función Persona, permite reutilizar características vocales/de estilo ya creadas
Modo de procesamiento asíncrono, usa el ID de tarea devuelto para consultar el estado
Los enlaces de audio generados son válidos por 72 horas, guárdalos oportunamente
Cada solicitud genera múltiples variaciones de música

POST

audios

generations

curl --request POST \
  --url https://api.evolink.ai/v1/audios/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno-v5-beta",
  "prompt": "A cheerful summer pop song about road trips and freedom"
}
'

{
  "created": 1766319090,
  "id": "task-unified-1766319089-oqs9cue4",
  "model": "suno-v5-beta",
  "object": "audio.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "audio",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 10,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: suno-v5-beta",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "No available channel for the requested model",
    "type": "api_error"
  }
}

Autorizaciones

Authorization

string

header

requerido

##Todas las APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

requerido

Nombre del modelo

Compatibilidad hacia atrás: Los nombres de modelos previamente integrados (p.ej. suno-v5, suno-v4.5, suno-v4.5plus, suno-v4.5all, suno-v4) siguen siendo compatibles y se mapean automáticamente a las versiones -beta correspondientes

Opciones disponibles:

suno-v5.5-beta: V5.5 con modelos adaptados a tus preferencias, prompt máx. 5000 caracteres, estilo máx. 1000 caracteres; nombre de modelo compatible: suno-v5.5
suno-v5-beta: Última versión V5 (Recomendada), compatible con Voice Persona, expresión musical superior, generación más rápida, prompt máx. 5000 caracteres, estilo máx. 1000 caracteres
suno-v4.5plus-beta: Versión mejorada V4.5+, tonos más ricos, nuevos métodos creativos, hasta 8 minutos, prompt máx. 5000 caracteres, estilo máx. 1000 caracteres
suno-v4.5all-beta: Versión completa V4.5, prompts más inteligentes, generación más rápida, hasta 8 minutos, prompt máx. 5000 caracteres, estilo máx. 1000 caracteres
suno-v4.5-beta: Versión V4.5, prompts más inteligentes, generación más rápida, hasta 8 minutos, prompt máx. 5000 caracteres, estilo máx. 1000 caracteres
suno-v4-beta: Versión V4, calidad vocal mejorada, hasta 4 minutos, prompt máx. 3000 caracteres, estilo máx. 200 caracteres

Opciones disponibles:

suno-v5.5-beta,

suno-v5-beta,

suno-v4.5plus-beta,

suno-v4.5all-beta,

suno-v4.5-beta,

suno-v4-beta

Ejemplo:

"suno-v5-beta"

custom_mode

boolean

predeterminado:false

Habilitar modo personalizado

Descripción:

false: Modo simple, solo proporciona prompt, la IA genera automáticamente letras y estilo
true: Modo personalizado, permite control fino de style, title, letras, etc.

Parámetros requeridos en modo personalizado:

style: Requerido
title: Requerido
prompt: Requerido cuando instrumental=false (usado como letras)

En modo simple (custom_mode=false) solo se admite prompt: style, title, negative_tags, vocal_gender, style_weight, weirdness_constraint, audio_weight, persona_id, persona_model, duration no se admiten en este modo. La interfaz no garantiza que los rechace, pero estos parámetros no tienen ningún efecto sobre el resultado generado; si necesitas un control fino, usa custom_mode=true

Ejemplo:

false

instrumental

boolean

predeterminado:false

Generar música usando modelos de Suno AI, compatible con modos vocal e instrumental

Ejemplo:

false

prompt

string

Prompt que describe el contenido musical deseado

Modo no personalizado (custom_mode=false):

Requerido, sirve como descripción musical, la IA genera automáticamente letras y estilo
Longitud máx.: 500 caracteres

Modo personalizado (custom_mode=true):

Requerido cuando instrumental=false, se usa como letras exactas
Opcional cuando instrumental=true
Longitud máx.: 3000 caracteres para V4, 5000 caracteres para V4.5+

Sugerencias de formato de letras:

Use etiquetas como [Verse], [Chorus], [Bridge] para organizar la estructura de las letras

Ejemplo:

"A cheerful summer pop song about road trips and freedom"

style

string

Especificación de estilo musical

Descripción:

Requerido en modo personalizado (custom_mode=true)
Define el género, estado de ánimo o dirección artística de la música
Se recomienda usar etiquetas separadas por comas en inglés

Límites de caracteres:

V4: Máx. 200 caracteres
V4.5+: Máx. 1000 caracteres

Etiquetas de estilo comunes:

Géneros: pop, rock, jazz, classical, electronic, hip-hop, r&b, country, folk
Estados de ánimo: happy, sad, energetic, calm, romantic, dark, uplifting
Instrumentos: piano, guitar, drums, bass, violin, saxophone, synthesizer
Voces: male vocals, female vocals, choir, harmonies
Tempo: slow, fast, upbeat, groovy, 120bpm

No se admite en modo simple (custom_mode=false): en ese modo la IA genera el estilo automáticamente a partir de prompt, por lo que enviar este parámetro no surte efecto.

Ejemplo:

"pop, electronic, upbeat, female vocals"

title

string

Título de la canción

Descripción:

Requerido en modo personalizado (custom_mode=true)
Se mostrará en la interfaz del reproductor y el nombre del archivo
Longitud máxima: 80 caracteres

No se admite en modo simple (custom_mode=false): en ese modo la IA genera el título automáticamente, por lo que enviar este parámetro no surte efecto.

Maximum string length: 80

Ejemplo:

"Summer Dreams"

negative_tags

string

Estilos excluidos, especifica los estilos musicales o características que quieres evitar

Descripción:

Longitud máxima: 200 caracteres (igual para todos los modelos)

Ejemplos:

heavy metal, screaming, sad
rap, fast tempo

Solo se admite cuando custom_mode=true; en modo simple, enviarlo no surte efecto.

Maximum string length: 200

Ejemplo:

"heavy metal, screaming"

vocal_gender

enum<string>

Preferencia de género vocal

Opciones:

m: Voz masculina
f: Voz femenina

Nota:

Solo es efectivo cuando custom_mode=true
Este parámetro solo aumenta la probabilidad, no puede garantizar que se siga el género especificado
No se admite en modo simple (custom_mode=false); enviarlo no surte efecto

Opciones disponibles:

m,

f

Ejemplo:

"f"

style_weight

number

Peso del estilo, controla la adherencia al estilo especificado

Rango: 0.0 ~ 1.0, hasta dos decimales y múltiplo de 0.01

Descripción:

Los valores más altos aumentan la adherencia al estilo especificado
0 es un valor válido, indica que no se sigue el estilo especificado y se envía al modelo

Solo se admite cuando custom_mode=true; en modo simple, enviarlo no surte efecto.

Rango requerido: 0 <= x <= 1Debe ser un múltiplo de 0.01

Ejemplo:

0.7

weirdness_constraint

number

Restricción de rareza, controla el grado de creatividad/experimentación de la salida

Rango: 0.0 ~ 1.0, hasta dos decimales y múltiplo de 0.01

Descripción:

Los valores más altos producen una salida más creativa y experimental
Los valores más bajos producen una salida más tradicional y conservadora
0 es un valor válido y se envía al modelo

Solo se admite cuando custom_mode=true; en modo simple, enviarlo no surte efecto.

Rango requerido: 0 <= x <= 1Debe ser un múltiplo de 0.01

Ejemplo:

0.3

audio_weight

number

Peso del audio, controla el peso de las características del audio

Rango: 0.0 ~ 1.0, hasta dos decimales y múltiplo de 0.01

Descripción:

0 es un valor válido y se envía al modelo

Solo se admite cuando custom_mode=true; en modo simple, enviarlo no surte efecto.

Rango requerido: 0 <= x <= 1Debe ser un múltiplo de 0.01

Ejemplo:

0.5

persona_id

string

Persona ID, aplica el estilo de un Persona ya creado a esta generación de música

Solo disponible cuando custom_mode=true. Se obtiene a través de la interfaz Creación de Persona Suno, permite mantener características vocales y de estilo consistentes

Cómo obtenerlo: Una vez completada la tarea de creación de Persona, obtener de result_data.persona_id

No se admite en modo simple (custom_mode=false).

Solo es compatible con modelos de la familia V5 (suno-v5-beta / suno-v5.5-beta, incluidos sus nombres compatibles sin -beta); enviarlo con cualquier otro modelo devuelve un error de parámetros.

Ejemplo:

"5c57d49ef834110496fae5aa14fec441"

persona_model

enum<string>

Modo de aplicación del Persona

Opciones:

style_persona: Orientado al estilo, enfatiza el arreglo, el ritmo y el tono
voice_persona: Orientado a la voz, enfatiza el timbre, la técnica vocal y el registro

Ambos modos solo están disponibles con modelos de la familia V5 (suno-v5-beta / suno-v5.5-beta, incluidos sus nombres compatibles sin -beta) y requieren custom_mode=true. Deben usarse junto con persona_id: enviar persona_model por sí solo, sin persona_id, no surte efecto (persona_id puede usarse por sí solo).

Opciones disponibles:

style_persona,

voice_persona

Ejemplo:

"style_persona"

duration

integer

predeterminado:20

Duración de audio solicitada en segundos

Solo está disponible cuando el modelo es suno-v5.5-beta (o el nombre compatible suno-v5.5) y custom_mode=true. Debe ser un entero entre 10 y 360. Si se omite, el valor predeterminado del proveedor es 20 segundos. Otros modelos y el modo simple no lo admiten; enviarlo devuelve un error de parámetros.

Rango requerido: 10 <= x <= 360

Ejemplo:

120

callback_url

string<uri>

URL de callback HTTPS para el estado terminal de la tarea

Momento del callback:

GroAPI envía un único callback cuando la tarea alcanza un estado terminal: completed, failed o cancelled
No se reenvían etapas intermedias del proveedor como text y first
El cuerpo coincide con la estructura de detalle de GET /v1/tasks/{id}

Restricciones de seguridad:

Solo HTTPS
Se prohíben callbacks a direcciones IP internas
Longitud máxima de URL: 2048 caracteres

Mecanismo de callback:

Tiempo de espera por intento: 10 segundos
Hasta 3 reintentos tras fallar la solicitud inicial
Una respuesta 2xx se considera exitosa

Ejemplo:

"https://your-domain.com/webhooks/suno-callback"

Respuesta

Tarea de música creada exitosamente

created

integer

Marca de tiempo de creación de la tarea

Ejemplo:

1766319090

string

ID de tarea, utilizado para consultar el estado y los resultados de la tarea

Ejemplo:

"task-unified-1766319089-oqs9cue4"

model

string

Nombre del modelo real utilizado

Ejemplo:

"suno-v5-beta"

object

enum<string>

Tipo de tarea

Opciones disponibles:

audio.generation.task

progress

integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea

Opciones disponibles:

pending,

processing,

completed,

failed,

cancelled

Ejemplo:

"pending"

task_info

object

Detalles de la tarea de audio

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

audio

Ejemplo:

"audio"

usage

object

Información de uso y facturación

Show child attributes

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

Suno Generación de música Beta

Autorizaciones

Cuerpo

Respuesta