Suno Music Generation Beta

Nom du modèle

Compatibilité ascendante : Les noms de modèles précédemment intégrés (ex: suno-v5, suno-v4.5, suno-v4.5plus, suno-v4.5all, suno-v4) restent utilisables et sont automatiquement mappés vers les versions -beta correspondantes

Options disponibles :

• suno-v5-beta : Dernière version V5 (recommandée par défaut), prend en charge Voice Persona, expression musicale supérieure, génération plus rapide, prompt max 5000 caractères, style max 1000 caractères
• suno-v4.5plus-beta : Version améliorée V4.5+, tonalités plus riches, nouvelles méthodes créatives, jusqu'à 8 minutes, prompt max 5000 caractères, style max 1000 caractères
• suno-v4.5all-beta : Version complète V4.5, prompts plus intelligents, génération plus rapide, jusqu'à 8 minutes, prompt max 5000 caractères, style max 1000 caractères
• suno-v4.5-beta : Version V4.5, prompts plus intelligents, génération plus rapide, jusqu'à 8 minutes, prompt max 5000 caractères, style max 1000 caractères
• suno-v4-beta : Version V4, qualité vocale améliorée, jusqu'à 4 minutes, prompt max 3000 caractères, style max 200 caractères

Activer le mode personnalisé

Description :

• false : Mode simple, fournissez uniquement le prompt, l'IA génère automatiquement les paroles et le style
• true : Mode personnalisé, permet un contrôle précis du style, du title, des paroles, etc.

Paramètres requis en mode personnalisé :

• style : Requis
• title : Requis
• prompt : Requis lorsque instrumental=false (utilisé comme paroles)

Générer de la musique instrumentale (sans voix)

Description :

• false : Générer de la musique avec voix
• true : Générer de la musique instrumentale/d'ambiance sans voix

Remarque :

• En mode non personnalisé, ce paramètre n'affecte pas les champs requis
• En mode personnalisé, lorsqu'il est défini sur true, le prompt devient optionnel

Prompt décrivant le contenu musical souhaité

Mode non personnalisé (custom_mode=false) :

• Requis, sert de description musicale, l'IA génère automatiquement les paroles et le style
• Longueur maximale : 500 caractères

Mode personnalisé (custom_mode=true) :

• Requis lorsque instrumental=false, utilisé comme paroles exactes
• Optionnel lorsque instrumental=true
• Longueur maximale : 3000 caractères pour V4, 5000 caractères pour V4.5+

Suggestions de format des paroles :

• Utilisez des balises comme [Verse], [Chorus], [Bridge] pour organiser la structure des paroles

Spécification du style musical

Description :

• Requis en mode personnalisé (custom_mode=true)
• Définit le genre, l'ambiance ou la direction artistique de la musique
• Il est recommandé d'utiliser des balises séparées par des virgules en anglais

Limites de caractères :

• V4 : Max 200 caractères
• V4.5+ : Max 1000 caractères

Balises de style courantes :

• Genres : pop, rock, jazz, classical, electronic, hip-hop, r&b, country, folk
• Ambiances : happy, sad, energetic, calm, romantic, dark, uplifting
• Instruments : piano, guitar, drums, bass, violin, saxophone, synthesizer
• Voix : male vocals, female vocals, choir, harmonies
• Tempo : slow, fast, upbeat, groovy, 120bpm

Titre de la chanson

Description :

• Requis en mode personnalisé (custom_mode=true)
• Sera affiché dans l'interface du lecteur et le nom du fichier
• Longueur maximale : 80 caractères

Styles exclus, spécifiez les styles musicaux ou caractéristiques à éviter

Exemples :

• heavy metal, screaming, sad
• rap, fast tempo

Préférence de genre vocal

Options :

• m : Voix masculine
• f : Voix féminine

Remarque :

• Effectif uniquement lorsque custom_mode=true
• Ce paramètre augmente seulement la probabilité, il ne peut pas garantir que le genre spécifié sera respecté

Poids du style, contrôle le respect du style spécifié

Plage : 0.0 ~ 1.0, une décimale

Description :

• Des valeurs plus élevées entraînent un respect plus strict du style spécifié
• La valeur 0 est considérée comme non définie

Contrainte d'originalité, contrôle le degré de créativité/expérimentation de la sortie

Plage : 0.0 ~ 1.0, une décimale

Description :

• Des valeurs plus élevées produisent une sortie plus créative et expérimentale
• Des valeurs plus basses produisent une sortie plus traditionnelle et conservatrice
• La valeur 0 est considérée comme non définie

Poids audio, contrôle le poids des caractéristiques audio

Plage : 0.0 ~ 1.0, une décimale

Description :

• La valeur 0 est considérée comme non définie

Persona ID, applique un Persona précédemment créé à cette génération musicale

Disponible uniquement lorsque custom_mode=true. Obtenu via l'API Création de Persona Suno, permet de maintenir des caractéristiques vocales et stylistiques cohérentes

Comment l'obtenir : Après l'achèvement de la tâche de création de Persona, récupérez-le depuis result_data.persona_id

Mode d'application du Persona

Options :

1. style_persona : Orienté style, privilégie les caractéristiques de style musical (arrangement, rythme, timbre), compatible avec toutes les versions de modèles
2. voice_persona : Orienté voix, privilégie les caractéristiques vocales (timbre, technique vocale, tessiture), uniquement V5

Disponible uniquement lorsque custom_mode=true, généralement utilisé avec persona_id. L'utilisation de voice_persona nécessite le modèle suno-v5-beta, sinon une erreur est retournée

URL de rappel HTTPS pour la notification d'achèvement de tâche

Étapes du rappel :

• Le processus de rappel comporte trois étapes : text (génération de texte), first (première piste terminée), complete (tout terminé)
• Dans certains cas, les étapes text et first peuvent être ignorées, renvoyant directement complete

Restrictions de sécurité :

• Seul le protocole HTTPS est pris en charge
• Les rappels vers les adresses IP internes sont interdits
• La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de rappel :

• Délai d'expiration : 10 secondes
• Maximum 3 tentatives en cas d'échec
• Un code de statut 2xx renvoyé par l'URL de rappel est considéré comme un succès

Horodatage de création de la tâche

ID de tâche, utilisé pour interroger le statut et les résultats de la tâche

Nom du modèle réellement utilisé

Type de tâche

Pourcentage de progression de la tâche (0-100)

Statut de la tâche

Type de sortie de la tâche