Communitygithub.com

テキストから動画へ — Pexo

プロンプトやスクリプトを、公開可能な高品質動画に変換します。スクリプト作成、モデル選択、音楽、字幕、トランジションをPexoのエージェントが自動処理します。

テキストから動画へ — Pexo とは?

このスキルは、ユーザーが提供したテキストプロンプトやスクリプトを、公開可能な完成動画に変換するためのAIエージェントスキルです。ユーザー自身が動画の生成や編集作業を行う必要はなく、Pexoのホスト型エージェント(`pexo-agent`のテキスト-to-動画特化版)に全てを委任します。Pexoがスクリプトの作成、ショットごとに最適なモデルの選択、各ショットの生成、音楽や字幕、トランジションの追加を自動で行います。このスキルはClaude Code、Cursor、CodexなどのAIエージェントプラットフォームで利用でき、`pexo-project-create.sh`、`pexo-chat.sh`、`pexo-project-get.sh`、`pexo-asset-get.sh`、`pexo-upload.sh`、`pexo-doctor.sh`といった専用スクリプトを通じてPexo APIと連携します。ユーザーの役割は、プロジェクトの作成、リクエストの転送、結果のポーリング、そして最終アセットの提供のみです。リビジョン(修正要求)は同じプロジェクトIDを再利用することで、Pexoサーバー側のコンテキストを保持し、効率的な編集を可能にします。また、クレジット残高不足や接続エラーなどのエッジケースにも対応する手順が用意されています。

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

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

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

ドキュメント

テキストから動画へ — Pexo は何をしますか?

Pexo: https://pexo.ai — APIキーを取得し、プロジェクトのレンダリングを確認、クレジットを購入できます。

書かれたプロンプトやスクリプトを、公開可能な完成動画に変換します。自分で何かを生成する必要はありません。リクエストをホスト型のPexoエージェント(pexo-agentと同じバックエンド、テキストから動画用にスコープ指定)に渡し、結果を受け取るだけです。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> <パス> → 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 でクレジットを追加するよう伝えます。ユーザーが確認したら再試行します。

例

ユーザー: 「新しいコーヒーサブスクリプションについて30秒の動画を作って」

pid=$(pexo-project-create.sh "coffee subscription promo")
pexo-chat.sh "$pid" "新しいコーヒーサブスクリプションについて30秒の動画を作って。"
# ユーザーに伝える: 送信済み、約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.

関連スキル