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.
Use RunAPI to generate a song with Suno.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- 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"
}
Gebruik Suno in Hermes Agent in drie stappen
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.
export RUNAPI_API_KEY=runapi_xxx
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.
POST /api/v1/suno/text_to_music
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.
GET /api/v1/suno/text_to_music/tsk_abc123
Suno text_to_music API-parameters
| Parameter | Type | Beschrijving |
|---|---|---|
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. |
Wat is Suno in Hermes Agent?
Suno is een tekst-naar-muziek-generator die complete nummers produceert met zang, instrumenten en productie. Hermes Agent roept het aan via de RunAPI custom provider voor muziekgeneratiestappen in geautomatiseerde contentpipelines.
Suno-toepassingen
Songwriting schetsblok voor studioproductie
Beschrijf een nummerconcept — genre, sfeer, tempo, onderwerp — en beluister het als volledige demo.
AI-covers in nieuwe stijlen
Neem een bestaand nummer en herstijl het via de cover_audio-endpoint in een nieuw genre of sfeer.
Complete audiovisuele contentpipelines
Koppel Suno met videomodellen in een Hermes Agent-workflow — genereer muziek, dan video, dan combineer.
Vragen over Suno + Hermes Agent
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.
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.
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.
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.
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.
Algemene Hermes Agent-configuratie
Nog niet geconfigureerd? Begin met de RunAPI-configuratiegids voor Hermes Agent.
Hermes Agent-configuratiegids →Probeer Suno in Hermes Agent vandaag.
Haal een gratis RunAPI-sleutel, configureer de custom:runapi-provider en genereer volledige nummers met vocalen, instrumenten en mixing vanuit een tekstbeschrijving.