Video Ad — Pexo(ビデオ広告 — Pexo)
Pexo: https://pexo.ai — APIキーを取得し、プロジェクトのレンダリングを確認、クレジットを購入してください。
すぐに実行可能なビデオ広告を生成します。ユーザーの製品やブリーフをホストされたPexoエージェントに渡し、結果を受け取ります。Pexoがフック作成、ショット構成、モデル選定、音楽・ペーシング設定までを自動で行い、コンバージョンに最適化された動画を生成します。
あなたの役割:中継役、創造はしない
プロジェクトを作成し、ユーザーのリクエストをそのまま送信し、ポーリングし、成果物を納品します。Pexoのバックエンドがすべてのクリエイティブ作業(脚本作成、モデル選択、プロンプト、音楽)を処理します。あなたが独自の指示(ユーザーが求めていない尺・スタイル・モデルなど)を追加すると、Pexoの判断を上書きし、品質が低下します。
設定
~/.pexo/config:
PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<あなたのAPIキー>"
アカウント未登録 / 初回実行 → references/SETUP-CHECKLIST.md を読み、ユーザーを手順に沿って案内してください。このファイルには、新規ユーザーにボーナスクレジットを付与する招待コードを使ったサインアップフローと、上記の設定ファイル作成手順が記載されています。設定エラー → scripts/pexo-doctor.sh を実行し、その出力に従ってください。
ワークフロー
スクリプトはこのスキルの scripts/ ディレクトリにあります。ユーザーとはその言語で応答してください。
- プロジェクトを作成:
pexo-project-create.sh "<簡単なブリーフ>"→project_idを保存 - ユーザーから受け取ったファイルがあればアップロード:
pexo-upload.sh <project_id> <パス>→asset_idを保存し、インラインで<original-image>asset_id</original-image>(または<original-video>/<original-audio>)として参照。タグは必須です。単体のasset_idは無視されます。PexoはURLを取得できないため、ダウンロードしてからアップロードしてください。 - リクエストを送信:
pexo-chat.sh <project_id> "<ユーザーの正確な文言> <アセットタグ>"。ユーザーの言葉はそのままコピーし、アセットタグのみ追加します。 - ユーザーに伝える(その言語で): 送信しました ✓ · 約15~20分 ·
https://pexo.ai/project/<project_id> - ポーリング: 60秒以上間隔で
pexo-project-get.sh <project_id>を実行し、nextActionに応じて処理:- WAIT → ポーリングを継続。約5回のポーリングごとにプロジェクトリンクを含む1行の進捗を送信。
- RESPOND →
recentMessages内の各イベントを処理: Pexoのテキストを中継(質問があればユーザーの回答を待ち、pexo-chat.shで返信);preview_videoの場合はオプションごとにpexo-asset-get.sh <project_id> <assetId>を実行してURL(A/B/C)を表示、ユーザーに選択させ、pexo-chat.sh <project_id> "<選択>" --choice <assetId>で送信;documentイベントの場合はユーザーにその旨を伝える。 - DELIVER →
pexo-asset-get.sh <project_id> <最終assetId>を実行し、完全なアセットURL(?…のクエリパラメータを含む、マークダウンでラップしたり切り詰めたりせずに平文)とプロジェクトリンクをユーザーに送信。 - FAILED →
nextActionHintを平易な言葉で説明し、再試行を提案。 - RECONNECT →
pexo-chat.sh <project_id> "continue"を実行し、接続が切れたことを伝え再開する旨を伝えた後、ポーリングを継続。 - WAIT中に
pexo-chat.shを決して呼び出さないこと。重複した動画生成を引き起こします。 - 時間がかかりすぎる場合 → 30分以上経過してもWAITのままの場合、ユーザーに(プロジェクトリンク +
https://pexo.ai/connect/openclawとともに)時間がかかっていることを伝え、待ち続けるか停止するか尋ねてください。永遠にポーリングし続けないでください。
リビジョン
納品後、ユーザーが調整(「短くして」「新しい音楽」「違うショット」など)を依頼した場合、同じプロジェクトを再利用: pexo-chat.sh <project_id> "<フィードバック>" を実行し、再度ポーリング(手順5)してください。リビジョンで新しいプロジェクトを作成しないでください — Pexoのサーバー側のコンテキストが失われます。
クレジット
スクリプトが「Credits balance」/「Insufficient credits」エラーで失敗した場合: エラーに購入リンクが含まれていればそれをユーザーに渡し、そうでなければ https://pexo.ai/home → Credits → Buy Credits でクレジットを追加するよう伝えてください。ユーザーが確認したら再試行します。
例
ユーザー: 「新しいランニングシューズの15秒のビデオ広告を作ってください。」
pid=$(pexo-project-create.sh "running shoes ad")
pexo-chat.sh "$pid" "Make a 15-second video ad for our new running shoes."
# ユーザーに伝える: 送信しました、約15~20分、https://pexo.ai/project/$pid
# pexo-project-get.sh "$pid" をポーリングし、nextAction が DELIVER になったらアセットURLを納品。
スクリプト
| スクリプト | 使い方 | 戻り値 |
|---|---|---|
pexo-project-create.sh | "<ブリーフ>" | project_id |
pexo-upload.sh | <project_id> <ファイル> | asset_id |
pexo-chat.sh | <project_id> "<メッセージ>" [--choice <id>] | ack(非同期) |
pexo-project-get.sh | <project_id> | JSON: nextAction, recentMessages |
pexo-asset-get.sh | <project_id> <asset_id> | url を含むJSON |
pexo-doctor.sh | — | セットアップ診断 |
エラーコードとエッジケース → references/TROUBLESHOOTING.md。