OPENCLAW + 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.

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.

  - 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 OpenClaw en trois étapes

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.

export RUNAPI_API_KEY=runapi_xxx
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.

POST /api/v1/suno/text_to_music
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.

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 OpenClaw ?

Suno est une IA texte-vers-musique qui génère des chansons complètes -- voix, instruments et mixage -- à partir d'un prompt textuel ou de vos propres paroles. Il fonctionne comme un bloc-notes de composition musicale où vous décrivez le genre, l'humeur et le tempo, et recevez une piste complète en retour. Les agents OpenClaw l'appellent via RunAPI puisque Suno n'a pas d'API publique officielle, vous donnant un accès programmatique aux versions v4 à v5.5.

Cas d'utilisation de Suno

Musique de fond pour YouTube et les réseaux sociaux

Générer des pistes de fond originales pour des vidéos en décrivant l'humeur et le genre dans un prompt. Pas de frais de licence, pas de problèmes de redevances -- la piste est générée fraîchement pour votre contenu.

Entendre des paroles comme une chanson complète

Les paroliers peuvent coller leurs mots en mode exact_lyrics avec une description de style et les entendre interprétés comme une chanson complète, transformant des paroles écrites en démo de production avant d'aller en studio.

Jingles d'intro et d'outro de podcast

Créer de la musique instrumentale d'intro et d'outro adaptée au ton d'un podcast en spécifiant le genre, l'humeur et la durée. Générer plusieurs variations et choisir la meilleure.

FAQ

Questions sur Suno + OpenClaw

Configuration générale de OpenClaw

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

Guide de configuration OpenClaw →

Catalogue des modèles Suno

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

Suno sur RunAPI →

Essayez Suno dans OpenClaw dès aujourd'hui.

Obtenez une clé RunAPI gratuite, collez le prompt dans OpenClaw et générez des chansons complètes avec voix, instruments et mixage depuis une description textuelle.

Parcourir les modèles →