---
read_when:
    - Chcesz używać generowania wideo PixVerse w OpenClaw
    - Potrzebujesz konfiguracji klucza API/zmiennej środowiskowej PixVerse
    - Chcesz ustawić PixVerse jako domyślnego dostawcę wideo
summary: Konfiguracja generowania wideo PixVerse w OpenClaw
title: PixVerse
x-i18n:
    generated_at: "2026-06-27T18:14:43Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 9967ec20f7a9db3413db12ed75f836ae0bee6610e765f049720988b43494d37b
    source_path: providers/pixverse.md
    workflow: 16
---

OpenClaw udostępnia `pixverse` jako oficjalny zewnętrzny Plugin do hostowanego generowania wideo PixVerse. Plugin rejestruje dostawcę `pixverse` względem kontraktu `videoGenerationProviders`.

| Właściwość             | Wartość                                                                 |
| ---------------------- | ----------------------------------------------------------------------- |
| Identyfikator dostawcy | `pixverse`                                                              |
| Pakiet Pluginu         | `@openclaw/pixverse-provider`                                           |
| Zmienna env auth       | `PIXVERSE_API_KEY`                                                      |
| Flaga onboardingu      | `--auth-choice pixverse-api-key`                                        |
| Bezpośrednia flaga CLI | `--pixverse-api-key <key>`                                              |
| API                    | PixVerse Platform API v2 (zgłoszenie `video_id` oraz odpytywanie wyniku) |
| Domyślny model         | `pixverse/v6`                                                           |
| Domyślny region API    | Międzynarodowy                                                          |

## Pierwsze kroki

<Steps>
  <Step title="Zainstaluj Plugin">
    ```bash
    openclaw plugins install clawhub:@openclaw/pixverse-provider
    openclaw gateway restart
    ```
  </Step>
  <Step title="Ustaw klucz API">
    ```bash
    openclaw onboard --auth-choice pixverse-api-key
    ```

    Kreator pyta, czy użyć punktu końcowego International
    (`https://app-api.pixverse.ai/openapi/v2`), czy punktu końcowego CN
    (`https://app-api.pixverseai.cn/openapi/v2`), zanim zapisze `region` i
    `baseUrl` w konfiguracji dostawcy.

  </Step>
  <Step title="Ustaw PixVerse jako domyślnego dostawcę wideo">
    ```bash
    openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"
    ```
  </Step>
  <Step title="Wygeneruj wideo">
    Poproś agenta o wygenerowanie wideo. PixVerse zostanie użyty automatycznie.
  </Step>
</Steps>

## Obsługiwane tryby i modele

Dostawca udostępnia modele generowania PixVerse przez współdzielone narzędzie wideo OpenClaw.

| Tryb            | Modele               | Wejście referencyjne       |
| --------------- | -------------------- | -------------------------- |
| Tekst na wideo  | `v6` (domyślny), `c1` | Brak                       |
| Obraz na wideo  | `v6` (domyślny), `c1` | 1 obraz lokalny lub zdalny |

Lokalne referencje obrazów są przesyłane do PixVerse przed żądaniem obrazu na wideo. Zdalne adresy URL obrazów są przekazywane przez punkt końcowy przesyłania obrazów PixVerse jako `image_url`.

| Opcja              | Obsługiwane wartości                                                        |
| ------------------ | --------------------------------------------------------------------------- |
| Czas trwania       | 1-15 sekund                                                                 |
| Rozdzielczość      | `360P`, `540P`, `720P`, `1080P`                                             |
| Proporcje obrazu   | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` dla tekstu na wideo |
| Wygenerowany dźwięk | `audio: true`                                                               |

<Note>
Generowanie szablonów obrazów PixVerse nie jest jeszcze udostępniane przez `image_generate`. To API jest sterowane identyfikatorem szablonu, natomiast współdzielony kontrakt generowania obrazów OpenClaw nie ma obecnie specyficznego dla PixVerse typowanego zestawu opcji.
</Note>

## Opcje dostawcy

Dostawca wideo akceptuje te opcjonalne klucze specyficzne dla dostawcy:

| Opcja                                | Typ    | Efekt                                      |
| ------------------------------------ | ------ | ------------------------------------------ |
| `seed`                               | number | Deterministyczne ziarno, gdy jest obsługiwane |
| `negativePrompt` / `negative_prompt` | string | Negatywny prompt                           |
| `quality`                            | string | Jakość PixVerse, taka jak `720p`           |
| `motionMode` / `motion_mode`         | string | Tryb ruchu dla obrazu na wideo             |
| `cameraMovement` / `camera_movement` | string | Preset ruchu kamery PixVerse               |
| `templateId` / `template_id`         | number | Aktywowany identyfikator szablonu PixVerse |

## Konfiguracja

```json5
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "pixverse/v6",
      },
    },
  },
}
```

## Konfiguracja zaawansowana

<AccordionGroup>
  <Accordion title="Region API">
    OpenClaw domyślnie używa międzynarodowego API PixVerse. Ustaw `models.providers.pixverse.region`
    ręcznie, gdy Twój klucz należy do konkretnego regionu platformy PixVerse, albo użyj
    `openclaw onboard --auth-choice pixverse-api-key`, aby wybrać region w kreatorze konfiguracji:

    | Wartość regionu | Bazowy URL API PixVerse                       |
    | --------------- | --------------------------------------------- |
    | `international` | `https://app-api.pixverse.ai/openapi/v2`      |
    | `cn`            | `https://app-api.pixverseai.cn/openapi/v2`    |

    ```json5
    {
      models: {
        providers: {
          pixverse: {
            region: "cn", // "international" or "cn"
            baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
            models: [],
          },
        },
      },
    }
    ```

  </Accordion>

  <Accordion title="Niestandardowy bazowy URL">
    Ustaw `models.providers.pixverse.baseUrl` tylko podczas routingu przez zaufane, zgodne proxy.
    `baseUrl` ma pierwszeństwo przed `region`.

    ```json5
    {
      models: {
        providers: {
          pixverse: {
            baseUrl: "https://app-api.pixverse.ai/openapi/v2",
          },
        },
      },
    }
    ```

  </Accordion>

  <Accordion title="Odpytywanie zadania">
    PixVerse zwraca `video_id` z żądania generowania. OpenClaw odpytuje
    `/openapi/v2/video/result/{video_id}`, aż zadanie zakończy się powodzeniem, niepowodzeniem
    albo przekroczy limit czasu.
  </Accordion>
</AccordionGroup>

## Powiązane

<CardGroup cols={2}>
  <Card title="Generowanie wideo" href="/pl/tools/video-generation" icon="video">
    Współdzielone parametry narzędzia, wybór dostawcy i zachowanie asynchroniczne.
  </Card>
  <Card title="Informacje referencyjne o konfiguracji" href="/pl/gateway/config-agents#agent-defaults" icon="gear">
    Domyślne ustawienia agenta, w tym model generowania wideo.
  </Card>
</CardGroup>