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.

Wie konfiguriere ich RunAPI als Custom-Provider in Hermes Agent für Suno?

Einen custom:runapi-Provider in der Hermes Agent-Konfiguration mit base_url https://runapi.ai/v1 und api_key aus RUNAPI_API_KEY hinzufügen. Derselbe Provider übernimmt Chat-, Bild-, Video- und Musik-Endpunkte — keine separate Konfiguration für Suno.

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 rein instrumentale Tracks ohne Gesang generieren?

Ja. vocal_mode auf instrumental setzen und style- und title-Felder angeben. Das prompt- und lyrics-Feld muss im instrumental-Modus weggelassen werden. Die API erzwingt diese feldübergreifenden Regeln und gibt einen Validierungsfehler zurück, wenn widersprüchliche Felder gesendet werden.

Welche anderen Suno-Endpunkte sind neben text_to_music verfügbar?

RunAPI stellt cover_audio (einen bestehenden Track umgestalten), extend_music (einen Song ab einem Zeitstempel fortsetzen), create_mashup (Elemente mehrerer Tracks kombinieren), text_to_sound (Soundeffekte) und Hilfs-Endpunkte wie generate_lyrics, generate_persona und separate_audio_stems bereit. Alle teilen denselben API-Key und Task-Lebenszyklus.

HERMES + SUNO

Suno in Hermes Agent 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. Hermes Agent ruft es über den custom:runapi-Provider mit demselben API-Key wie für Chat auf.

API Key holen Dokumentation lesen

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.

      - 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"
}

Den curl-Befehl kopieren und testen suno

SO FUNKTIONIERT ES

Suno in Hermes Agent in drei Schritten verwenden

RunAPI konfigurieren

RUNAPI_API_KEY in der Umgebung setzen, in der Hermes Agent läuft. Wenn RunAPI bereits als custom:runapi-Provider hinzugefügt wurde, übernehmen derselbe Key und dieselbe base_url die Suno-Musik-Requests.

export RUNAPI_API_KEY=runapi_xxx

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

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 mit Hermes Agent?

Suno ist ein Text-zu-Musik-Generator, der vollständige Songs mit Gesang, Instrumenten und Mixing aus einer Textbeschreibung oder eigenen Songtexten produziert. Hermes Agent ruft es über den custom:runapi-Provider auf, was für mehrstufige Content-Workflows nützlich ist – ein Video mit Kling generieren, dann einen passenden Soundtrack mit Suno erstellen, alles in einem Agent-Lauf. Die Versionen v4 bis v5.5 sind verfügbar, da Suno keine offizielle öffentliche API hat.

Suno Anwendungsfälle

Songwriting-Sketchpad vor der Studioproduktion

Ein Song-Konzept beschreiben – Genre, Stimmung, Tempo, Thema – und einen vollständigen Demo-Track zurückerhalten. Ideen schnell iterieren, bevor man sich zur Studiozeit verpflichtet, und hören, wie verschiedene Stile und Arrangements klingen.

KI-Cover in neuen Stilen

Einen bestehenden Track durch den cover_audio-Endpunkt neu gestalten. Genre ändern, Instrumentierung tauschen oder Stimmung verschieben, dabei die Kernmelodie und -struktur beibehalten.

Vollständige audiovisuelle Content-Pipelines

Suno mit Videomodellen in einem Hermes-Agent-Workflow verketten – Videomaterial generieren, dann einen passenden Originalsoundtrack erstellen und bereit-zum-Veröffentlichen-Content ohne separate Musiklizenzierung produzieren.

FAQ

Suno + Hermes Agent — Fragen

Hermes Agent Grundeinrichtung

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

Hermes Agent Einrichtungsanleitung →

Suno Modellkatalog

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

Suno on RunAPI →

Suno in Hermes Agent noch heute ausprobieren.

Einen kostenlosen RunAPI-Key holen, den custom:runapi-Provider konfigurieren und vollständige Songs mit Gesang, Instrumenten und Abmischung aus einer Textbeschreibung generieren.

Modelle durchsuchen →