--- read_when: - OpenClaw で PixVerse の動画生成を使用したい場合 - PixVerse API キー／環境変数の設定が必要です - PixVerse をデフォルトの動画プロバイダーに設定する場合 summary: OpenClaw での PixVerse 動画生成のセットアップ title: PixVerse x-i18n: generated_at: "2026-07-26T09:42:37Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 32 provider: openai source_hash: 3dba881e877e3da4677a40dff736cb46de114337a1e0338ef8220dcd8e616f46 source_path: providers/pixverse.md workflow: 16 --- OpenClaw は、ホスト型 PixVerse 動画生成用の公式外部 Plugin として `pixverse` を提供します。この Plugin は、`videoGenerationProviders` コントラクトに対して `pixverse` プロバイダーを登録します。 | プロパティ | 値 | | ------------------ | -------------------------------------------------------------------- | | プロバイダー ID | `pixverse` | | Plugin パッケージ | `@openclaw/pixverse-provider` | | 認証環境変数 | `PIXVERSE_API_KEY` | | オンボーディングフラグ | `--auth-choice pixverse-api-key` | | 直接指定する CLI フラグ | `--pixverse-api-key ` | | API | PixVerse Platform API v2（`video_id` の送信と結果のポーリング） | | デフォルトモデル | `pixverse/v6` | | デフォルト API リージョン | International | ## はじめに ```bash openclaw plugins install @openclaw/pixverse-provider openclaw gateway restart ``` ```bash openclaw onboard --auth-choice pixverse-api-key ``` ウィザードは、プロバイダー設定に `region` と `baseUrl` を書き込む前に、International または CN エンドポイント（下記の「API リージョン」を参照）の選択を求めます。 非対話実行（`--pixverse-api-key` または `PIXVERSE_API_KEY` からキーを取得）では、 デフォルトで International が使用されます。 オンボーディングでは、デフォルトの動画モデルがまだ設定されていない場合、 `agents.defaults.mediaModels.video.primary` も `pixverse/v6` に設定されます。 ```bash 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` | PixVerse の画像テンプレート生成は、まだ `image_generate` を通じて公開されていません。この API はテンプレート ID によって駆動されますが、OpenClaw の共有画像生成コントラクトには現在、PixVerse 固有の型付きオプションバッグがありません。 ## プロバイダーオプション 動画プロバイダーでは、次のプロバイダー固有のキーを任意で指定できます。 | オプション | 型 | 効果 | | ------------------------------------ | ------ | --------------------------------------------- | | `seed` | number | 決定論的シード（0～2147483647） | | `negativePrompt` / `negative_prompt` | string | ネガティブプロンプト | | `quality` | string | `720p` などの PixVerse 品質 | | `motionMode` / `motion_mode` | string | 画像から動画へのモーションモード（デフォルト `normal`） | | `cameraMovement` / `camera_movement` | string | PixVerse のカメラ移動プリセット | | `templateId` / `template_id` | number | 有効化する PixVerse テンプレート ID | ## 設定 ```json5 { agents: { defaults: { videoGenerationModel: { primary: "pixverse/v6", }, }, }, } ``` ## 高度な設定 | リージョン値 | 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` を実行してセットアップウィザードで選択します。 ```json5 { models: { providers: { pixverse: { region: "cn", // "international" or "cn" baseUrl: "https://app-api.pixverseai.cn/openapi/v2", models: [], }, }, }, } ``` 信頼できる互換プロキシを経由してルーティングする場合にのみ、`models.providers.pixverse.baseUrl` を設定します。 `baseUrl` は `region` より優先されます。 ```json5 { 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` で上書きできます）。 ## 関連項目 共有ツールのパラメーター、プロバイダーの選択、非同期動作。 動画生成モデルを含むエージェントのデフォルト設定。