商品ビデオ — Pexo は何をしますか?
Pexo: https://pexo.ai — APIキーを取得し、プロジェクトのレンダリング状況を確認、クレジットの購入を行ってください。
商品の写真を、公開可能な洗練されたビデオに変換します。ユーザーの商品画像をアップロードし、リクエストをホストされたPexoエージェントに中継して結果を提供します — Pexoがショット、動き、音楽を構成します。
あなたの役割: 中継、創造ではない
プロジェクトを作成し、ユーザーのリクエストをそのまま送信し、ポーリングして納品します。Pexoのバックエンドがすべてのクリエイティブ作業(脚本作成、モデル選択、プロンプト、音楽)を担当します。あなたが独自の指示(ユーザーが求めていない長さ、スタイル、モデル)を追加すると、Pexoの判断が上書きされ、品質が低下します。
設定
~/.pexo/config:
PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<your-api-key>"
アカウントがない / 初回実行時 → references/SETUP-CHECKLIST.md を読み、ユーザーをその手順に沿って案内してください — サインアップフローと新規ユーザーにボーナスクレジットを付与する招待コード、および上記設定ファイルの作成方法が記載されています。設定エラー時 → scripts/pexo-doctor.sh を実行し、その出力に従ってください。
ワークフロー
スクリプトはこのスキルの scripts/ にあります。ユーザーにはその言語で応答してください。
- プロジェクトを作成:
pexo-project-create.sh "<簡単な概要>"→project_idを保存します。 - ユーザーから提供されたファイルをアップロード:
pexo-upload.sh <project_id> <path>→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> <final 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 でクレジットを追加するよう伝えてください。ユーザーが確認した後に再試行します。
例
ユーザー: 「この3枚のスニーカーの写真から20秒の商品ビデオを作って。」
pid=$(pexo-project-create.sh "スニーカー商品ビデオ")
pexo-chat.sh "$pid" "この3枚のスニーカーの写真から20秒の商品ビデオを作って。"
# ユーザーに伝える: 送信完了、約15~20分、https://pexo.ai/project/$pid
# nextActionがDELIVERになるまで pexo-project-get.sh "$pid" をポーリングし、アセットURLを納品
スクリプト
| スクリプト | 使用法 | 戻り値 |
|---|---|---|
pexo-project-create.sh | "<概要>" | project_id |
pexo-upload.sh | <project_id> <ファイル> | asset_id |
pexo-chat.sh | <project_id> "<メッセージ>" [--choice <id>] | 確認応答(非同期) |
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。