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