Suno · Audio & Musique

Hermes Agent x Suno

Suno est une plateforme de génération musicale IA qui crée des chansons originales — voix, instruments et paroles — depuis des descriptions texte. Via RunAPI, toutes les versions Suno partagent une seule clé API avec une facturation par appel.

9 variants à partir de $0.01 / appel Usage commercial pris en charge
Obtenir une clé API Voir la documentation de Hermes Agent

Prerequisite: npx runapi mcp install

Prompt

Modèles de prompt

Utilisez suno-v4 lorsqu'il correspond à la tâche : Cohérence et plage de fréquences améliorées, limite 4 min.

You have access to RunAPI task tools for Suno.

Available Suno models:
- suno-v4: Cohérence et plage de fréquences améliorées, limite 4 min
  endpoints: /api/v1/suno/stitch_audio, /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/add_samples, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5: Première génération 8 min, 25 % moins d'erreurs de genre, 40 % meilleurs vocaux
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/create_mashup, /api/v1/suno/extend_music, /api/v1/suno/add_samples, /api/v1/suno/stitch_audio, /api/v1/suno/inspire_music, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-all: Tous les styles et modes v4.5 déverrouillés sans abonnement
  endpoints: /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-plus: Niveau de qualité amélioré dans l'architecture v4.5
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/remaster_audio, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5: Audio qualité CD, jusqu'à 8 min par génération
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/add_instrumental, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5.5: Jusqu'à 8 min par génération, clonage vocal et entraînement de style
  endpoints: /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6: suno-v6
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-mini: suno-v6-mini
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-wild: suno-v6-wild
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type

Use the model ID and endpoint that match the user's request.
Example prompt: Composez un beat lo-fi chill avec un piano doux, du craquement de vinyle et une ligne de basse légère, 2 minutes.
/api/v1/suno/stitch_audio: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/stitch_audio et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/stitch_audio/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.
/api/v1/suno/extend_music: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/extend_music et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/extend_music/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.
/api/v1/suno/create_mashup: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/create_mashup et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/create_mashup/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.
/api/v1/suno/add_samples: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/add_samples et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/add_samples/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.
/api/v1/suno/cover_audio: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/cover_audio et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/cover_audio/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.
/api/v1/suno/inspire_music: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/inspire_music et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/inspire_music/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.
/api/v1/suno/text_to_music: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/text_to_music et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/text_to_music/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.
/api/v1/suno/remaster_audio: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/remaster_audio et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/remaster_audio/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.
/api/v1/suno/add_instrumental: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/add_instrumental et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/add_instrumental/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.
/api/v1/suno/add_vocals: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/add_vocals et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/add_vocals/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.
/api/v1/suno/text_to_sound: Submit the task, poll for its status, then verify the completed output. Envoyez POST à /api/v1/suno/text_to_sound et conservez l’ID de la Task renvoyée.
Envoyez GET à /api/v1/suno/text_to_sound/<task-id> jusqu’à ce que le statut soit completed ou failed.
Vérifiez que la réponse completed contient la sortie propre à l’endpoint documentée dans la référence API.

Versions et endpoints publics

Suno V6 est désormais disponible. Les requêtes utilisant d'anciens ID de modèle (v3.5–v5.5) sont automatiquement redirigées vers V6 ou V6 Mini. Les tarifs restent inchangés.
ID du modèle Endpoints Prix de départ Catalogue
suno-v4
/api/v1/suno/stitch_audio /api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/add_samples /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/remaster_audio
$0.01 / appel Détail du modèle
suno-v4.5
/api/v1/suno/remaster_audio /api/v1/suno/create_mashup /api/v1/suno/extend_music /api/v1/suno/add_samples /api/v1/suno/stitch_audio /api/v1/suno/inspire_music /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.01 / appel Détail du modèle
suno-v4.5-all
/api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.12 / appel Détail du modèle
suno-v4.5-plus
/api/v1/suno/cover_audio /api/v1/suno/remaster_audio /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/add_vocals
$0.01 / appel Détail du modèle
suno-v5
/api/v1/suno/remaster_audio /api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/add_instrumental /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/add_vocals
$0.01 / appel Détail du modèle
suno-v5.5
/api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/remaster_audio
$0.01 / appel Détail du modèle
suno-v6
/api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/extend_music
$0.12 / appel Détail du modèle
suno-v6-mini
/api/v1/suno/cover_audio /api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / appel Détail du modèle
suno-v6-wild
/api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / appel Détail du modèle

Vérification

Interrogez jusqu’à ce que la tâche atteigne un état final

Sélectionnez <model-id> pour générer les commandes de vérification.

Configuration

Endpoint du guide: <endpoint>

Sélectionnez <model-id> pour générer une requête conforme au contrat d’entrée public de l’endpoint.

Opérations supplémentaires

Ces opérations n’utilisent pas d’ID de modèle.

  • /api/v1/suno/get_timestamped_lyrics
  • /api/v1/suno/separate_audio_stems
  • /api/v1/suno/generate_artwork
  • /api/v1/suno/generate_persona
  • /api/v1/suno/generate_midi
  • /api/v1/suno/regenerate_validation_phrase
  • /api/v1/suno/generate_voice
  • /api/v1/suno/boost_style
  • /api/v1/suno/check_voice
  • /api/v1/suno/voice_to_validation_phrase
  • /api/v1/suno/convert_audio
  • /api/v1/suno/visualize_music
  • /api/v1/suno/generate_lyrics
  • /api/v1/suno/blend_lyrics
  • /api/v1/suno/replace_section
Fonctionnement

Démarrer en 3 étapes

  1. Choisir un ID de modèle

    Sélectionnez un ID public du catalogue et consultez son endpoint et son prix de départ actuel.

  2. Configurer RunAPI

    Définissez RUNAPI_API_KEY avant d’envoyer la requête à l’endpoint.

  3. Vérifier le résultat

    Pour les endpoints asynchrones, interrogez le même endpoint jusqu’à ce que la Task atteigne un état final.

Ce que vous pouvez créer avec Hermes Agent + Suno

  • Carnet d'écriture pour chansons

    Décrivez une idée de chanson avec genre, ambiance, tempo et thème, et recevez une maquette à retravailler avant la production en studio.

  • Reprises dans de nouveaux styles

    Restylisez un morceau existant en changeant son genre, son instrumentation ou son ambiance tout en conservant la mélodie et la structure.

  • Pipelines audiovisuels complets

    Enchaînez Suno avec des modèles vidéo dans un workflow Hermes Agent pour créer des images et une bande-son originale assortie.

Pourquoi utiliser Suno avec RunAPI + Hermes Agent

  • 9 variantes, une clé API

    Utilisez une seule connexion RunAPI pour choisir parmi les variantes de modèle disponibles sans modifier votre intégration.

  • Des tarifs d'utilisation clairs

    Consultez les tarifs actuels du catalogue avant d'envoyer une requête, sans abonnement ni dépense minimale.

  • Flux de tâches automatiques

    Envoyez, interrogez et récupérez les résultats asynchrones avec un flux de tâches uniforme, sans code d'interrogation manuel.

Questions sur Hermes Agent + Suno

Comment configurer Suno dans Hermes Agent ?

Utilisez le même fournisseur RunAPI que pour le chat. Il couvre les endpoints de chat, d'image, de vidéo et de musique, donc Suno ne nécessite aucune configuration séparée.

Puis-je générer des morceaux instrumentaux sans voix ?

Oui. Suno prend en charge la génération instrumentale. Les paramètres de requête sur cette page indiquent les champs applicables au mode instrumental, et l'API renvoie une erreur de validation si des champs contradictoires sont envoyés.

Hermes Agent peut-il enchaîner Suno avec des modèles vidéo ?

Oui. Hermes Agent peut générer une vidéo avec un modèle vidéo, puis créer une bande-son assortie avec Suno dans le même workflow.

Quel ID de modèle utiliser ?

Choisissez un ID public dans le tableau des versions. Chaque ID expose les endpoints affichés sur sa ligne.

Ce guide configure-t-il un modèle de chat ?

Non. Cette ligne de modèles utilise le parcours d’endpoint présenté ici et n’est pas décrite comme un modèle de chat de l’agent.

Commencer à utiliser Suno avec Hermes Agent

Obtenir une clé API Lire le guide de démarrage rapide

Vous construisez avec une équipe ?

Nous vous aidons pour la mise en place entreprise, les intégrations et les questions techniques.

Nous contacter