Créer une tâche de génération musicale
Interface de soumission pour la génération musicale, compatible avec l’ancien chemin /suno/submit/music. Renvoie un ID de tâche, puis l’état peut être consulté via /suno/fetch/{task_id}.
Interface de soumission de tâche de génération musicale. Le chemin reste /suno/submit/music ; le moteur de génération peut être sélectionné via upstream_model, music_model, engine, model_id ou modelId. L’interface de création renvoie task_id, puis /suno/fetch/{task_id} permet de consulter la sortie.
Mode de description par prompt
Convient lorsque vous décrivez uniquement le style, l’ambiance, la langue, le type de voix et le contexte ; le modèle génère automatiquement le contenu de la chanson.
{
"model": "suno_music",
"upstream_model": "suno-v5",
"prompt": "Imitating "Billie Jean," create a DJ song with the theme of "the artificial intelligence revolution."",
"make_instrumental": false
}
Musique légère ou instrumental pur
Vous pouvez utiliser light_music=true ou make_instrumental=true. light_music indique une tendance musique légère/musique d’ambiance, et make_instrumental indique de ne pas générer de voix chantée.
{
"model": "suno_music",
"upstream_model": "minimax-music-v2.6",
"prompt": "Warm cafe background music with soft piano and strings, relaxing and cinematic.",
"light_music": true,
"make_instrumental": true
}
Mode avancé des paroles
Convient lorsque l’équipe métier a déjà préparé les paroles et doit spécifier un titre ainsi que des balises de style. Vous pouvez transmettre custom_mode=true ; pour le champ des paroles, utilisez lyrics, lyric, custom_lyrics ou customLyrics.
{
"model": "suno_music",
"upstream_model": "mureka-v9",
"custom_mode": true,
"title": "Summer Sea Breeze",
"tags": "electro pop, female vocal, bright summer",
"lyrics": "[Verse]\nSea breeze moves across the white sand\n[Chorus]\nTurn the summer into a beam of light"
}
Consultation
Après la création réussie, enregistrez l’ID de tâche data renvoyé, par exemple task_xxx, puis appelez GET /suno/fetch/{task_id} pour consulter le statut, l’URL audio, la couverture, le titre, les paroles et les informations de segments bruts renvoyées en amont.
Autorisations
Utilisez l'authentification Bearer Token.
Format : Authorization: Bearer sk-xxxxxx
Corps
Transmettez固定 suno_music.
suno_music "suno_music"
En mode de description par prompt, il s’agit du style musical, de l’humeur et du contexte ; en mode avancé pour les paroles, ce champ peut être utilisé comme champ compatible avec les paroles.
Génère la valeur de sélection du moteur.
"suno-v5"
Alias de compatibilité de upstream_model.
Alias de compatibilité de upstream_model.
Champ de compatibilité pour l'ID du modèle en amont.
Champ de compatibilité camelCase de model_id.
Champ compatible avec les instructions du mode descriptif.
Générer uniquement l’accompagnement.
Générer dans une orientation musique légère/musique de fond.
Générer en orientant vers de la musique pure.
Utiliser le mode personnalisé ou non.
Champ de compatibilité camelCase de custom_mode.
Titre de la chanson.
Balises de style, par exemple electro pop, female vocal.
Champ compatible avec le style.
Champ de compatibilité des styles musicaux.
Champ de compatibilité des styles musicaux.
Contenu des paroles.
lyrics alias compatible.
lyrics alias compatible.
lyrics alias compatible.
