Créer une tâche de génération de musique ou de son

Interface de soumission pour la génération de musique et de sons, compatible avec l’ancien chemin /suno/submit/music. Renvoie l’ID de tâche, puis permet de consulter le résultat via /suno/fetch/{task_id}.

Interface de soumission des tâches de génération de musique et de sons. Le chemin reste /suno/submit/music ; vous pouvez en pratique choisir le moteur de génération via upstream_model, music_model, engine, model_id ou modelId. L’interface de création renvoie task_id, puis /suno/fetch/{task_id} sert à interroger la sortie.

Si upstream_model n’est pas transmis (ou si seul {"model":"suno_music"} est transmis), Suno v5.5 est utilisé par défaut. Pour continuer à utiliser l’ancienne version de Suno, transmettez explicitement "upstream_model":"suno-v5".

Nouveaux modèles

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.5",
  "prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
  "make_instrumental": false
}

Génération de son

MiniMax Speech peut surcharger les paramètres vocaux via extraParams (ou des champs de niveau supérieur homonymes en snake_case/camelCase).

{
  "model": "suno_music",
  "upstream_model": "minimax-speech-2.8-hd",
  "prompt": "欢迎使用新版语音生成服务。",
  "extraParams": {
    "voice": "moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85",
    "outputFormat": "mp3",
    "sampleRate": 32000,
    "speed": 1,
    "volume": 1,
    "pitch": 0
  }
}

Lorsque aucun paramètre vocal n’est transmis pour MiniMax Speech, le serveur envoie par défaut les valeurs voice, outputFormat=mp3, sampleRate=32000, speed=1, volume=1 et pitch=0 de l’exemple ci-dessus.

Lyria 3 Pro utilise upstream_model=lyria-3-pro (ou lyria-3-pro-preview) :

{
  "model": "suno_music",
  "upstream_model": "lyria-3-pro",
  "prompt": "Cinematic orchestral music with a hopeful finale."
}

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.