跳轉到主要內容
OpenClaw 提供 pixverse 作為官方外部外掛，用於託管的 PixVerse 影片生成。此外掛會依據 videoGenerationProviders 合約註冊 pixverse 提供者。
屬性值
提供者 IDpixverse
外掛套件@openclaw/pixverse-provider
驗證環境變數PIXVERSE_API_KEY
導覽設定旗標--auth-choice pixverse-api-key
直接命令列介面旗標--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
精靈會先詢問要使用國際端點 (https://app-api.pixverse.ai/openapi/v2) 或 CN 端點 (https://app-api.pixverseai.cn/openapi/v2)，再將 region 和 baseUrl 寫入提供者設定。
3

將 PixVerse 設為預設影片提供者

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

生成影片

要求代理生成影片。PixVerse 會自動被使用。

​
支援的模式與模型

提供者會透過 OpenClaw 的共用影片工具公開 PixVerse 生成模型。
模式模型參考輸入
文字轉影片v6（預設）、c1無
圖片轉影片v6（預設）、c11 張本機或遠端圖片
本機圖片參考會先上傳到 PixVerse，再發出圖片轉影片請求。遠端圖片 URL 會透過 PixVerse 圖片上傳端點以 image_url 傳遞。
選項支援的值
時長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 由範本 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" 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 會輪詢 /openapi/v2/video/result/{video_id}，直到任務成功、失敗或逾時。

​
相關

影片生成

共用工具參數、提供者選擇與非同步行為。

設定參考

代理預設設定，包括影片生成模型。