PixVerse

OpenClaw udostępnia pixverse jako oficjalny zewnętrzny plugin do generowania filmów za pomocą hostowanej usługi PixVerse. Plugin rejestruje dostawcę pixverse zgodnie z kontraktem videoGenerationProviders.

Właściwość	Wartość
Identyfikator dostawcy	`pixverse`
Pakiet pluginu	`@openclaw/pixverse-provider`
Zmienna środowiskowa uwierzytelniania	`PIXVERSE_API_KEY`
Flaga wdrażania	`--auth-choice pixverse-api-key`
Bezpośrednia flaga CLI	`--pixverse-api-key <key>`
API	PixVerse Platform API v2 (przesłanie `video_id` i odpytywanie o wynik)
Model domyślny	`pixverse/v6`
Domyślny region API	Międzynarodowy

Pierwsze kroki

Zainstaluj plugin

openclaw plugins install @openclaw/pixverse-provider
openclaw gateway restart

Ustaw klucz API

openclaw onboard --auth-choice pixverse-api-key

Kreator prosi o wybranie punktu końcowego International lub CN (zobacz region API poniżej), zanim zapisze region i baseUrl w konfiguracji dostawcy. Uruchomienia nieinteraktywne (klucz z --pixverse-api-key lub PIXVERSE_API_KEY) domyślnie używają regionu International.Wdrażanie ustawia również agents.defaults.videoGenerationModel.primary na pixverse/v6, jeśli nie skonfigurowano jeszcze domyślnego modelu generowania filmów.

Zmień istniejącego domyślnego dostawcę generowania filmów (opcjonalnie)

openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"

Wygeneruj film

Poproś agenta o wygenerowanie filmu. PixVerse zostanie użyty automatycznie.

Obsługiwane tryby i modele

Dostawca udostępnia modele generowania PixVerse za pośrednictwem współdzielonego narzędzia wideo OpenClaw.

Tryb	Modele	Dane wejściowe odniesienia
Tekst na film	`v6` (domyślny), `c1`	Brak
Obraz na film	`v6` (domyślny), `c1`	1 obraz lokalny lub zdalny

Lokalne obrazy odniesienia są przesyłane do PixVerse przed żądaniem przekształcenia obrazu w film. Adresy URL zdalnych obrazów są przekazywane do punktu końcowego przesyłania obrazów PixVerse jako image_url.

Opcja	Obsługiwane wartości
Czas trwania	1–15 sekund (domyślnie 5)
Rozdzielczość	`360P`, `540P`, `720P`, `1080P` (domyślnie `540P`; żądania `480P` są mapowane na `540P`)
Proporcje obrazu	`16:9` (domyślnie), `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9`; tylko tekst na film, obraz na film zachowuje proporcje obrazu źródłowego
Generowany dźwięk	`audio: true`

Generowanie obrazów na podstawie szablonów PixVerse nie jest jeszcze udostępniane przez image_generate. To API korzysta z identyfikatorów szablonów, natomiast współdzielony kontrakt generowania obrazów OpenClaw nie zawiera obecnie typowanego zestawu opcji specyficznych dla PixVerse.

Opcje dostawcy

Dostawca generowania filmów przyjmuje następujące opcjonalne klucze specyficzne dla dostawcy:

Opcja	Typ	Działanie
`seed`	liczba	Deterministyczne ziarno od 0 do 2147483647
`negativePrompt` / `negative_prompt`	ciąg	Negatywny prompt
`quality`	ciąg	Jakość PixVerse, na przykład `720p`
`motionMode` / `motion_mode`	ciąg	Tryb ruchu obrazu na film (domyślnie `normal`)
`cameraMovement` / `camera_movement`	ciąg	Ustawienie wstępne ruchu kamery PixVerse
`templateId` / `template_id`	liczba	Identyfikator aktywowanego szablonu PixVerse

Konfiguracja

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

Konfiguracja zaawansowana

Region API

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

Ustaw ręcznie models.providers.pixverse.region, gdy klucz należy do konkretnego regionu platformy PixVerse, albo uruchom openclaw onboard --auth-choice pixverse-api-key, aby wybrać region w kreatorze konfiguracji:

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

Niestandardowy bazowy adres URL

Ustaw models.providers.pixverse.baseUrl tylko w przypadku kierowania ruchu przez zaufane, zgodne proxy. baseUrl ma pierwszeństwo przed region.

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

Odpytywanie o stan zadania

PixVerse zwraca video_id z żądania generowania. OpenClaw odpytuje /openapi/v2/video/result/{video_id} co 5 sekund, aż zadanie zakończy się powodzeniem, niepowodzeniem lub przekroczy limit czasu (domyślnie 5 minut; można go zmienić za pomocą agents.defaults.videoGenerationModel.timeoutMs).

Powiązane

Generowanie filmów

Współdzielone parametry narzędzia, wybór dostawcy i zachowanie asynchroniczne.

Dokumentacja konfiguracji

Domyślne ustawienia agenta, w tym model generowania filmów.

Overview

Concepts and configuration

Providers

Pierwsze kroki

Obsługiwane tryby i modele

Opcje dostawcy

Konfiguracja

Konfiguracja zaawansowana

Powiązane

Generowanie filmów

Dokumentacja konfiguracji

​Pierwsze kroki

​Obsługiwane tryby i modele

​Opcje dostawcy

​Konfiguracja

​Konfiguracja zaawansowana

​Powiązane

Generowanie filmów

Dokumentacja konfiguracji

Pierwsze kroki

Obsługiwane tryby i modele

Opcje dostawcy

Konfiguracja

Konfiguracja zaawansowana

Powiązane