Skip to main content
OpenClaw は、ホスト型 PixVerse 動画生成用の公式外部 Plugin として pixverse を提供します。この Plugin は、videoGenerationProviders コントラクトに対して pixverse プロバイダーを登録します。

​
はじめに

1

Plugin をインストール

2

API キーを設定

ウィザードは、プロバイダー設定に region と baseUrl を書き込む前に、International または 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 はテンプレート ID によって駆動されますが、OpenClaw の共有画像生成コントラクトには現在、PixVerse 固有の型付きオプションバッグがありません。

​
プロバイダーオプション

動画プロバイダーでは、次のプロバイダー固有のキーを任意で指定できます。

​
設定

​
高度な設定

キーが特定の PixVerse プラットフォームリージョンに属する場合は、 models.providers.pixverse.region を手動で設定するか、 openclaw onboard --auth-choice pixverse-api-key を実行してセットアップウィザードで選択します。
信頼できる互換プロキシを経由してルーティングする場合にのみ、models.providers.pixverse.baseUrl を設定します。 baseUrl は region より優先されます。
PixVerse は生成リクエストから video_id を返します。OpenClaw は、 タスクが成功、失敗、またはタイムアウトするまで、5 秒ごとに /openapi/v2/video/result/{video_id} をポーリングします（デフォルトは 5 分。agents.defaults.mediaModels.video.timeoutMs で上書きできます）。

​
関連項目

動画生成

共有ツールのパラメーター、プロバイダーの選択、非同期動作。

設定リファレンス

動画生成モデルを含むエージェントのデフォルト設定。