---
title: "Gebruik Suno in OpenClaw via RunAPI — Muziek API-gids"
url: "https://runapi.ai/nl/openclaw-suno.md"
canonical: "https://runapi.ai/nl/openclaw-suno"
locale: "nl"
model: "suno"
---

# Gebruik Suno in OpenClaw.

Suno genereert volledige nummers — zang, instrumenten en mixing — vanuit een tekstprompt of exacte songteksten. Versies v4 tot en met v5.5 zijn beschikbaar via RunAPI, dat API-toegang biedt aangezien Suno geen officiële openbare API heeft. OpenClaw-agents roepen het aan met dezelfde RUNAPI_API_KEY die voor chat wordt gebruikt.

## 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. **Configureer RunAPI** — Stel RUNAPI_API_KEY in als omgevingsvariabele. Als je RunAPI al in OpenClaw hebt geconfigureerd voor chat, werkt dezelfde sleutel voor Suno-muziekgeneratie — geen extra providerconfiguratie nodig.
2. **Roep text_to_music aan** — Stuur een POST naar het text_to_music-endpoint met het model en vocal_mode. Gebruik auto_lyrics met een prompt voor door AI geschreven songteksten, exact_lyrics met lyrics/style/title voor je eigen woorden, of instrumental met style/title voor een track zonder zang.
3. **Poll voor het resultaat** — Het endpoint retourneert direct een task_id. Nummergeneratie duurt 30 seconden tot enkele minuten afhankelijk van de versie. Poll het taakstatusendpoint totdat de status voltooid is en lees vervolgens de uitvoer-audio-URL.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Verplicht. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 of suno-v5.5. |
| `vocal_mode` | `string` | Verplicht. auto_lyrics (AI schrijft songteksten vanuit prompt), exact_lyrics (je levert songteksten/stijl/titel aan) of instrumental (geen zang, vereist stijl/titel). |
| `prompt` | `string` | Nummerbeschrijving voor auto_lyrics-modus. Beschrijf genre, stemming, tempo en onderwerp. Verboden in exact_lyrics- en instrumental-modi. |
| `lyrics` | `string` | Exacte songteksten om te zingen. Verplicht voor exact_lyrics-modus. Verboden in auto_lyrics- en instrumental-modi. |
| `style` | `string` | Muziekstijlbeschrijving, bijv. lo-fi hip hop, 80s synthwave. Verplicht voor exact_lyrics- en instrumental-modi. |
| `title` | `string` | Nummertitel. Verplicht voor exact_lyrics- en instrumental-modi. |
| `vocal_gender` | `string` | Optioneel. male of female. |
| `negative_tags` | `string` | Optioneel. Stijlen om te vermijden, bijv. heavy metal, screaming. |
| `duration_seconds` | `integer` | Optioneel. Doelduur in seconden. |
| `persona_id` | `string` | Optioneel. Persona-ID voor aangepaste stem- of stijlprofielen. |
| `persona_type` | `string` | Optioneel. style of voice. Selecteert de personacategorie. |
| `callback_url` | `string` | Optioneel. Webhook-URL die een POST ontvangt wanneer de taak is voltooid. |

## FAQ

### Wat is het verschil tussen auto_lyrics, exact_lyrics en instrumental?

auto_lyrics genereert songteksten vanuit je prompt — je beschrijft het nummer en Suno schrijft de woorden. exact_lyrics gebruikt de tekst die je aanlevert letterlijk en vereist de velden style en title. instrumental produceert een track zonder zang, met alleen style en title.

### Welke Suno-versie moet ik gebruiken?

suno-v5.5 is de nieuwste versie en produceert de hoogste kwaliteit met betere vocale helderheid en mixing. suno-v4 en suno-v4.5 zijn goedkoper en sneller voor conceptiteraties. Alle versies gebruiken hetzelfde text_to_music-endpoint en dezelfde parameters.

### Hoe lang duurt Suno-generatie?

Generatietijd varieert per versie en nummerlengte. Typische doorlooptijd is 30 seconden tot 2 minuten. De API retourneert direct een task_id — poll het statusendpoint of stel een callback_url in om je agent niet te blokkeren.

### Biedt RunAPI een officiële Suno-API?

Suno biedt geen openbare API aan. RunAPI biedt programmatische toegang tot Suno v4 tot en met v5.5 via dezelfde API-sleutel en taaklevenscyclus die voor alle andere RunAPI-modellen worden gebruikt. Geen Suno-account of aparte inloggegevens nodig.

### Kan ik het stemgeslacht en de stijlweging aansturen?

Ja. Stel vocal_gender in op male of female. Gebruik negative_tags om ongewenste stijlen uit te sluiten. Maak voor meer controle een persona aan via het generate_persona-endpoint en geef de geretourneerde persona_id mee met persona_type ingesteld op voice of style.


## Links

- [OpenClaw-configuratiegids →](https://runapi.ai/nl/openclaw)
- [Suno op RunAPI →](https://runapi.ai/nl/models/suno)
- [Model catalog](https://runapi.ai/nl/models)
- [API docs](https://runapi.ai/nl/docs)