Używaj Suno w Hermes Agent.
Suno generuje pełne piosenki — wokal, instrumenty i miksowanie — na podstawie promptu tekstowego lub dokładnych słów. Wersje od v4 do v5.5 są dostępne przez RunAPI, które zapewnia dostęp przez API, ponieważ Suno nie ma oficjalnego publicznego API. Hermes Agent wywołuje je przez dostawcę custom:runapi z tym samym kluczem API używanym do czatu.
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"
}
Używaj Suno w Hermes Agent w trzech krokach
Skonfiguruj RunAPI
Ustaw RUNAPI_API_KEY w środowisku, w którym działa Hermes Agent. Jeśli już dodałeś RunAPI jako dostawcę custom:runapi, ten sam klucz i base_url obsługują żądania muzyczne Suno.
export RUNAPI_API_KEY=runapi_xxx
Wywołaj text_to_music
Wyślij POST do endpointu text_to_music z modelem i vocal_mode. Użyj auto_lyrics z promptem dla tekstów napisanych przez AI, exact_lyrics z lyrics/style/title dla własnych słów lub instrumental z style/title bez wokalu.
POST /api/v1/suno/text_to_music
Odpytuj o wynik
Endpoint natychmiast zwraca task_id. Generowanie piosenki trwa od 30 sekund do kilku minut w zależności od wersji. Odpytuj endpoint statusu zadania, aż status osiągnie wartość completed, a następnie odczytaj wyjściowy adres URL džwięku.
GET /api/v1/suno/text_to_music/tsk_abc123
Parametry API Suno text_to_music
| Parametr | Typ | Opis |
|---|---|---|
model |
string |
Wymagane. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 lub suno-v5.5. |
vocal_mode |
string |
Wymagane. auto_lyrics (AI pisze słowa na podstawie promptu), exact_lyrics (podajesz słowa/styl/tytuł) lub instrumental (bez wokalu, wymaga style/title). |
prompt |
string |
Opis piosenki dla trybu auto_lyrics. Opisz gatunek, nastrój, tempo i temat. Zabronione w trybach exact_lyrics i instrumental. |
lyrics |
string |
Dokładne słowa do zaśpiewania. Wymagane w trybie exact_lyrics. Zabronione w trybach auto_lyrics i instrumental. |
style |
string |
Opis stylu muzycznego, np. lo-fi hip hop, 80s synthwave. Wymagane dla trybów exact_lyrics i instrumental. |
title |
string |
Tytuł piosenki. Wymagane dla trybów exact_lyrics i instrumental. |
vocal_gender |
string |
Opcjonalne. male lub female. |
negative_tags |
string |
Opcjonalne. Style do wykluczenia, np. heavy metal, screaming. |
duration_seconds |
integer |
Opcjonalne. Docelowy czas trwania w sekundach. |
persona_id |
string |
Opcjonalne. ID persony dla niestandardowych profilów głosu lub stylu. |
persona_type |
string |
Opcjonalne. style lub voice. Wybiera kategorię persony. |
callback_url |
string |
Opcjonalne. Adres URL webhooka, który otrzymuje POST po zakończeniu zadania. |
Czym jest Suno w Hermes Agent?
Suno to generator tekst-do-muzyki produkujący kompletne piosenki z wokalami, instrumentami i produkcją. Hermes Agent wywołuje go przez RunAPI custom provider dla kroków generowania muzyki w zautomatyzowanych pipeline'ach treści.
Zastosowania Suno
Szkicownik songwriterski przed produkcją studyjną
Opisz koncepcję piosenki — gatunek, nastrój, tempo, temat — i posłuchaj jej jako pełne demo.
Covery AI w nowych stylach
Weź istniejący utwór i restylizuj go przez endpoint cover_audio w nowym gatunku lub nastroju.
Kompletne pipeline'y treści audiowizualnych
Łącz Suno z modelami wideo w workflow Hermes Agent — generuj muzykę, potem wideo, potem łącz.
Pytania o Suno + Hermes Agent
auto_lyrics generuje słowa na podstawie Twojego promptu — opisujesz piosenkę, a Suno pisze tekst. exact_lyrics używa dosłownie podanych przez Ciebie słów i wymaga pól style oraz title. instrumental tworzy utwór bez wokalu, używając tylko style i title.
Dodaj dostawcę custom:runapi w konfiguracji Hermes Agent z base_url ustawionym na https://runapi.ai/v1 i api_key odczytywanym z RUNAPI_API_KEY. Ten sam dostawca obsługuje endpointy czatu, obrazów, wideo i muzyki — nie jest potrzebna oddzielna konfiguracja dla Suno.
Suno nie oferuje publicznego API. RunAPI zapewnia programowy dostęp do Suno v4 przez v5.5 przy użyciu tego samego klucza API i cyklu życia zadań, co wszystkie inne modele RunAPI. Nie potrzebujesz konta Suno ani oddzielnych danych uwierzytelniających.
Tak. Ustaw vocal_mode na instrumental i podaj pola style i title. Pola prompt i lyrics muszą być pominięte w trybie instrumental. API wymusza te reguły między polami i zwraca błąd walidacji, jeśli zostaną przesłane sprzeczne pola.
RunAPI udostępnia cover_audio (zmiana stylu istniejącego utworu), extend_music (kontynuacja piosenki od znacznika czasu), create_mashup (łączenie elementów z wielu ścieżek), text_to_sound (efekty džwiękowe) oraz endpointy narzędziowe takie jak generate_lyrics, generate_persona i separate_audio_stems. Wszystkie korzystają z tego samego klucza API i cyklu życia zadań.
Ogólna konfiguracja Hermes Agent
Nie skonfigurowano jeszcze? Zacznij od przewodnika konfiguracji RunAPI dla Hermes Agent.
Przewodnik konfiguracji Hermes Agent →Wypróbuj Suno w Hermes Agent już dziś.
Zdobądź darmowy klucz RunAPI, skonfiguruj dostawcę custom:runapi i generuj pełne piosenki z wokalem, instrumentami i miksowaniem na podstawie opisu tekstowego.