Suno Generación de música Beta

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

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

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

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

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.

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.

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.

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

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.

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.

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.

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.

Modo de aplicación del Persona

Opciones:

1. style_persona: Orientado al estilo, enfatiza el arreglo, el ritmo y el tono
2. 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).

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.

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

Marca de tiempo de creación de la tarea

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

Nombre del modelo real utilizado

Tipo de tarea

Porcentaje de progreso de la tarea (0-100)

Estado de la tarea

Tipo de salida de la tarea