Providers
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 |
| Auth-Umgebungsvariable | PIXVERSE_API_KEY |
| Onboarding-Flag | --auth-choice pixverse-api-key |
| Direktes CLI-Flag | --pixverse-api-key <key> |
| API | PixVerse Platform API v2 (Übermittlung einer video_id mit anschließender Ergebnisabfrage) |
| Standardmodell | pixverse/v6 |
| Standard-API-Region | International |
Erste Schritte
Plugin installieren
openclaw plugins install @openclaw/pixverse-provideropenclaw gateway restartAPI-Schlüssel festlegen
openclaw onboard --auth-choice pixverse-api-keyDer Assistent fragt nach dem Endpunkt International oder CN (siehe
API-Region unten), bevor er region und baseUrl in die
Provider-Konfiguration schreibt. Nicht interaktive Ausführungen (Schlüssel
aus --pixverse-api-key oder PIXVERSE_API_KEY) verwenden standardmäßig
International.
Das Onboarding setzt außerdem agents.defaults.videoGenerationModel.primary
auf pixverse/v6, wenn noch kein Standard-Videomodell konfiguriert ist.
Vorhandenen Standard-Provider für Videos wechseln (optional)
openclaw config set agents.defaults.videoGenerationModel.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; Anfragen für 480P 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 Seitenverhältnis des Quellbilds |
| Generiertes Audio | audio: true |
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 | Voreinstellung für die PixVerse-Kamerabewegung |
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" oder "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; kann mit
agents.defaults.videoGenerationModel.timeoutMs überschrieben werden).
