OPENCLAW + SUNO

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.

ein API-Key · Text-to-Music-Endpunkt · asynchrones Task-Polling
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"
}
Den curl-Befehl kopieren und testen suno
SO FUNKTIONIERT ES

Suno in OpenClaw in drei Schritten verwenden

1

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
2

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
3

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
PARAMETER

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.

FAQ

Suno + OpenClaw — Fragen

OpenClaw Grundeinrichtung

Noch nicht eingerichtet? Mit der RunAPI-Einrichtungsanleitung für OpenClaw starten.

OpenClaw Einrichtungsanleitung →

Suno Modellkatalog

Alle Suno-Versionen, Preise und verfügbare Endpunkte ansehen.

Suno on RunAPI →

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.