Communitygithub.com

AI動画生成 — Pexo

PexoのAIエージェントを使って、テキストや画像から完成度の高い動画を生成するスキルです。あなたは指示を中継するだけで、モデル選定やプロンプト作成、編集はPexoが自動で行います。

AI動画生成 — Pexo とは?

このスキルは、Pexo(https://pexo.ai)のホステッドAIエージェントを利用して、ユーザーから与えられたテキスト・画像・スクリプトから完成した動画を生成するためのものです。ユーザーはプロジェクトを作成し、ファイルをアップロードした上で、ユーザーのリクエストをそのままPexoの中継エージェントに送信します。Pexoのバックエンドがスクリプト作成、モデル選択、プロンプト生成、音楽選定、最終的な動画アセンブルまで全てのクリエイティブ処理を行います。中継役のAIは、プロジェクト作成、アップロード、チャット送信、ポーリング、結果のユーザーへの受け渡しのみを行い、余計な指示(長さやスタイルの指定)を追加しないことが最高品質の動画出力につながります。対応プラットフォームは主にClaude CodeなどのターミナルベースのAIエージェントを想定しており、設定ファイルやスクリプト群を用いて動作します。

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

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

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

ドキュメント

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/ ディレクトリにあります。ユーザーへの応答はその言語で行ってください。

  1. プロジェクトを作成: pexo-project-create.sh "<簡単な概要>" → project_id を保存します。
  2. ユーザーから受け取ったファイルをアップロード: pexo-upload.sh <project_id> <パス> → 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> <最終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。

Individual skills in this repo

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

関連スキル