---
title: "Użyj Hailuo w Hermes Agent przez RunAPI — Przewodnik po API wideo"
url: "https://runapi.ai/pl/hermes-hailuo.md"
canonical: "https://runapi.ai/pl/hermes-hailuo"
locale: "pl"
model: "hailuo"
---

# Użyj Hailuo w Hermes Agent.

Hailuo to model generowania wideo firmy MiniMax, produkujący natywny obraz 1080p z dokładną symulacją fizyki w 6 wariantach — Hailuo 02 i 2.3, każdy z punktami końcowymi text-to-video i image-to-video w tierach pro i standard. Hermes Agent wywołuje go przez RunAPI przy użyciu dostawcy custom:runapi — tego samego klucza i base URL skonfigurowanego do chatu.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/hailuo/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-02-text-to-video-pro",
    "prompt": "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field."
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "hailuo-02-text-to-video-pro"
}

```

## How it works

1. **Skonfiguruj RunAPI** — Ustaw zmienną środowiskową RUNAPI_API_KEY. Jeśli już dodałeś RunAPI jako dostawcę custom:runapi w Hermes Agent do chatu, ten sam klucz i base_url działają do generowania wideo — nie jest wymagana dodatkowa konfiguracja.
2. **Wywołaj Hailuo text_to_video lub image_to_video** — Wyślij żądanie POST do /api/v1/hailuo/text_to_video z modelem ustawionym na hailuo-02-text-to-video-pro i promptem opisującym scenę. Do wideo zakotwiczonego w obrazie użyj punktu końcowego image_to_video z first_frame_image_url, aby zachować podmiot źródłowy.
3. **Odpytuj o wynik** — Punkt końcowy zwraca task_id natychmiast. Odpytuj punkt końcowy statusu zadania, aż status zmieni się na completed, a następnie pobierz wygenerowany URL wideo z odpowiedzi. Typowy czas realizacji to poniżej dwóch minut dla tiera pro.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Wymagane. Jeden z: hailuo-02-text-to-video-pro, hailuo-02-text-to-video-standard, hailuo-02-image-to-video-pro, hailuo-02-image-to-video-standard, hailuo-2.3-image-to-video-pro, hailuo-2.3-image-to-video-standard. |
| `prompt` | `string` | Wymagane. Tekstowy opis sceny wideo, ruchu kamery i oświetlenia. |
| `first_frame_image_url` | `string` | Wymagane dla punktów końcowych image_to_video. URL obrazu źródłowego użytego jako pierwsza klatka. |
| `last_frame_image_url` | `string` | Opcjonalne. URL obrazu użytego jako ostatnia klatka. Dostępne tylko dla Hailuo 02 image-to-video. |
| `duration_seconds` | `integer` | Opcjonalne. Długość wideo w sekundach. Akceptowane wartości: 6 lub 10. Domyślnie 10 dla standardu, stała dla pro. |
| `output_resolution` | `string` | Opcjonalne. Rozdzielczość wyjściowa. 512p lub 768p dla 02 standard; 768p lub 1080p dla wariantów 2.3. |
| `callback_url` | `string` | Opcjonalne. Adres URL webhooka, który otrzymuje POST po zakończeniu zadania. |

## FAQ

### Czy mogę używać Hailuo w Hermes Agent?

Tak. Skonfiguruj RunAPI jako dostawcę custom:runapi w Hermes Agent, a następnie wywołaj punkt końcowy text_to_video lub image_to_video z modelem Hailuo. Ten sam RUNAPI_API_KEY, którego używasz do chatu, obsługuje generowanie wideo.

### Jaka jest różnica między Hailuo 02 a Hailuo 2.3?

Hailuo 02 obsługuje zarówno text-to-video, jak i image-to-video z kontrolą pierwszej i ostatniej klatki. Hailuo 2.3 to wyłącznie image-to-video, ale oferuje ulepszone ruchy ciała, mikro-ekspresje oraz dedykowane style renderowania anime i ilustracji.

### Jak działa cennik oparty na czasie trwania dla tierów standard?

Cennik tiera standard zależy od duration_seconds. Dla text-to-video standard klip 6-sekundowy kosztuje 30 centów, a 10-sekundowy 50 centów. Cena image-to-video standard uwzględnia również output_resolution — klip 6s 512p zaczyna się od 12 centów.

### Czy Hermes Agent obsługuje automatyczne odpytywanie asynchroniczne?

Nie. Hailuo działa asynchronicznie — API zwraca task_id natychmiast. Przepływ pracy Hermes Agent musi odpytywać punkt końcowy statusu zadania lub podać callback_url. Typowy czas generacji to 60–120 sekund.

### Czy mogę kontrolować zarówno pierwszą, jak i ostatnią klatkę wideo Hailuo?

Tylko na punktach końcowych image-to-video Hailuo 02. Przekaż jednocześnie first_frame_image_url i last_frame_image_url, aby zdefiniować klatkę początkową i końcową. Hailuo 2.3 image-to-video akceptuje wyłącznie first_frame_image_url.


## Links

- [Przewodnik konfiguracji Hermes Agent →](https://runapi.ai/pl/hermes-agent)
- [Modele Hailuo →](https://runapi.ai/pl/models/hailuo)
- [Model catalog](https://runapi.ai/pl/models)
- [API docs](https://runapi.ai/pl/docs)