docs/providers/pixverse.md
OpenClaw provides pixverse as an official external plugin for hosted PixVerse video generation. The plugin registers the pixverse provider against the videoGenerationProviders contract.
| Property | Value |
|---|---|
| Provider id | pixverse |
| Plugin package | @openclaw/pixverse-provider |
| Auth env var | PIXVERSE_API_KEY |
| Onboarding flag | --auth-choice pixverse-api-key |
| Direct CLI flag | --pixverse-api-key <key> |
| API | PixVerse Platform API v2 (video_id submission plus result polling) |
| Default model | pixverse/v6 |
| Default API region | International |
The wizard asks whether to use the International endpoint
(`https://app-api.pixverse.ai/openapi/v2`) or the CN endpoint
(`https://app-api.pixverseai.cn/openapi/v2`) before writing `region` and
`baseUrl` into the provider config.
The provider exposes PixVerse generation models through OpenClaw's shared video tool.
| Mode | Models | Reference input |
|---|---|---|
| Text-to-video | v6 (default), c1 | None |
| Image-to-video | v6 (default), c1 | 1 local or remote image |
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.
| Option | Supported values |
|---|---|
| Duration | 1-15 seconds |
| Resolution | 360P, 540P, 720P, 1080P |
| Aspect ratio | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 for text-to-video |
| Generated audio | audio: true |
The video provider accepts these optional provider-specific keys:
| Option | Type | Effect |
|---|---|---|
seed | number | Deterministic seed when supported |
negativePrompt / negative_prompt | string | Negative prompt |
quality | string | PixVerse quality such as 720p |
motionMode / motion_mode | string | Image-to-video motion mode |
cameraMovement / camera_movement | string | PixVerse camera movement preset |
templateId / template_id | number | Activated PixVerse template id |
{
agents: {
defaults: {
videoGenerationModel: {
primary: "pixverse/v6",
},
},
},
}
| Region value | PixVerse API base URL |
| --------------- | --------------------------------------------- |
| `international` | `https://app-api.pixverse.ai/openapi/v2` |
| `cn` | `https://app-api.pixverseai.cn/openapi/v2` |
```json5
{
models: {
providers: {
pixverse: {
region: "cn", // "international" or "cn"
baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
models: [],
},
},
},
}
```
```json5
{
models: {
providers: {
pixverse: {
baseUrl: "https://app-api.pixverse.ai/openapi/v2",
},
},
},
}
```