pixverse 作为官方外部插件提供，用于托管的 PixVerse 视频生成。该插件会在 videoGenerationProviders 合约上注册 pixverse 提供方。
开始使用
1
安装插件
2
设置 API 密钥
region 和 baseUrl 写入提供商配置之前，提示选择国际或 CN 端点（见下方 API 区域）。
非交互式运行（通过 --pixverse-api-key 或 PIXVERSE_API_KEY 获取密钥）默认使用 International。如果尚未配置默认视频模型，引导流程还会将 agents.defaults.mediaModels.video.primary 设置为
pixverse/v6。3
切换现有的默认视频提供商（可选）
4
生成视频
让代理生成一个视频。PixVerse 将自动被使用。
支持的模式和模型
该提供方通过 OpenClaw 的共享视频工具暴露 PixVerse 生成模型。
本地图片引用会在图片生成视频请求之前上传到 PixVerse。远程图片 URL 会作为
image_url 传递到 PixVerse 图片上传端点。
PixVerse 图片模板生成功能尚未通过
image_generate 暴露。该 API 由 template-id 驱动，而 OpenClaw 的共享图片生成合约目前没有 PixVerse 专用的类型化选项包。提供方选项
视频提供方接受以下可选的提供方专属键：配置
高级配置
API 区域
API 区域
当你的密钥属于某个特定的 PixVerse 平台区域时，请手动设置
models.providers.pixverse.region，
或运行 openclaw onboard --auth-choice pixverse-api-key，在设置向导中选择一个：自定义基础 URL
自定义基础 URL
仅当通过受信任的兼容代理路由时，才设置
models.providers.pixverse.baseUrl。
baseUrl 的优先级高于 region。任务轮询
任务轮询
PixVerse 会在生成请求中返回一个
video_id。OpenClaw 每 5 秒轮询一次
/openapi/v2/video/result/{video_id}，直到任务成功、失败或达到超时（默认为 5 分钟；可通过
agents.defaults.mediaModels.video.timeoutMs 覆盖）。相关内容
视频生成
共享工具参数、提供方选择和异步行为。
配置参考
包括视频生成模型在内的代理默认设置。