Communitygithub.com

商品ビデオ — Pexo

商品の写真を、公開可能な洗練されたビデオに変換します。Pexo エージェントに画像をアップロードし、リクエストを中継して結果を受け取ります。

商品ビデオ — Pexo とは?

商品ビデオ(Pexo)は、開発者やAIエージェントが商品写真をプロ品質の動画に変換できるスキルです。Pexo.ai のホステッドエージェントを活用し、ユーザーが提供した画像と指示をそのまま中継することで、スクリプト作成、モデル選択、音楽、動きといったすべてのクリエイティブ作業をPexoのバックエンドが自動で処理します。主にClaude CodeやCodexなどのターミナルベースのエージェント向けに設計されており、スクリプト群(pexo-project-create, pexo-upload, pexo-chat, pexo-project-get, pexo-asset-get)を使ってプロジェクト作成、ファイルアップロード、リクエスト送信、進捗ポーリング、最終アセット取得を行います。ポーリング中はnextActionに応じて待機、応答、納品、失敗、再接続を適切に処理し、納品後は同じプロジェクトで修正依頼を受け付けます。クレジット不足やエラー時にはトラブルシューティング用のスクリプトや参照ドキュメントを提供し、ユーザーがスムーズに利用を開始できるようサポートします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pexoai/pexo-skills/tree/main/skills/product-video

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

商品ビデオ — 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/ にあります。ユーザーにはその言語で応答してください。

  1. プロジェクトを作成: pexo-project-create.sh "<簡単な概要>" → project_id を保存します。
  2. ユーザーから提供されたファイルをアップロード: pexo-upload.sh <project_id> <path> → asset_id を保存し、インラインで <original-image>asset_id</original-image>(または <original-video> / <original-audio>)として参照します。タグは必須です — 裸の asset_id は無視されます。PexoはURLをクロールできません — ダウンロードしてからアップロードしてください。
  3. リクエストを送信: pexo-chat.sh <project_id> "<ユーザーの正確な文言> <アセットタグ>"。ユーザーの言葉をそのままコピーし、アセットタグのみ追加してください。
  4. ユーザーに伝える(その言語で): 送信完了 ✓ · 約15~20分 · https://pexo.ai/project/<project_id>。
  5. ポーリング: 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。

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

関連スキル