Make a Video — 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> <最終的な 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 でクレジットを追加するよう伝えます。ユーザーが確認したら再試行します。
例
ユーザー: 「新しいコーヒーサブスクリプションの30秒動画を作って。」
pid=$(pexo-project-create.sh "coffee subscription promo")
pexo-chat.sh "$pid" "Make a 30-second video about our new coffee subscription."
# ユーザーに通知: 送信済み、約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。