---
title: "Suno in OpenClaw via RunAPI verwenden — Musik-API-Anleitung"
url: "https://runapi.ai/de/openclaw-suno.md"
canonical: "https://runapi.ai/de/openclaw-suno"
locale: "de"
model: "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.

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

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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. |

## FAQ

### Was ist der Unterschied zwischen auto_lyrics, exact_lyrics und instrumental?

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.

### Welche Suno-Version sollte ich verwenden?

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.

### Wie lange dauert die Suno-Generierung?

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.

### Bietet RunAPI eine offizielle Suno-API?

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.

### Kann ich Stimmgeschlecht und Stilgewicht steuern?

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.


## Links

- [OpenClaw Einrichtungsanleitung →](https://runapi.ai/de/openclaw)
- [Suno on RunAPI →](https://runapi.ai/de/models/suno)
- [Model catalog](https://runapi.ai/de/models)
- [API docs](https://runapi.ai/de/docs)