PixVerse

OpenClaw 提供 pixverse 作为托管的 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（提交 `video_id` 并轮询结果）
默认模型	`pixverse/v6`
默认 API 区域	国际区域

快速开始¶

1. 安装插件

openclaw plugins install @openclaw/pixverse-provider

安装会自动应用于正在运行的 Gateway；否则将在下次启动时生效。参见应用更改并检查。

2. 设置 API 密钥

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

向导会提示选择国际或中国端点（参见下面的 API 区域），然后再将 region 和 baseUrl 写入提供方配置。非交互式运行（通过 --pixverse-api-key 或 PIXVERSE_API_KEY 提供密钥）默认使用国际区域。

引导流程还会在尚未配置默认视频模型时，将 agents.defaults.mediaModels.video.primary 设置为 pixverse/v6。

3. 切换现有的默认视频提供方（可选）

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

4. 生成视频

让代理生成一个视频。将自动使用 PixVerse。

支持的模式和模型¶

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

模式	模型	参考输入
文本转视频	`v6`（默认）、`c1`	无
图像转视频	`v6`（默认）、`c1`	1 张本地或远程图像

本地图像引用会在图像转视频请求之前上传到 PixVerse。远程图像 URL 会作为 image_url 通过 PixVerse 图像上传端点传递。

选项	支持的值
时长	1-15 秒（默认 5）
分辨率	`360P`、`540P`、`720P`、`1080P`（默认 `540P`；`480P` 请求映射为 `540P`）
宽高比	`16:9`（默认）、`4:3`、`1:1`、`3:4`、`9:16`、`2:3`、`3:2`、`21:9`；仅文本转视频，图像转视频跟随源图像
生成音频	`audio: true`

Note

PixVerse 图像模板生成不会通过 image_generate 暴露。该 API 由模板 ID 驱动，而 OpenClaw 的共享图像生成契约没有 PixVerse 专属的类型化选项包。

提供方选项¶

视频提供方接受以下可选的提供方专属键：

选项	类型	作用
`seed`	number	确定性种子，0 到 2147483647
`negativePrompt` / `negative_prompt`	string	负面提示词
`quality`	string	PixVerse 质量，例如 `720p`
`motionMode` / `motion_mode`	string	图像转视频运动模式（默认 `normal`）
`cameraMovement` / `camera_movement`	string	PixVerse 摄像机运动预设
`templateId` / `template_id`	number	已激活的 PixVerse 模板 ID

配置¶

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

高级配置¶

API 区域

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

当你的密钥属于特定的 PixVerse 平台区域时，请手动设置 models.providers.pixverse.region；或者运行 openclaw onboard --auth-choice pixverse-api-key 在设置向导中选择一个区域：

{
  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_id。OpenClaw 每 5 秒轮询一次 /openapi/v2/video/result/{video_id}，直到任务成功、失败或达到超时时间（默认 5 分钟；可通过 agents.defaults.mediaModels.video.timeoutMs 覆盖）。

视频生成

共享工具参数、提供商选择和异步行为。

配置参考

包括视频生成模型在内的 Agent 默认设置。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw