---
title: "Utiliser Suno dans Hermes Agent via RunAPI — Guide API Musique"
url: "https://runapi.ai/fr/hermes-suno.md"
canonical: "https://runapi.ai/fr/hermes-suno"
locale: "fr"
model: "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.

## API example

```bash
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"
  }'

```

### Response

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

```

## How it works

1. **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.
2. **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.
3. **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.

## Parameters

| Parameter | 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. |

## FAQ

### 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.


## Links

- [Guide de configuration Hermes Agent →](https://runapi.ai/fr/hermes-agent)
- [Suno sur RunAPI →](https://runapi.ai/fr/models/suno)
- [Model catalog](https://runapi.ai/fr/models)
- [API docs](https://runapi.ai/fr/docs)