mcpField
T
text-to-video

text-to-video

github.com/pexoaiクリエイティブ・メディア817109 回インストール10 週間前に更新
リポジトリ

text-to-video について

text-to-videoは、ホスト型のPexoエージェントに動画制作を依頼するスキルです。テキストや脚本から完成動画を求める場合に使え、依頼の転送と進行確認を担い、脚本、ショットごとのモデル選択、生成、音楽、字幕、トランジションはPexoが行います。

主な機能

  1. 01テキストや脚本の依頼を送信
  2. 02ユーザー素材のアップロードと参照
  3. 03非同期プロジェクトの状態確認
  4. 04プレビュー選択と修正の伝達
  5. 05完成動画リンクの取得と受け渡し

活用シーン

  1. 01文章のアイデアから公開用動画を作成
  2. 02アップロード素材を動画プロジェクトに含める
  3. 03プレビュー案を選び、結果を修正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pexoai/pexo-skills --skill text-to-video

インストール後、Claude Code で/text-to-videoを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
SETUP-CHECKLIST.md
TROUBLESHOOTING.md
scripts/
_common.sh
pexo-asset-get.sh
pexo-chat.sh
pexo-doctor.sh
pexo-entitlements.sh
pexo-project-create.sh
pexo-project-get.sh
pexo-project-list.sh
pexo-upload.sh

詳細

テキストから動画を作成 — 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 "<short brief>" → 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> "<user's exact words> <asset tags>"。ユーザーの言葉を正確にコピーし、アセットタグだけを追加します。
  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>" --choice <assetId> を実行します。document イベントの場合は、その旨をユーザーに伝えます。
    • DELIVER → pexo-asset-get.sh <project_id> <final assetId> を実行し、アセットの完全な URL をプレーンテキストでユーザーに送信します。?… 以降のクエリパラメーターをすべて含め、省略したり Markdown で囲んだりしないでください。プロジェクトリンクも送信します。
    • 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> "<their feedback>" を実行し、もう一度状況を確認します（手順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."
# Tell the user: submitted, ~15–20 min, https://pexo.ai/project/$pid
# Poll pexo-project-get.sh "$pid" until nextAction is DELIVER, then deliver the asset URL.

スクリプト

スクリプト使用方法戻り値
pexo-project-create.sh"<brief>"project_id
pexo-upload.sh<project_id> <file>asset_id
pexo-chat.sh<project_id> "<message>" [--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。

コメント

Markdown 対応