SaaSビデオ — Pexo は何をしますか？

Pexo: https://pexo.ai — APIキーを取得し、プロジェクトのレンダリングを確認し、クレジットを購入してください。

完成したSaaSデモ動画または解説動画を作成します。ソフトウェアの説明文、URL、スクリーンショットをホストされている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/ ディレクトリにあります。ユーザーにはその言語で返信してください。

プロジェクトを作成: pexo-project-create.sh "<短い概要>" → project_id を保存します。
ユーザーから受け取ったファイルをアップロード: pexo-upload.sh <project_id> <path> → 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をプレーンテキストで送信します（?… のクエリパラメータを含め、切り詰めたり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> "<フィードバック>" を実行し、再度ポーリングします（ステップ5）。改訂のために新しいプロジェクトを作成しないでください。Pexoのサーバー側のコンテキストが失われます。

クレジット

「Credits balance」/「Insufficient credits」というエラーでスクリプトが失敗した場合: エラーに購入リンクが含まれていればそれをユーザーに渡し、それ以外の場合は https://pexo.ai/home → Credits → Buy Credits でクレジットを追加するよう伝えてください。ユーザーが確認したら再試行します。

例

ユーザー: 「経費報告書を自動化するSaaSの60秒デモ動画を作ってください。」

pid=$(pexo-project-create.sh "SaaSデモ動画")
pexo-chat.sh "$pid" "経費報告書を自動化するSaaSの60秒デモ動画を作ってください。"
# ユーザーに伝える: 送信しました、約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>`	`url` を含むJSON
`pexo-doctor.sh`	—	セットアップ診断

エラーコードとエッジケース → references/TROUBLESHOOTING.md。

SaaSビデオ — Pexo