Providers
PixVerse
OpenClaw 提供 pixverse 作為官方外部外掛，用於託管式 PixVerse 影片生成。此外掛會依據 videoGenerationProviders 合約註冊 pixverse 提供者。
| 屬性 | 值 |
|---|---|
| 提供者 ID | pixverse |
| 外掛套件 | @openclaw/pixverse-provider |
| 驗證環境變數 | PIXVERSE_API_KEY |
| 初始設定旗標 | --auth-choice pixverse-api-key |
| 直接命令列介面旗標 | --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.mediaModels.video.primary 設為
pixverse/v6。
切換現有的預設影片提供者（選用）
openclaw config set agents.defaults.mediaModels.video.primary "pixverse/v6"生成影片
要求代理程式生成影片。系統會自動使用 PixVerse。
支援的模式與模型
此提供者透過 OpenClaw 的共用影片工具提供 PixVerse 生成模型。
| 模式 | 模型 | 參考輸入 |
|---|---|---|
| 文字轉影片 | v6（預設）、c1 |
無 |
| 圖片轉影片 | v6（預設）、c1 |
1 張本機或遠端圖片 |
本機圖片參考會在圖片轉影片請求前上傳至 PixVerse。遠端圖片 URL 則會以 image_url 傳送至 PixVerse 圖片上傳端點。
| 選項 | 支援的值 |
|---|---|
| 時長 | 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
只有透過受信任且相容的 Proxy 路由時，才設定 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.mediaModels.video.timeoutMs 覆寫）。
