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

# Gebruik Suno in Hermes Agent.

Suno genereert volledige nummers — vocalen, instrumenten en mixing — vanuit een tekstprompt of exacte songtekst. Versies v4 tot en met v5.5 zijn beschikbaar via RunAPI, dat API-toegang biedt aangezien Suno geen officiële openbare API heeft. Hermes Agent roept het aan via de custom:runapi-provider met dezelfde API-sleutel 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 waar Hermes Agent draait. Als je RunAPI al als custom:runapi-provider hebt toegevoegd, verwerken dezelfde sleutel en base_url Suno-muziekverzoeken.
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 songtekst, exact_lyrics met lyrics/style/title voor je eigen woorden, of instrumental met style/title voor geen vocalen.
3. **Haal het resultaat op** — Het endpoint retourneert onmiddellijk een task_id. Nummersgeneratie duurt 30 seconden tot enkele minuten afhankelijk van de versie. Poll het taakstatusendpoint totdat de status voltooid is, lees dan 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 songtekst op basis van prompt), exact_lyrics (je levert songtekst/stijl/titel aan) of instrumental (geen vocalen, vereist stijl/titel). |
| `prompt` | `string` | Nummerbriefing voor auto_lyrics-modus. Beschrijf genre, stemming, tempo en onderwerp. Niet toegestaan in exact_lyrics- en instrumentale modus. |
| `lyrics` | `string` | Exacte songtekst om te zingen. Verplicht voor exact_lyrics-modus. Niet toegestaan in auto_lyrics- en instrumentale modus. |
| `style` | `string` | Muziekstijlbeschrijving, bijv. lo-fi hip hop, 80s synthwave. Verplicht voor exact_lyrics- en instrumentale modus. |
| `title` | `string` | Songtitel. Verplicht voor exact_lyrics- en instrumentale modus. |
| `vocal_gender` | `string` | Optioneel. male of female. |
| `negative_tags` | `string` | Optioneel. Te vermijden stijlen, bijv. heavy metal, screaming. |
| `duration_seconds` | `integer` | Optioneel. Gewenste duur 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 voltooid is. |

## FAQ

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

auto_lyrics genereert songteksten op basis van je prompt — je beschrijft het nummer en Suno schrijft de woorden. exact_lyrics gebruikt de songtekst die je zelf aanlevert, en vereist style- en title-velden. instrumental produceert een track zonder vocalen, met alleen style en title.

### Hoe configureer ik RunAPI als aangepaste provider in Hermes Agent voor Suno?

Voeg een custom:runapi-provider toe in de Hermes Agent-configuratie met base_url ingesteld op https://runapi.ai/v1 en api_key lezend vanuit RUNAPI_API_KEY. Dezelfde provider verwerkt chat-, beeld-, video- en muziekendpoints — geen aparte configuratie voor Suno.

### 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 instrumentale tracks genereren zonder vocalen?

Ja. Stel vocal_mode in op instrumental en geef style- en title-velden mee. De prompt- en lyrics-velden moeten worden weggelaten in instrumentale modus. De API handhaaft deze kruisveldregels en retourneert een validatiefout als tegenstrijdige velden worden verzonden.

### Welke andere Suno-endpoints zijn beschikbaar naast text_to_music?

RunAPI biedt cover_audio (een bestaande track restylen), extend_music (een nummer voortzetten vanaf een tijdstempel), create_mashup (elementen combineren uit meerdere tracks), text_to_sound (geluidseffecten), en hulpendpoints zoals generate_lyrics, generate_persona en separate_audio_stems. Alle delen dezelfde API-sleutel en taaklevenscyclus.


## Links

- [Hermes Agent-configuratiegids →](https://runapi.ai/nl/hermes-agent)
- [Suno op RunAPI →](https://runapi.ai/nl/models/suno)
- [Model catalog](https://runapi.ai/nl/models)
- [API docs](https://runapi.ai/nl/docs)