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 clawhub:@openclaw/pixverse-provider
openclaw gateway restart
2

设置 API 密钥

openclaw onboard --auth-choice pixverse-api-key
在写入 region 和 baseUrl 到提供方配置之前，向导会询问是使用国际端点 (https://app-api.pixverse.ai/openapi/v2) 还是 CN 端点 (https://app-api.pixverseai.cn/openapi/v2)。
3

将 PixVerse 设为默认视频提供方

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

生成视频

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

​
支持的模式和模型

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

​
提供方选项

视频提供方接受以下可选的提供方专属键：
选项类型作用
seednumber在支持时使用确定性种子
negativePrompt / negative_promptstring负向提示词
qualitystringPixVerse 质量，例如 720p
motionMode / motion_modestring图片生成视频运动模式
cameraMovement / camera_movementstringPixVerse 相机运动预设
templateId / template_idnumber已激活的 PixVerse 模板 id

​
配置

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

​
高级配置

OpenClaw 默认使用国际版 PixVerse API。当你的密钥属于特定的 PixVerse 平台区域时，请手动设置 models.providers.pixverse.region， 或使用 openclaw onboard --auth-choice pixverse-api-key 在设置向导中选择一个区域：
区域值PixVerse API 基础 URL
internationalhttps://app-api.pixverse.ai/openapi/v2
cnhttps://app-api.pixverseai.cn/openapi/v2
{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" 或 "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 会轮询 /openapi/v2/video/result/{video_id}，直到任务成功、失败， 或超时。

​
相关内容

视频生成

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

配置参考

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