Suno in OpenClaw verwenden.
Suno generiert vollständige Songs — Gesang, Instrumente und Abmischung — aus einem Textprompt oder exakten Texten. Versionen v4 bis v5.5 sind über RunAPI verfügbar, das API-Zugang bietet, da Suno keine offizielle öffentliche API hat. OpenClaw-Agenten rufen es mit demselben RUNAPI_API_KEY wie für Chat auf.
RunAPI verwenden, um einen Song mit Suno zu generieren.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Call POST https://runapi.ai/api/v1/suno/text_to_music
- Set model to "suno-v5.5".
- Set vocal_mode to "auto_lyrics" for AI-generated lyrics from a prompt.
- Set prompt to describe the song you want.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the audio URL from the response output.
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"
}
Suno in OpenClaw in drei Schritten verwenden
RunAPI konfigurieren
RUNAPI_API_KEY in der Umgebung setzen. Wenn RunAPI bereits in OpenClaw für Chat konfiguriert ist, funktioniert derselbe Key für die Suno-Musikgenerierung — keine zusätzliche Provider-Einrichtung nötig.
export RUNAPI_API_KEY=runapi_xxx
text_to_music aufrufen
Einen POST an den text_to_music-Endpunkt mit dem Modell und vocal_mode senden. auto_lyrics mit einem Prompt für KI-geschriebene Texte verwenden, exact_lyrics mit lyrics/style/title für eigene Wörter oder instrumental mit style/title für keinen Gesang.
POST /api/v1/suno/text_to_music
Ergebnis abrufen
Der Endpunkt gibt sofort eine task_id zurück. Die Song-Generierung dauert je nach Version 30 Sekunden bis mehrere Minuten. Den Task-Status-Endpunkt abfragen, bis der Status completed ist, dann die Audio-URL auslesen.
GET /api/v1/suno/text_to_music/tsk_abc123
Suno text_to_music API-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
model |
string |
Erforderlich. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 oder suno-v5.5. |
vocal_mode |
string |
Erforderlich. auto_lyrics (KI schreibt Texte aus Prompt), exact_lyrics (man gibt Texte/Stil/Titel an) oder instrumental (kein Gesang, Stil/Titel erforderlich). |
prompt |
string |
Song-Kurzbeschreibung für auto_lyrics-Modus. Genre, Stimmung, Tempo und Thema beschreiben. In exact_lyrics- und instrumental-Modi verboten. |
lyrics |
string |
Exakte Songtexte zum Singen. Erforderlich für exact_lyrics-Modus. In auto_lyrics- und instrumental-Modi verboten. |
style |
string |
Musikstilbeschreibung, z. B. lo-fi hip hop, 80er Synthwave. Erforderlich für exact_lyrics- und instrumental-Modi. |
title |
string |
Songtitel. Erforderlich für exact_lyrics- und instrumental-Modi. |
vocal_gender |
string |
Optional. male oder female. |
negative_tags |
string |
Optional. Zu vermeidende Stile, z. B. heavy metal, screaming. |
duration_seconds |
integer |
Optional. Zieldauer in Sekunden. |
persona_id |
string |
Optional. Persona-ID für benutzerdefinierte Stimm- oder Stilprofile. |
persona_type |
string |
Optional. style oder voice. Wählt die Persona-Kategorie. |
callback_url |
string |
Optional. Webhook-URL, die einen POST erhält, wenn der Task abgeschlossen ist. |
Was ist Suno auf OpenClaw?
Suno ist eine Text-zu-Musik-KI, die vollständige Songs – Gesang, Instrumente und Mixing – aus einem Textprompt oder eigenen Songtexten generiert. Es funktioniert als Songwriting-Sketchpad, bei dem man Genre, Stimmung und Tempo beschreibt und einen vollständigen Track zurückerhält. OpenClaw-Agenten rufen es über RunAPI auf, da Suno keine offizielle öffentliche API hat, und erhalten programmatischen Zugriff auf die Versionen v4 bis v5.5.
Suno Anwendungsfälle
Hintergrundmusik für YouTube und Social Media
Originale Hintergrundtracks für Videos generieren, indem Stimmung und Genre in einem Prompt beschrieben werden. Keine Lizenzgebühren, keine Royalty-Probleme – der Track wird frisch für den eigenen Content generiert.
Songtexte als vollständigen Song hören
Texter können ihre Wörter mit einer Stilbeschreibung in den exact_lyrics-Modus einfügen und sie als vollständigen Song vorgetragen hören, was geschriebene Songtexte in ein Produktionsdemo verwandelt, bevor Studiozeit gebucht wird.
Podcast-Intros und -Outros
Instrumentale Intro- und Outro-Musik erstellen, die zum Ton eines Podcasts passt, indem Genre, Stimmung und Dauer angegeben werden. Mehrere Varianten generieren und die beste Passform auswählen.
Suno + OpenClaw — Fragen
auto_lyrics generiert Texte aus dem Prompt — man beschreibt den Song und Suno schreibt die Wörter. exact_lyrics verwendet die bereitgestellten Texte wörtlich und benötigt style- und title-Felder. instrumental erstellt einen Track ohne Gesang, nur mit style und title.
suno-v5.5 ist die neueste und produziert die höchste Qualität mit besserer Gesangsklarheit und Abmischung. suno-v4 und suno-v4.5 sind günstiger und schneller für Entwurfsiterationen. Alle Versionen verwenden denselben text_to_music-Endpunkt und dieselben Parameter.
Die Generierungszeit variiert je nach Version und Songlänge. Typische Bearbeitungszeit ist 30 Sekunden bis 2 Minuten. Die API gibt sofort eine task_id zurück — den Status-Endpunkt abfragen oder callback_url setzen, um den Agenten nicht zu blockieren.
Suno bietet keine öffentliche API. RunAPI bietet programmatischen Zugang zu Suno v4 bis v5.5 über denselben API-Key und Task-Lebenszyklus wie alle anderen RunAPI-Modelle. Kein Suno-Konto oder separate Zugangsdaten nötig.
Ja. vocal_gender auf male oder female setzen. negative_tags verwenden, um unerwünschte Stile auszuschließen. Für feinere Kontrolle eine Persona über den generate_persona-Endpunkt erstellen und die zurückgegebene persona_id mit persona_type voice oder style übergeben.
OpenClaw Grundeinrichtung
Noch nicht eingerichtet? Mit der RunAPI-Einrichtungsanleitung für OpenClaw starten.
OpenClaw Einrichtungsanleitung →Suno in OpenClaw noch heute ausprobieren.
Einen kostenlosen RunAPI-Key holen, den Prompt in OpenClaw einfügen und vollständige Songs mit Gesang, Instrumenten und Abmischung aus einer Textbeschreibung generieren.