Używaj Suno w OpenClaw.
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. Agenty OpenClaw wywołują je tym samym RUNAPI_API_KEY używanym do czatu.
Use RunAPI to generate a song with Suno.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- 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 OpenClaw w trzech krokach
Skonfiguruj RunAPI
Ustaw RUNAPI_API_KEY w swoim środowisku. Jeśli już skonfigurowałeś RunAPI w OpenClaw do czatu, ten sam klucz działa do generowania muzyki Suno — nie jest potrzebna żadna dodatkowa konfiguracja dostawcy.
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 OpenClaw?
Suno to AI tekst-do-muzyki generująca kompletne piosenki — wokale, instrumenty i produkcję — z podpowiedzi tekstowej. Obsługuje tryb dokładnych tekstów, ciągłe generowanie dla dłuższych piosenek i kompozycję sterowaną gatunkiem. Agenty OpenClaw wywołują go przez RunAPI z tym samym kluczem API co do czatu.
Zastosowania Suno
Muzyka tła dla YouTube i mediów społecznościowych
Generuj oryginalne ścieżki tła dla filmów, opisując gatunek, nastrój i tempo.
Słuchanie tekstów jako kompletnej piosenki
Autorzy tekstów mogą wklejać swoje słowa w tryb exact_lyrics, aby usłyszeć, jak brzmią jako kompletna piosenka.
Jingle i outro podcastów
Twórz instrumentalną muzykę intro i outro dopasowaną do nastroju i formatu podcastu.
Pytania o Suno + OpenClaw
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.
suno-v5.5 to najnowsza wersja, która zapewnia najwyższą jakość — lepszą klarowność wokalu i miksowanie. suno-v4 i suno-v4.5 są tańsze i szybsze, idealne do wersji roboczych. Wszystkie wersje korzystają z tego samego endpointu text_to_music i tych samych parametrów.
Czas generowania zależy od wersji i długości piosenki. Typowy czas to 30 sekund do 2 minut. API zwraca task_id natychmiast — odpytuj endpoint statusu lub ustaw callback_url, aby nie blokować swojego agenta.
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_gender na male lub female. Użyj negative_tags, aby wykluczyć niechciane style. Aby uzyskać dokładniejszą kontrolę, utwórz personę przez endpoint generate_persona i przekaż zwrócony persona_id z persona_type ustawionym na voice lub style.
Ogólna konfiguracja OpenClaw
Nie skonfigurowano jeszcze? Zacznij od przewodnika konfiguracji RunAPI dla OpenClaw.
Przewodnik konfiguracji OpenClaw →Wypróbuj Suno w OpenClaw już dziś.
Zdobądź darmowy klucz RunAPI, wklej prompt do OpenClaw i generuj pełne piosenki z wokalem, instrumentami i miksowaniem na podstawie opisu tekstowego.