Przejdź do głównej treści
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 dostawcypixverse
Pakiet Pluginu@openclaw/pixverse-provider
Zmienna env authPIXVERSE_API_KEY
Flaga onboardingu--auth-choice pixverse-api-key
Bezpośrednia flaga CLI--pixverse-api-key <key>
APIPixVerse Platform API v2 (zgłoszenie video_id oraz odpytywanie wyniku)
Domyślny modelpixverse/v6
Domyślny region APIMiędzynarodowy

Pierwsze kroki

1

Zainstaluj Plugin

openclaw plugins install clawhub:@openclaw/pixverse-provider
openclaw gateway restart
2

Ustaw klucz API

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.
3

Ustaw PixVerse jako domyślnego dostawcę wideo

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

Wygeneruj wideo

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

Obsługiwane tryby i modele

Dostawca udostępnia modele generowania PixVerse przez współdzielone narzędzie wideo OpenClaw.
TrybModeleWejście referencyjne
Tekst na wideov6 (domyślny), c1Brak
Obraz na wideov6 (domyślny), c11 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.
OpcjaObsługiwane wartości
Czas trwania1-15 sekund
Rozdzielczość360P, 540P, 720P, 1080P
Proporcje obrazu16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 dla tekstu na wideo
Wygenerowany dźwiękaudio: true
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.

Opcje dostawcy

Dostawca wideo akceptuje te opcjonalne klucze specyficzne dla dostawcy:
OpcjaTypEfekt
seednumberDeterministyczne ziarno, gdy jest obsługiwane
negativePrompt / negative_promptstringNegatywny prompt
qualitystringJakość PixVerse, taka jak 720p
motionMode / motion_modestringTryb ruchu dla obrazu na wideo
cameraMovement / camera_movementstringPreset ruchu kamery PixVerse
templateId / template_idnumberAktywowany identyfikator szablonu PixVerse

Konfiguracja

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

Konfiguracja zaawansowana

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ść regionuBazowy URL API PixVerse
internationalhttps://app-api.pixverse.ai/openapi/v2
cnhttps://app-api.pixverseai.cn/openapi/v2
{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" or "cn"
        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
        models: [],
      },
    },
  },
}
Ustaw models.providers.pixverse.baseUrl tylko podczas routingu przez zaufane, zgodne proxy. baseUrl ma pierwszeństwo przed region.
{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}
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.

Powiązane

Generowanie wideo

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

Informacje referencyjne o konfiguracji

Domyślne ustawienia agenta, w tym model generowania wideo.