---
title: "Używaj Suno w OpenClaw przez RunAPI — Przewodnik po Music API"
url: "https://runapi.ai/pl/openclaw-suno.md"
canonical: "https://runapi.ai/pl/openclaw-suno"
locale: "pl"
model: "suno"
---

# 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.

## 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. **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.
2. **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.
3. **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.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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. |

## FAQ

### Jaka jest różnica między auto_lyrics, exact_lyrics i instrumental?

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.

### Której wersji Suno powinienem użyć?

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.

### Jak długo trwa generowanie w Suno?

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.

### Czy RunAPI zapewnia oficjalne API 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.

### Czy mogę kontrolować płeć głosu i wagę stylu?

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.


## Links

- [Przewodnik konfiguracji OpenClaw →](https://runapi.ai/pl/openclaw)
- [Suno na RunAPI →](https://runapi.ai/pl/models/suno)
- [Model catalog](https://runapi.ai/pl/models)
- [API docs](https://runapi.ai/pl/docs)