Providers
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-provideropenclaw gateway restartUstaw klucz API
openclaw onboard --auth-choice pixverse-api-keyKreator 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 |
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).
