メインコンテンツへスキップ
OpenClaw は、ホスト型 PixVerse 動画生成用の公式外部 Plugin として pixverse を提供します。この Plugin は videoGenerationProviders contract に対して pixverse プロバイダーを登録します。
プロパティ値
プロバイダー IDpixverse
Plugin パッケージ@openclaw/pixverse-provider
認証環境変数PIXVERSE_API_KEY
オンボーディングフラグ--auth-choice pixverse-api-key
直接 CLI フラグ--pixverse-api-key <key>
APIPixVerse Platform API v2（video_id 送信と結果ポーリング）
デフォルトモデルpixverse/v6
デフォルト API リージョンInternational

​
はじめに

1

Install the plugin

openclaw plugins install clawhub:@openclaw/pixverse-provider
openclaw gateway restart
2

Set the API key

openclaw onboard --auth-choice pixverse-api-key
ウィザードは、プロバイダー設定に region と baseUrl を書き込む前に、International エンドポイント （https://app-api.pixverse.ai/openapi/v2）または CN エンドポイント （https://app-api.pixverseai.cn/openapi/v2）のどちらを使用するかを確認します。
3

Set PixVerse as the default video provider

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

Generate a video

エージェントに動画の生成を依頼します。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 は template-id 駆動ですが、OpenClaw の共有画像生成 contract には現在 PixVerse 固有の型付きオプションバッグがありません。

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

動画プロバイダーは、次の任意のプロバイダー固有キーを受け付けます。
オプション型効果
seednumberサポートされる場合の決定論的 seed
negativePrompt / negative_promptstringネガティブプロンプト
qualitystring720p などの PixVerse 品質
motionMode / motion_modestring画像から動画へのモーションモード
cameraMovement / camera_movementstringPixVerse カメラ移動プリセット
templateId / template_idnumber有効化された PixVerse template id

​
設定

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "pixverse/v6",
      },
    },
  },
}

​
高度な設定

OpenClaw はデフォルトで International 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} をポーリングします。

​
関連

Video generation

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

Configuration reference

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