Skip to main content
OpenClaw 将 pixverse 作为官方外部插件提供，用于托管式 PixVerse 视频生成。该插件会根据 videoGenerationProviders 契约注册 pixverse 提供商。
属性值
提供商 IDpixverse
插件包@openclaw/pixverse-provider
认证环境变量PIXVERSE_API_KEY
新手引导标志--auth-choice pixverse-api-key
直接 CLI 标志--pixverse-api-key <key>
APIPixVerse Platform API v2（提交 video_id 并轮询结果）
默认模型pixverse/v6
默认 API 区域国际

​
入门指南

1

安装插件

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

设置 API key

openclaw onboard --auth-choice pixverse-api-key
向导会先提示选择国际或 CN 端点（见下方 API 区域），然后将 region 和 baseUrl 写入提供商配置。 非交互式运行（key 来自 --pixverse-api-key 或 PIXVERSE_API_KEY）默认使用国际区域。当尚未配置默认视频模型时，新手引导还会将 agents.defaults.videoGenerationModel.primary 设置为 pixverse/v6。
3

切换现有的默认视频提供商（可选）

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

生成视频

让智能体生成视频。PixVerse 会被自动使用。

​
支持的模式和模型

该提供商通过 OpenClaw 的共享视频工具公开 PixVerse 生成模型。
模式模型参考输入
文本转视频v6（默认），c1无
图像转视频v6（默认），c11 张本地或远程图像
本地图像引用会在图像转视频请求之前上传到 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
PixVerse 图像模板生成尚未通过 image_generate 暴露。该 API 由模板 ID 驱动，而 OpenClaw 的共享图像生成契约目前没有 PixVerse 专用的类型化选项包。

​
提供商选项

视频提供商接受这些可选的提供商专用键：
选项类型效果
seednumber确定性种子，0 到 2147483647
negativePrompt / negative_promptstring负向提示词
qualitystringPixVerse 质量，例如 720p
motionMode / motion_modestring图像转视频运动模式（默认 normal）
cameraMovement / camera_movementstringPixVerse 相机运动预设
templateId / template_idnumber已激活的 PixVerse 模板 ID

​
配置

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

​
高级配置

区域值PixVerse API 基础 URL
internationalhttps://app-api.pixverse.ai/openapi/v2
cnhttps://app-api.pixverseai.cn/openapi/v2
当你的 key 属于特定 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: [],
      },
    },
  },
}
只有在通过可信的兼容代理路由时，才设置 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.videoGenerationModel.timeoutMs 覆盖）。

​
相关内容

视频生成

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

配置参考

Agent 默认设置，包括视频生成模型。