快速开始
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 clawhub:@openclaw/pixverse-provideropenclaw gateway restart设置 API key
openclaw onboard --auth-choice pixverse-api-key向导会先询问是否使用国际版端点
(https://app-api.pixverse.ai/openapi/v2) 或 CN 端点
(https://app-api.pixverseai.cn/openapi/v2)，然后将 region 和
baseUrl 写入提供商配置。
将 PixVerse 设为默认视频提供商
openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"生成视频
要求智能体生成视频。PixVerse 会被自动使用。
支持的模式和模型
该提供商通过 OpenClaw 的共享视频工具公开 PixVerse 生成模型。
| 模式 | 模型 | 参考输入 |
|---|---|---|
| 文本到视频 | v6（默认），c1 |
无 |
| 图像到视频 | v6（默认），c1 |
1 张本地或远程图像 |
本地图像引用会先上传到 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 |
提供商选项
视频提供商接受以下可选的提供商专用键：
| 选项 | 类型 | 效果 |
|---|---|---|
seed |
number | 支持时使用的确定性种子 |
negativePrompt / negative_prompt |
string | 负向提示词 |
quality |
string | PixVerse 质量，例如 720p |
motionMode / motion_mode |
string | 图像到视频运动模式 |
cameraMovement / camera_movement |
string | PixVerse 相机运动预设 |
templateId / template_id |
number | 已激活的 PixVerse 模板 ID |
配置
{ agents: { defaults: { videoGenerationModel: { primary: "pixverse/v6", }, }, },}高级配置
API 区域
OpenClaw 默认使用国际版 PixVerse API。当你的 key 属于特定 PixVerse 平台区域时，可以手动设置 models.providers.pixverse.region，或使用
openclaw onboard --auth-choice pixverse-api-key 在设置向导中选择：
| 区域值 | PixVerse API 基础 URL |
|---|---|
international |
https://app-api.pixverse.ai/openapi/v2 |
cn |
https://app-api.pixverseai.cn/openapi/v2 |
{ 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 会轮询
/openapi/v2/video/result/{video_id}，直到任务成功、失败或超时。
相关
Was this useful?
