快速开始
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 Platform API v2（提交 video_id 并轮询结果） |
| 默认模型 | pixverse/v6 |
| 默认 API 区域 | 国际版 |
入门指南
安装插件
openclaw plugins install @openclaw/pixverse-provideropenclaw gateway restart设置 API 密钥
openclaw onboard --auth-choice pixverse-api-key向导会先提示选择国际版或中国区端点（参见下方的 API 区域），然后将 region 和 baseUrl 写入提供商配置。
非交互式运行（密钥来自 --pixverse-api-key 或 PIXVERSE_API_KEY）默认使用国际版。
如果尚未配置默认视频模型，新手引导还会将 agents.defaults.videoGenerationModel.primary 设置为
pixverse/v6。
切换现有的默认视频提供商（可选）
openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"生成视频
让智能体生成视频。系统会自动使用 PixVerse。
支持的模式和模型
该提供商通过 OpenClaw 的共享视频工具公开 PixVerse 生成模型。
| 模式 | 模型 | 参考输入 |
|---|---|---|
| 文本生成视频 | v6（默认）、c1 |
无 |
| 图像生成视频 | v6（默认）、c1 |
1 张本地图像或远程图像 |
在发起图像生成视频请求之前，本地图像引用会上传至 PixVerse。远程图像 URL 会通过 PixVerse 图像上传端点以 image_url 传递。
| 选项 | 支持的值 |
|---|---|
| 时长 | 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 |
提供商选项
视频提供商接受以下可选的提供商专用键：
| 选项 | 类型 | 效果 |
|---|---|---|
seed |
数字 | 确定性种子，范围为 0 到 2147483647 |
negativePrompt / negative_prompt |
字符串 | 负面提示词 |
quality |
字符串 | PixVerse 质量，例如 720p |
motionMode / motion_mode |
字符串 | 图像生成视频的运动模式（默认 normal） |
cameraMovement / camera_movement |
字符串 | PixVerse 摄像机运动预设 |
templateId / template_id |
数字 | 已启用的 PixVerse 模板 ID |
配置
{ agents: { defaults: { videoGenerationModel: { 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.videoGenerationModel.timeoutMs 覆盖）。
