AI動画生成 — Pexo は何をしますか?
Pexo: https://pexo.ai — APIキーを取得し、プロジェクトのレンダリングを確認し、クレジットを購入できます。
ユーザーから与えられたテキスト、画像、スクリプトから、AIを使って完成した動画を生成します。 リクエストをホステッド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 でクレジットを追加するよう伝えてください。ユーザーが確認したら再試行します。
例
ユーザー: 「私たちのプロダクティビティアプリを紹介する20秒のAI動画を生成してください。」
pid=$(pexo-project-create.sh "AI動画アプリ紹介")
pexo-chat.sh "$pid" "Generate a 20-second AI video introducing our productivity app."
# ユーザーに伝える: 送信完了、約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>] | 応答確認(非同期) |
pexo-project-get.sh | <project_id> | JSON: nextAction, recentMessages |
pexo-asset-get.sh | <project_id> <asset_id> | JSON(url を含む) |
pexo-doctor.sh | — | セットアップ診断 |
エラーコードとエッジケース → references/TROUBLESHOOTING.md。