PixVerse

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

Eigenschaft	Wert
Provider-ID	`pixverse`
Plugin-Paket	`@openclaw/pixverse-provider`
Authentifizierungs-Umgebungsvariable	`PIXVERSE_API_KEY`
Onboarding-Flag	`--auth-choice pixverse-api-key`
Direktes CLI-Flag	`--pixverse-api-key <key>`
API	PixVerse Platform API v2 (Übermittlung über `video_id` plus Abfrage des Ergebnisses)
Standardmodell	`pixverse/v6`
Standard-API-Region	International

Erste Schritte

Plugin installieren

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

API-Schlüssel festlegen

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

Der Assistent fragt nach dem Endpunkt „International“ oder „CN“ (siehe API-Region unten), bevor er region und baseUrl in die Provider-Konfiguration schreibt. Bei nicht interaktiven Ausführungen (Schlüssel aus --pixverse-api-key oder PIXVERSE_API_KEY) wird standardmäßig „International“ verwendet.Das Onboarding setzt außerdem agents.defaults.mediaModels.video.primary auf pixverse/v6, wenn noch kein standardmäßiges Videomodell konfiguriert ist.

Bestehenden Standard-Provider für Videos wechseln (optional)

openclaw config set agents.defaults.mediaModels.video.primary "pixverse/v6"

Video generieren

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 Videowerkzeug von OpenClaw bereit.

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

Lokale Bildreferenzen werden vor der Bild-zu-Video-Anfrage zu PixVerse hochgeladen. URLs entfernter Bilder werden als image_url an den PixVerse-Endpunkt zum Hochladen von Bildern übergeben.

Option	Unterstützte Werte
Dauer	1-15 Sekunden (Standard: 5)
Auflösung	`360P`, `540P`, `720P`, `1080P` (Standard: `540P`; `480P`-Anfragen werden `540P` zugeordnet)
Seitenverhältnis	`16:9` (Standard), `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9`; nur Text-zu-Video, Bild-zu-Video übernimmt das Quellbild
Generiertes Audio	`audio: true`

Die PixVerse-Bildvorlagengenerierung wird noch nicht über image_generate bereitgestellt. Diese API wird über Vorlagen-IDs gesteuert, während der gemeinsame Bildgenerierungsvertrag von OpenClaw derzeit keine PixVerse-spezifische typisierte Optionssammlung besitzt.

Provider-Optionen

Der Video-Provider akzeptiert die folgenden optionalen providerspezifischen Schlüssel:

Option	Typ	Wirkung
`seed`	Zahl	Deterministischer Seed, 0 bis 2147483647
`negativePrompt` / `negative_prompt`	Zeichenfolge	Negativer Prompt
`quality`	Zeichenfolge	PixVerse-Qualität wie `720p`
`motionMode` / `motion_mode`	Zeichenfolge	Bewegungsmodus für Bild-zu-Video (Standard: `normal`)
`cameraMovement` / `camera_movement`	Zeichenfolge	PixVerse-Voreinstellung für Kamerabewegungen
`templateId` / `template_id`	Zahl	Aktivierte PixVerse-Vorlagen-ID

Konfiguration

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

Erweiterte Konfiguration

API-Region

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

Legen Sie models.providers.pixverse.region manuell fest, wenn Ihr Schlüssel zu einer bestimmten PixVerse-Plattformregion gehört, oder führen Sie openclaw onboard --auth-choice pixverse-api-key aus, um im Einrichtungsassistenten eine Region auszuwählen:

{
  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",
      },
    },
  },
}

Aufgabenabfrage

PixVerse gibt bei der Generierungsanfrage eine video_id zurück. OpenClaw fragt /openapi/v2/video/result/{video_id} alle 5 Sekunden ab, bis die Aufgabe erfolgreich abgeschlossen wird, fehlschlägt oder das Zeitlimit erreicht (Standard: 5 Minuten; mit agents.defaults.mediaModels.video.timeoutMs überschreibbar).

Videogenerierung

Gemeinsame Werkzeugparameter, Provider-Auswahl und asynchrones Verhalten.

Konfigurationsreferenz

Standardeinstellungen des Agenten einschließlich des Videogenerierungsmodells.

Overview

Concepts and configuration

Providers

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

Videogenerierung

Konfigurationsreferenz

Erste Schritte

Unterstützte Modi und Modelle

Provider-Optionen

Konfiguration

Erweiterte Konfiguration

Verwandte Themen