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.5-beta : V5.5 avec des modèles adaptés à vos préférences, prompt max 5000 caractères, style max 1000 caractères ; nom de modèle compatible : suno-v5.5
• 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)

En mode simple (custom_mode=false), seul prompt est pris en charge : style, title, negative_tags, vocal_gender, style_weight, weirdness_constraint, audio_weight, persona_id, persona_model, duration ne sont pas pris en charge dans ce mode. L’API ne garantit pas de les rejeter, mais ces paramètres n’ont aucun effet sur le résultat généré — pour un contrôle précis, utilisez custom_mode=true

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

Non pris en charge en mode simple (custom_mode=false) : dans ce mode, le style est généré automatiquement par l’IA à partir du prompt, transmettre ce paramètre n’a donc aucun effet.

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

Non pris en charge en mode simple (custom_mode=false) : dans ce mode, le titre est généré automatiquement par l’IA, transmettre ce paramètre n’a donc aucun effet.

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

Description :

• Longueur maximale : 200 caractères (identique pour tous les modèles)

Exemples :

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

Pris en charge uniquement lorsque custom_mode=true ; en mode simple, sa transmission n’a aucun effet.

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é
• Non pris en charge en mode simple (custom_mode=false), sa transmission n’a aucun effet

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

Plage : 0.0 ~ 1.0, jusqu’à deux décimales et multiple de 0.01

Description :

• Des valeurs plus élevées renforcent le respect du style spécifié
• 0 est une valeur valide, signifie aucune adhérence au style spécifié et est transmis au modèle

Pris en charge uniquement lorsque custom_mode=true ; en mode simple, sa transmission n’a aucun effet.

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

Plage : 0.0 ~ 1.0, jusqu’à deux décimales et multiple de 0.01

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
• 0 est une valeur valide et est transmis au modèle

Pris en charge uniquement lorsque custom_mode=true ; en mode simple, sa transmission n’a aucun effet.

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

Plage : 0.0 ~ 1.0, jusqu’à deux décimales et multiple de 0.01

Description :

• 0 est une valeur valide et est transmis au modèle

Pris en charge uniquement lorsque custom_mode=true ; en mode simple, sa transmission n’a aucun effet.

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

Non pris en charge en mode simple (custom_mode=false).

Pris en charge uniquement par les modèles de la famille V5 (suno-v5-beta / suno-v5.5-beta, y compris leurs noms compatibles sans -beta) ; avec tout autre modèle, sa transmission renvoie une erreur de paramètre.

Mode d’application du Persona

Options :

1. style_persona : Orienté style, privilégie l’arrangement, le rythme et le timbre
2. voice_persona : Orienté voix, privilégie le timbre, la technique vocale et la tessiture

Les deux modes sont disponibles uniquement avec les modèles de la famille V5 (suno-v5-beta / suno-v5.5-beta, y compris leurs noms compatibles sans -beta) et nécessitent custom_mode=true. Ils doivent être utilisés avec persona_id : transmettre persona_model seul, sans persona_id, n’a aucun effet (persona_id peut être utilisé seul).

Durée audio demandée en secondes

Disponible uniquement avec le modèle suno-v5.5-beta (ou le nom compatible suno-v5.5) et custom_mode=true. La valeur doit être un entier de 10 à 360. Si elle est omise, la valeur par défaut en amont est de 20 secondes. Les autres modèles et le mode simple ne le prennent pas en charge ; sa transmission renvoie une erreur de paramètre.

URL de rappel HTTPS pour l’état terminal de la tâche

Moment du rappel :

• GroAPI envoie un seul rappel lorsque la tâche atteint un état terminal : completed, failed ou cancelled
• Les étapes intermédiaires en amont telles que text et first ne sont pas transmises
• Le corps du rappel correspond à la structure de détail renvoyée par GET /v1/tasks/{id}

Restrictions de sécurité :

• HTTPS uniquement
• Les rappels vers les adresses IP internes sont interdits
• URL limitée à 2048 caractères

Mécanisme de rappel :

• Délai par tentative : 10 secondes
• Jusqu’à 3 nouvelles tentatives après l’échec initial
• Une réponse 2xx est considérée comme réussie

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