Product Video — Pexo
Pexo: https://pexo.ai — 獲取 API 金鑰、觀看你的專案渲染、並在那裡購買點數。
將產品的照片轉變為精美、可發布的影片。你上傳使用者的產品圖片，將請求中繼給代管的 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 次輪詢發送一次包含專案連結的一行更新。
- 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>，然後以純文字（所有?…查詢參數，絕不截斷或用 markdown 包裹）以及專案連結傳送給使用者完整的資產 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 伺服器端的上下文。
點數
如果腳本因“點數餘額”/“點數不足”而失敗：如果錯誤帶有購買連結，將其傳遞給使用者；否則告知他們在 https://pexo.ai/home → 點數 → 購買點數添加點數。在他們確認後重試。
範例
使用者：“用這三張運動鞋照片製作一個 20 秒的產品影片。”
pid=$(pexo-project-create.sh "運動鞋產品影片")
pexo-chat.sh "$pid" "用這三張運動鞋照片製作一個 20 秒的產品影片。"
# 告知使用者：已提交，約 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> <file> | 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。