PixVerse Video Generation Setup

OpenClaw ships pixverse as an officially maintained external plugin for hosted PixVerse video creation. Through this plugin, the pixverse provider gets registered 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

Getting started

Install the plugin

openclaw plugins install @openclaw/pixverse-provider
openclaw gateway restart

Set the API key

openclaw onboard --auth-choice pixverse-api-key

Before writing region and baseUrl into the provider config, the wizard asks you to pick either the International or CN endpoint (details in the API region section below). When running non-interactively, with the key sourced from --pixverse-api-key or PIXVERSE_API_KEY, International is assumed.

Additionally, onboarding sets agents.defaults.mediaModels.video.primary to pixverse/v6 whenever no default video model has been configured.

Switch an existing default video provider (optional)

openclaw config set agents.defaults.mediaModels.video.primary "pixverse/v6"

Generate a video

Just ask the agent to produce a video, and PixVerse gets picked automatically.

Supported modes and models

Through OpenClaw's shared video tool, the provider surfaces PixVerse generation models.

Mode	Models	Reference input
Text-to-video	`v6` (default), `c1`	None
Image-to-video	`v6` (default), `c1`	1 local or remote image

For image-to-video requests, local image references get uploaded to PixVerse first. Remote image URLs, on the other hand, go through the PixVerse image upload endpoint as image_url.

Option	Supported values
Duration	1-15 seconds (default 5)
Resolution	`360P`, `540P`, `720P`, `1080P` (default `540P`; `480P` requests map to `540P`)
Aspect ratio	`16:9` (default), `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9`; text-to-video only, image-to-video follows the source image
Generated audio	`audio: true`

Note

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.

Provider options

These optional provider-specific keys are accepted by the video provider:

Option	Type	Effect
`seed`	number	Deterministic seed, 0 to 2147483647
`negativePrompt` / `negative_prompt`	string	Negative prompt
`quality`	string	PixVerse quality such as `720p`
`motionMode` / `motion_mode`	string	Image-to-video motion mode (default `normal`)
`cameraMovement` / `camera_movement`	string	PixVerse camera movement preset
`templateId` / `template_id`	number	Activated PixVerse template id

Configuration

{
  agents: {
    defaults: {
      mediaModels: {
        video: {
          primary: "pixverse/v6",
        },
      },
    },
  },
}

Advanced configuration

API region

Region value	PixVerse API base URL
`international`	`https://app-api.pixverse.ai/openapi/v2`
`cn`	`https://app-api.pixverseai.cn/openapi/v2`

When your key belongs to a specific PixVerse platform region, assign models.providers.pixverse.region manually, or execute openclaw onboard --auth-choice pixverse-api-key within the setup wizard to pick one:

{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" or "cn"
        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
        models: [],
      },
    },
  },
}

Custom base URL

Only set models.providers.pixverse.baseUrl if you are routing through a trusted compatible proxy. baseUrl overrides region.

{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}

Task polling

The generation request yields a video_id from PixVerse. OpenClaw checks /openapi/v2/video/result/{video_id} at 5-second intervals until the task completes, fails, or reaches the timeout, which defaults to 5 minutes and can be adjusted via agents.defaults.mediaModels.video.timeoutMs.

Video generation, Common tool parameters, provider choice, and asynchronous handling.
Configuration reference, Default agent settings, including the video generation model.