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

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

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

### Jak skonfigurować RunAPI jako niestandardowego dostawcę w Hermes Agent dla Suno?

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.

### 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ę generować ścieżki tylko instrumentalne bez wokalu?

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.

### Jakie inne endpointy Suno są dostępne poza text_to_music?

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


## Links

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