@@ -9,15 +9,16 @@ read_when:
991010OpenClaw 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.
111112-| 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` |
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+| Default API region | International |
21222223## Getting started
2324@@ -41,19 +42,19 @@ OpenClaw ships a bundled `pixverse` provider for hosted PixVerse video generatio
41424243The provider exposes PixVerse generation models through OpenClaw's shared video tool.
434444-| 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 |
45+| Mode | Models | Reference input |
46+| -------------- | -------------------- | ----------------------- |
47+| Text-to-video | `v6` (default), `c1` | None |
48+| Image-to-video | `v6` (default), `c1` | 1 local or remote image |
48494950Local 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`.
505151-| 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` |
52+| Option | Supported values |
53+| --------------- | --------------------------------------------------------------------------- |
54+| Duration | 1-15 seconds |
55+| Resolution | `360P`, `540P`, `720P`, `1080P` |
56+| Aspect ratio | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` for text-to-video |
57+| Generated audio | `audio: true` |
57585859<Note>
5960PixVerse 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.
@@ -63,14 +64,14 @@ PixVerse image template generation is not exposed through `image_generate` yet.
63646465The video provider accepts these optional provider-specific keys:
656666-| 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 |
67+| Option | Type | Effect |
68+| ------------------------------------ | ------ | --------------------------------- |
69+| `seed` | number | Deterministic seed when supported |
70+| `negativePrompt` / `negative_prompt` | string | Negative prompt |
71+| `quality` | string | PixVerse quality such as `720p` |
72+| `motionMode` / `motion_mode` | string | Image-to-video motion mode |
73+| `cameraMovement` / `camera_movement` | string | PixVerse camera movement preset |
74+| `templateId` / `template_id` | number | Activated PixVerse template id |
74757576## Configuration
7677@@ -89,8 +90,27 @@ The video provider accepts these optional provider-specific keys:
8990## Advanced configuration
90919192<AccordionGroup>
93+<Accordion title="API region">
94+OpenClaw defaults to the international PixVerse API. Set `models.providers.pixverse.region`
95+when your key belongs to a specific PixVerse platform region:
96+97+```json5
98+{
99+ models: {
100+ providers: {
101+ pixverse: {
102+ region: "cn", // "international" or "cn"
103+ },
104+ },
105+ },
106+}
107+```
108+109+</Accordion>
110+92111<Accordion title="Custom base URL">
93112Set `models.providers.pixverse.baseUrl` only when routing through a trusted compatible proxy.
113+`baseUrl` takes precedence over `region`.
9411495115```json5
96116{
@@ -103,6 +123,7 @@ The video provider accepts these optional provider-specific keys:
103123 },
104124}
105125```
126+106127</Accordion>
107128108129<Accordion title="Task polling">
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。