PixVerse - OpenClaw

OpenClaw stellt pixverse als offizielles externes Plugin für gehostete PixVerse-Videogenerierung bereit. Das Plugin registriert den Provider pixverse gegen den Vertrag videoGenerationProviders.

Eigenschaft	Wert
Provider-ID	`pixverse`
Plugin-Paket	`@openclaw/pixverse-provider`
Auth-Umgebungsvariable	`PIXVERSE_API_KEY`
Onboarding-Flag	`--auth-choice pixverse-api-key`
Direkter CLI-Flag	`--pixverse-api-key <key>`
API	PixVerse Platform API v2 (`video_id`-Übermittlung plus Ergebnis-Polling)
Standardmodell	`pixverse/v6`
Standard-API-Region	International

Erste Schritte

Installieren Sie das Plugin

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

Legen Sie den API-Schlüssel fest

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

Der Assistent fragt, ob der internationale Endpunkt (https://app-api.pixverse.ai/openapi/v2) oder der CN-Endpunkt (https://app-api.pixverseai.cn/openapi/v2) verwendet werden soll, bevor region und baseUrl in die Provider-Konfiguration geschrieben werden.

Legen Sie PixVerse als Standard-Video-Provider fest

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

Generieren Sie ein Video

Bitten Sie den Agenten, ein Video zu generieren. PixVerse wird automatisch verwendet.

Unterstützte Modi und Modelle

Der Provider stellt PixVerse-Generierungsmodelle über das gemeinsame Video-Tool von OpenClaw bereit.

Modus	Modelle	Referenzeingabe
Text-zu-Video	`v6` (Standard), `c1`	Keine
Bild-zu-Video	`v6` (Standard), `c1`	1 lokales oder Remote-Bild

Lokale Bildreferenzen werden vor der Bild-zu-Video-Anfrage zu PixVerse hochgeladen. Remote-Bild-URLs werden über den PixVerse-Bildupload-Endpunkt als image_url weitergegeben.

Option	Unterstützte Werte
Dauer	1-15 Sekunden
Auflösung	`360P`, `540P`, `720P`, `1080P`
Seitenverhältnis	`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` für Text-zu-Video
Generiertes Audio	`audio: true`

Die PixVerse-Bildvorlagengenerierung wird noch nicht über image_generate bereitgestellt. Diese API wird über Template-IDs gesteuert, während der gemeinsame Bildgenerierungsvertrag von OpenClaw derzeit kein PixVerse-spezifisches typisiertes Optionsobjekt hat.

Provider-Optionen

Der Video-Provider akzeptiert diese optionalen Provider-spezifischen Schlüssel:

Option	Typ	Wirkung
`seed`	number	Deterministischer Seed, sofern unterstützt
`negativePrompt` / `negative_prompt`	string	Negativer Prompt
`quality`	string	PixVerse-Qualität wie `720p`
`motionMode` / `motion_mode`	string	Bewegungsmodus für Bild-zu-Video
`cameraMovement` / `camera_movement`	string	PixVerse-Kamerabewegungs-Preset
`templateId` / `template_id`	number	Aktivierte PixVerse-Template-ID

Konfiguration

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

Erweiterte Konfiguration

API-Region

OpenClaw verwendet standardmäßig die internationale PixVerse-API. Legen Sie models.providers.pixverse.region manuell fest, wenn Ihr Schlüssel zu einer bestimmten PixVerse-Plattformregion gehört, oder verwenden Sie openclaw onboard --auth-choice pixverse-api-key, um im Einrichtungsassistenten eine Region auszuwählen:

Regionswert	PixVerse-API-Basis-URL
`international`	`https://app-api.pixverse.ai/openapi/v2`
`cn`	`https://app-api.pixverseai.cn/openapi/v2`

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

Benutzerdefinierte Basis-URL

Legen Sie models.providers.pixverse.baseUrl nur fest, wenn das Routing über einen vertrauenswürdigen kompatiblen Proxy erfolgt. baseUrl hat Vorrang vor region.

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

Aufgaben-Polling

PixVerse gibt aus der Generierungsanfrage eine video_id zurück. OpenClaw pollt /openapi/v2/video/result/{video_id}, bis die Aufgabe erfolgreich ist, fehlschlägt oder ein Timeout erreicht.

Videogenerierung

Gemeinsame Tool-Parameter, Provider-Auswahl und asynchrones Verhalten.

Konfigurationsreferenz

Agenten-Standardeinstellungen einschließlich Videogenerierungsmodell.

​Erste Schritte

​Unterstützte Modi und Modelle

​Provider-Optionen

​Konfiguration

​Erweiterte Konfiguration

​Verwandte Themen

Videogenerierung

Konfigurationsreferenz

Erste Schritte

Unterstützte Modi und Modelle

Provider-Optionen

Konfiguration

Erweiterte Konfiguration

Verwandte Themen