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-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)

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

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

Expira en

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

Peso del estilo, controla la adherencia al estilo especificado

Rango: 0.0 ~ 1.0, un decimal

Descripción:

• Valores más altos resultan en mayor adherencia al estilo especificado
• Un valor de 0 se trata como no establecido

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

Rango: 0.0 ~ 1.0, un decimal

Descripción:

• Valores más altos resultan en una salida más creativa y experimental
• Valores más bajos resultan en una salida más tradicional y conservadora
• Un valor de 0 se trata como no establecido

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

Rango: 0.0 ~ 1.0, un decimal

Descripción:

• El valor 0 se trata como no establecido

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

Modo de aplicación del Persona

Opciones:

1. style_persona: Orientado al estilo, enfatiza las características del estilo musical (arreglo, ritmo, tono), compatible con todas las versiones del modelo
2. voice_persona: Orientado a la voz, enfatiza las características vocales (timbre, técnica vocal, registro), solo compatible con V5

Solo disponible cuando custom_mode=true, generalmente se usa junto con persona_id. Al usar voice_persona el modelo debe ser suno-v5-beta, de lo contrario se devuelve un error

URL de callback HTTPS para notificación de finalización de tarea

Etapas del callback:

• El proceso de callback tiene tres etapas: text (generación de texto), first (primera pista completada), complete (todo completado)
• En algunos casos, las etapas text y first pueden omitirse, devolviendo complete directamente

Restricciones de seguridad:

• Solo se admite el protocolo HTTPS
• Los callbacks a direcciones IP de red interna están prohibidos
• La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

• Tiempo de espera: 10 segundos
• Máximo 3 reintentos en caso de fallo
• La URL de callback que devuelve un código de estado 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