Quelle est la différence entre auto_lyrics, exact_lyrics et instrumental ?

auto_lyrics génère les paroles depuis votre prompt — vous décrivez la chanson et Suno écrit les mots. exact_lyrics utilise les paroles que vous fournissez mot pour mot, et nécessite les champs style et title. instrumental produit un morceau sans voix, utilisant uniquement style et title.

Comment configurer RunAPI comme fournisseur personnalisé dans Hermes Agent pour Suno ?

Ajoutez un fournisseur custom:runapi dans la configuration Hermes Agent avec base_url défini sur https://runapi.ai/v1 et api_key lisant depuis RUNAPI_API_KEY. Le même fournisseur gère le chat, les images, les vidéos et les endpoints musicaux — aucune configuration séparée pour Suno.

RunAPI fournit-il une API Suno officielle ?

Suno ne propose pas d'API publique. RunAPI fournit un accès programmatique à Suno v4 à v5.5 via la même clé API et le même cycle de vie de tâches que tous les autres modèles RunAPI. Aucun compte Suno ni identifiants séparés requis.

Puis-je générer des pistes instrumentales sans voix ?

Oui. Définissez vocal_mode sur instrumental et fournissez les champs style et title. Les champs prompt et lyrics doivent être omis en mode instrumental. L'API applique ces règles de champs croisés et retourne une erreur de validation si des champs conflictuels sont envoyés.

Quels autres endpoints Suno sont disponibles au-delà de text_to_music ?

RunAPI expose cover_audio (restyliser un morceau existant), extend_music (continuer une chanson depuis un horodatage), create_mashup (combiner des éléments de plusieurs pistes), text_to_sound (effets sonores) et des endpoints utilitaires comme generate_lyrics, generate_persona et separate_audio_stems. Tous partagent la même clé API et le même cycle de vie de tâches.

HERMES + SUNO

Utiliser Suno dans Hermes Agent.

Suno génère des chansons complètes — voix, instruments et mixage — depuis un prompt textuel ou des paroles exactes. Les versions v4 à v5.5 sont disponibles via RunAPI, qui fournit un accès API puisque Suno n'a pas d'API publique officielle. Hermes Agent l'appelle via le fournisseur custom:runapi avec la même clé API utilisée pour le chat.

Obtenir une API Key Lire la documentation

une seule clé API · endpoint text-to-music · polling de tâche asynchrone

Utilisez RunAPI pour générer une chanson avec Suno.


  Exigences :

  - Lire la clé API depuis RUNAPI_API_KEY.

  - Utiliser le fournisseur custom:runapi avec base_url https://runapi.ai/v1.

  - Appeler POST https://runapi.ai/api/v1/suno/text_to_music

  - Définir le modèle sur "suno-v5.5".

  - Définir vocal_mode sur "auto_lyrics" pour des paroles générées par l'IA depuis un prompt.

  - Définir le prompt pour décrire la chanson souhaitée.

  - La tâche est asynchrone. Interroger le task_id retourné jusqu'à ce que le statut soit "completed".

  - Une fois terminé, lire l'URL audio depuis la réponse.

curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5.5",
    "vocal_mode": "auto_lyrics",
    "prompt": "An upbeat indie pop track about coding late at night, warm synths and acoustic guitar",
    "vocal_gender": "female"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "suno-v5.5"
}

Copiez la commande curl pour tester suno

FONCTIONNEMENT

Utiliser Suno dans Hermes Agent en trois étapes

Configurer RunAPI

Définissez RUNAPI_API_KEY dans l'environnement où Hermes Agent s'exécute. Si vous avez déjà ajouté RunAPI comme fournisseur custom:runapi, la même clé et base_url gèrent les requêtes musicales Suno.

export RUNAPI_API_KEY=runapi_xxx

Appeler text_to_music

Envoyez un POST à l'endpoint text_to_music avec le modèle et vocal_mode. Utilisez auto_lyrics avec un prompt pour des paroles écrites par l'IA, exact_lyrics avec paroles/style/titre pour vos propres mots, ou instrumental avec style/titre pour un morceau sans voix.

POST /api/v1/suno/text_to_music

Obtenir le résultat

L'endpoint retourne immédiatement un task_id. La génération de chanson prend de 30 secondes à plusieurs minutes selon la version. Interrogez l'endpoint de statut de tâche jusqu'à ce que le statut soit completed, puis lisez l'URL audio de sortie.

GET /api/v1/suno/text_to_music/tsk_abc123

PARAMÈTRES

Paramètres API text_to_music de Suno

Paramètre	Type	Description
`model`	`string`	Requis. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 ou suno-v5.5.
`vocal_mode`	`string`	Requis. auto_lyrics (l'IA écrit les paroles depuis un prompt), exact_lyrics (vous fournissez paroles/style/titre) ou instrumental (sans voix, nécessite style/titre).
`prompt`	`string`	Brief de chanson pour le mode auto_lyrics. Décrivez le genre, l'ambiance, le tempo et le sujet. Interdit en modes exact_lyrics et instrumental.
`lyrics`	`string`	Paroles exactes à chanter. Requis en mode exact_lyrics. Interdit en modes auto_lyrics et instrumental.
`style`	`string`	Description du style musical, ex. lo-fi hip hop, 80s synthwave. Requis pour les modes exact_lyrics et instrumental.
`title`	`string`	Titre de la chanson. Requis pour les modes exact_lyrics et instrumental.
`vocal_gender`	`string`	Optionnel. male ou female.
`negative_tags`	`string`	Optionnel. Styles à éviter, ex. heavy metal, screaming.
`duration_seconds`	`integer`	Optionnel. Durée cible en secondes.
`persona_id`	`string`	Optionnel. ID de persona pour des profils vocaux ou de style personnalisés.
`persona_type`	`string`	Optionnel. style ou voice. Sélectionne la catégorie de persona.
`callback_url`	`string`	Optionnel. URL webhook qui reçoit un POST lorsque la tâche se termine.

Qu'est-ce que Suno sur Hermes Agent ?

Suno est un générateur texte-vers-musique qui produit des chansons complètes avec voix, instruments et mixage à partir d'une description textuelle ou de vos propres paroles. Hermes Agent l'appelle via le fournisseur custom:runapi, ce qui est utile pour les workflows de contenu multi-étapes -- générer une vidéo avec Kling, puis créer une bande originale assortie avec Suno, le tout en une seule exécution d'agent. Les versions v4 à v5.5 sont disponibles puisque Suno n'a pas d'API publique officielle.

Cas d'utilisation de Suno

Bloc-notes de composition avant la production en studio

Décrire un concept de chanson -- genre, humeur, tempo, sujet -- et recevoir une piste démo complète en retour. Itérer rapidement sur les idées avant de s'engager en studio, en entendant comment différents styles et arrangements sonnent.

Reprises IA dans de nouveaux styles

Prendre une piste existante et la restyliser via l'endpoint cover_audio. Changer le genre, échanger l'instrumentation ou changer l'humeur tout en conservant la mélodie et la structure de base.

Pipelines de contenu audiovisuel complets

Enchaîner Suno avec des modèles vidéo dans un workflow Hermes Agent -- générer des séquences vidéo, puis créer une bande originale assortie, produisant du contenu prêt à publier sans licence musicale séparée.

FAQ

Questions sur Suno + Hermes Agent

Configuration générale de Hermes Agent

Pas encore configuré ? Commencez par le guide de configuration RunAPI pour Hermes Agent.

Guide de configuration Hermes Agent →

Catalogue des modèles Suno

Voir toutes les versions Suno, la tarification et les endpoints disponibles.

Suno sur RunAPI →

Essayez Suno dans Hermes Agent dès aujourd'hui.

Obtenez une clé RunAPI gratuite, configurez le fournisseur custom:runapi et générez des chansons complètes avec voix, instruments et mixage depuis une description textuelle.

Parcourir les modèles →