PixVerse

OpenClaw 提供 OpenClawpixverse 作为用于托管的 PixVerse 视频生成的官方外部插件。该插件根据 videoGenerationProviders 合约注册 pixverse 提供商。

属性	值
提供商 ID	`pixverse`
插件包	`@openclaw/pixverse-provider`
认证环境变量	`PIXVERSE_API_KEY`
新手引导标志	`--auth-choice pixverse-api-key`
直接 CLI 标志	`--pixverse-api-key <key>`
API	PixVerse 平台 API v2（API`video_id` 提交以及结果轮询）
默认模型	`pixverse/v6`
默认 API 区域	国际

入门指南

安装插件

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

API设置 API 密钥
Terminal window
```
openclaw onboard --auth-choice pixverse-api-key
```
向导会询问是使用国际端点 (https://app-api.pixverse.ai/openapi/v2) 还是 CN 端点 (https://app-api.pixverseai.cn/openapi/v2)，然后再将 region 和 baseUrl 写入提供商配置。

将 PixVerse 设置为默认视频提供商

openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"

生成视频
要求代理生成视频。将自动使用 PixVerse。

支持的模式和模型

该提供商通过 OpenClaw 的共享视频工具提供 PixVerse 生成模型。

模式	模型	参考输入
Text-to-video	`v6`（默认），`c1`	无
Image-to-video	`v6` (默认), `c1`	1 张本地或远程图片

在发起图生视频请求之前，本地图片引用会上传到 PixVerse。远程图片 URL 会作为 image_url 传递给 PixVerse 图片上传端点。

选项	支持的值
持续时间	1-15 秒
分辨率	`360P`, `540P`, `720P`, `1080P`
宽高比	`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` 用于文生视频
生成的音频	`audio: true`

提供商选项

视频提供商接受这些可选的特定于提供商的键：

选项	类型	效果
`seed`	number	受支持时的确定性种子
`negativePrompt` / `negative_prompt`	string	负面提示词
`quality`	string	PixVerse 质量，例如 `720p`
`motionMode` / `motion_mode`	string	图生视频动态模式
`cameraMovement` / `camera_movement`	string	PixVerse 镜头移动预设
`templateId` / `template_id`	number	激活的 PixVerse 模板 ID

配置

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "pixverse/v6",
      },
    },
  },
}

高级配置

APIAPI 区域

OpenClaw 默认使用国际版 PixVerse API。当您的密钥属于特定的 PixVerse 平台区域时，请手动设置 models.providers.pixverse.region ，或在设置向导中使用 openclaw onboard --auth-choice pixverse-api-keyAPI 选择一个区域：

区域值	PixVerse API 基础 URL
`international`	`https://app-api.pixverse.ai/openapi/v2`
`cn`	`https://app-api.pixverseai.cn/openapi/v2`

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

自定义基础 URL

仅在通过受信任的兼容代理进行路由时才设置 models.providers.pixverse.baseUrl。 baseUrl 优先于 region。

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

任务轮询

PixVerse 从生成请求返回一个 video_idOpenClaw。OpenClaw 会轮询 /openapi/v2/video/result/{video_id} 直到任务成功、失败或超时。