---
title: &quot;Użyj Hailuo w OpenClaw przez RunAPI — Przewodnik po API wideo&quot;
url: &quot;https://runapi.ai/pl/openclaw-hailuo.md&quot;
canonical: &quot;https://runapi.ai/pl/openclaw-hailuo&quot;
locale: &quot;pl&quot;
model: &quot;hailuo&quot;
---

# Użyj Hailuo w OpenClaw.

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. Agenci OpenClaw wywołują go przez RunAPI tym samym kluczem API, który jest używany do chatu.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/hailuo/text_to_video \
  -H &quot;Authorization: Bearer $RUNAPI_API_KEY&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d &#39;{
    &quot;model&quot;: &quot;hailuo-02-text-to-video-pro&quot;,
    &quot;prompt&quot;: &quot;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.&quot;
  }&#39;

```

### Response

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

```

## How it works

1. **Skonfiguruj RunAPI** — Ustaw zmienną środowiskową RUNAPI_API_KEY. Jeśli już skonfigurowałeś RunAPI jako dostawcę OpenClaw do chatu, ten sam klucz działa 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

### 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 niedostępne w 02.

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

Tak, ale tylko na punktach końcowych image-to-video Hailuo 02. Przekaż jednocześnie first_frame_image_url i last_frame_image_url. Hailuo 2.3 image-to-video akceptuje wyłącznie first_frame_image_url.

### Jak działa cennik Pro vs Standard?

Hailuo 02 Pro text-to-video kosztuje 57 centów za generację niezależnie od czasu trwania. Standard korzysta z cennika opartego na czasie trwania — 30 centów za 6 sekund, 50 centów za 10 sekund. Cena standardu image-to-video zależy również od output_resolution.

### Czy Hailuo działa asynchronicznie czy synchronicznie?

Asynchronicznie. API zwraca task_id natychmiast. Odpytuj punkt końcowy statusu zadania lub ustaw callback_url, aby otrzymać webhook po gotowości wideo. Typowy czas generacji to 60–120 sekund.

### W jakiej rozdzielczości generuje Hailuo?

Hailuo 02 Pro generuje natywny obraz 1080p. Standard generuje 512p lub 768p w zależności od parametru output_resolution. Warianty Hailuo 2.3 obsługują 768p lub 1080p. Nie stosuje się skalowania po zakończeniu przetwarzania.


## Links

- [Przewodnik konfiguracji OpenClaw →](https://runapi.ai/pl/openclaw)
- [Modele Hailuo →](https://runapi.ai/pl/models/hailuo)
- [Model catalog](https://runapi.ai/pl/models)
- [API docs](https://runapi.ai/pl/docs)
