@@ -0,0 +1,124 @@
1+---
2+summary: "PixVerse video generation setup in OpenClaw"
3+title: "PixVerse"
4+read_when:
5+ - You want to use PixVerse video generation in OpenClaw
6+ - You need the PixVerse API key/env setup
7+ - You want to make PixVerse the default video provider
8+---
9+10+OpenClaw ships a bundled `pixverse` provider for hosted PixVerse video generation. The plugin is enabled by default and registers the `pixverse` provider against the `videoGenerationProviders` contract.
11+12+| Property | Value |
13+| --------------- | --------------------------------------------------------------------- |
14+| Provider id | `pixverse` |
15+| Plugin | bundled, `enabledByDefault: true` |
16+| Auth env var | `PIXVERSE_API_KEY` |
17+| Onboarding flag | `--auth-choice pixverse-api-key` |
18+| Direct CLI flag | `--pixverse-api-key <key>` |
19+| API | PixVerse Platform API v2 (`video_id` submission plus result polling) |
20+| Default model | `pixverse/v6` |
21+22+## Getting started
23+24+<Steps>
25+<Step title="Set the API key">
26+```bash
27+openclaw onboard --auth-choice pixverse-api-key
28+```
29+</Step>
30+<Step title="Set PixVerse as the default video provider">
31+```bash
32+openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"
33+```
34+</Step>
35+<Step title="Generate a video">
36+Ask the agent to generate a video. PixVerse will be used automatically.
37+</Step>
38+</Steps>
39+40+## Supported modes and models
41+42+The provider exposes PixVerse generation models through OpenClaw's shared video tool.
43+44+| Mode | Models | Reference input |
45+| -------------- | ---------------------- | ----------------------- |
46+| Text-to-video | `v6` (default), `c1` | None |
47+| Image-to-video | `v6` (default), `c1` | 1 local or remote image |
48+49+Local image references are uploaded to PixVerse before the image-to-video request. Remote image URLs are passed through the PixVerse image upload endpoint as `image_url`.
50+51+| Option | Supported values |
52+| ------------- | ----------------------------------------------------- |
53+| Duration | 1-15 seconds |
54+| Resolution | `360P`, `540P`, `720P`, `1080P` |
55+| Aspect ratio | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` for text-to-video |
56+| Generated audio | `audio: true` |
57+58+<Note>
59+PixVerse image template generation is not exposed through `image_generate` yet. That API is template-id driven, while OpenClaw's shared image-generation contract does not currently have a PixVerse-specific typed option bag.
60+</Note>
61+62+## Provider options
63+64+The video provider accepts these optional provider-specific keys:
65+66+| Option | Type | Effect |
67+| ------------------------------ | -------- | -------------------------------------- |
68+| `seed` | number | Deterministic seed when supported |
69+| `negativePrompt` / `negative_prompt` | string | Negative prompt |
70+| `quality` | string | PixVerse quality such as `720p` |
71+| `motionMode` / `motion_mode` | string | Image-to-video motion mode |
72+| `cameraMovement` / `camera_movement` | string | PixVerse camera movement preset |
73+| `templateId` / `template_id` | number | Activated PixVerse template id |
74+75+## Configuration
76+77+```json5
78+{
79+ agents: {
80+ defaults: {
81+ videoGenerationModel: {
82+ primary: "pixverse/v6",
83+ },
84+ },
85+ },
86+}
87+```
88+89+## Advanced configuration
90+91+<AccordionGroup>
92+<Accordion title="Custom base URL">
93+Set `models.providers.pixverse.baseUrl` only when routing through a trusted compatible proxy.
94+95+```json5
96+{
97+ models: {
98+ providers: {
99+ pixverse: {
100+ baseUrl: "https://app-api.pixverse.ai/openapi/v2",
101+ },
102+ },
103+ },
104+}
105+```
106+</Accordion>
107+108+<Accordion title="Task polling">
109+PixVerse returns a `video_id` from the generation request. OpenClaw polls
110+`/openapi/v2/video/result/{video_id}` until the task succeeds, fails,
111+or times out.
112+</Accordion>
113+</AccordionGroup>
114+115+## Related
116+117+<CardGroup cols={2}>
118+<Card title="Video generation" href="/tools/video-generation" icon="video">
119+Shared tool parameters, provider selection, and async behavior.
120+</Card>
121+<Card title="Configuration reference" href="/gateway/config-agents#agent-defaults" icon="gear">
122+Agent default settings including video generation model.
123+</Card>
124+</CardGroup>
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。