---
title: "Utiliser Suno dans OpenClaw via RunAPI — Guide API Musique"
url: "https://runapi.ai/fr/openclaw-suno.md"
canonical: "https://runapi.ai/fr/openclaw-suno"
locale: "fr"
model: "suno"
---

# Utiliser Suno dans OpenClaw.

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. Les agents OpenClaw l'appellent avec la même RUNAPI_API_KEY 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 votre environnement. Si vous avez déjà configuré RunAPI dans OpenClaw pour le chat, la même clé fonctionne pour la génération musicale Suno — aucune configuration de fournisseur supplémentaire requise.
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.

### Quelle version de Suno dois-je utiliser ?

suno-v5.5 est la dernière version et produit la sortie de la plus haute qualité avec une meilleure clarté vocale et un meilleur mixage. suno-v4 et suno-v4.5 sont moins chers et plus rapides pour les itérations préliminaires. Toutes les versions utilisent le même endpoint text_to_music et les mêmes paramètres.

### Combien de temps prend la génération Suno ?

Le temps de génération varie selon la version et la durée de la chanson. La durée typique est de 30 secondes à 2 minutes. L'API retourne immédiatement un task_id — interrogez l'endpoint de statut ou définissez un callback_url pour éviter de bloquer votre agent.

### 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 contrôler le genre vocal et le poids du style ?

Oui. Définissez vocal_gender sur male ou female. Utilisez negative_tags pour exclure les styles indésirables. Pour un contrôle plus fin, créez un persona via l'endpoint generate_persona et passez le persona_id retourné avec persona_type défini sur voice ou style.


## Links

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