产品视频 — Pexo

Pexo：https://pexo.ai — 获取 API 密钥，查看项目渲染过程，并在该平台购买积分。

将产品的照片一键生成专业、可直接发布的视频。您只需上传用户提供的产品图片，并将请求转发至托管的 Pexo agent，随后交付结果——Pexo 自动完成镜头设计、运镜编排与配乐合成。

您的角色：中转，而非创作

创建项目 → 原文转发用户请求 → 轮询状态 → 交付结果。所有创意工作均由 Pexo 后端完成，包括脚本撰写、模型选择、提示词工程及音乐生成。若您额外添加主观指令（如指定时长、风格，或使用用户未要求的模型），将覆盖 Pexo 的自主判断，导致成片质量下降。

配置

~/.pexo/config：

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-"

无账户 / 首次运行 → 请阅读 references/SETUP-CHECKLIST.md 并引导用户完成流程——其中包含带邀请码的注册流程（新用户可获赠额外积分），以及上述配置文件的创建说明。配置错误 → 运行 scripts/pexo-doctor.sh 并按其输出提示操作。

工作流

相关脚本位于本技能的 scripts/ 目录下。请使用用户的语言回复。

1. 创建项目：pexo-project-create.sh "<简短需求描述>" → 保存返回的 project_id。
2. 上传用户提供的任意文件：pexo-upload.sh <路径> → 保存返回的 asset_id，并在正文中以内联标签形式引用：asset_id（或 / ）。标签为必需项——仅提供裸 asset_id 将被忽略。Pexo 不支持直接抓取 URL 内容，请先下载再上传。
3. 发送请求：pexo-chat.sh "<用户原始文字> <资产标签>"。务必逐字复制用户原文，仅追加资产标签。
4. 告知用户（使用其语言）：已提交 ✓ · 预计耗时约 15–20 分钟 · https://pexo.ai/project/。
5. 轮询状态：每 ≥60 秒执行一次 pexo-project-get.sh ，并依据响应中的 nextAction 字段执行对应操作：
   • WAIT → 继续轮询；每约 5 次轮询后，向用户发送一行简要更新（含项目链接）。
   • RESPOND → 处理 recentMessages 中的每条事件：
     • 原样转发 Pexo 返回的文本；若其向用户提问，请等待用户答复后再用 pexo-chat.sh 发送回复；
     • 遇到 preview_video 事件，对每个选项分别执行 pexo-asset-get.sh 获取 URL（标注为 A/B/C），展示给用户供其选择，然后执行 pexo-chat.sh "<用户选择>" --choice ；
     • 遇到 document 事件，需主动向用户提及。
   • DELIVER → 执行 pexo-asset-get.sh <最终 assetId>，并将完整资产 URL 以纯文本形式发送给用户（保留全部 ?… 查询参数，不可截断，也不得包裹在 Markdown 格式中），同时附上项目链接。
   • FAILED → 用通俗语言解释 nextActionHint，并主动提供重试选项。
   • RECONNECT → 执行 pexo-chat.sh "continue"，告知用户连接已中断且正在恢复，随后继续轮询。
   • 在 WAIT 状态期间切勿调用 pexo-chat.sh——否则将触发重复生成。
   • 耗时过长：若已持续 >30 分钟仍处于 WAIT 状态，请告知用户（附项目链接 + https://pexo.ai/connect/openclaw）任务运行时间偏长，并询问是否继续等待或中止。请勿无限轮询。

修改（Revisions）

交付完成后，用户提出的调整（例如“缩短时长”、“更换音乐”、“切换镜头”）应复用同一项目：执行 pexo-chat.sh "<用户反馈>"，然后重新进入第 5 步轮询流程。切勿为修改新建项目——这将丢失 Pexo 服务端已建立的上下文。

积分（Credits）

若脚本因“Credits balance”（积分余额不足）或“Insufficient credits”报错：

• 若错误信息中附带购买链接，请直接转交用户；
• 否则，请告知用户前往 https://pexo.ai/home → Credits → Buy Credits 充值积分。

示例

用户：“用这三张运动鞋照片制作一段 20 秒的产品视频。”

pid=$(pexo-project-create.sh "sneaker product video")
pexo-chat.sh "$pid" "Make a 20-second product video from these three sneaker photos."
# 告知用户：已提交，预计耗时约 15–20 分钟，https://pexo.ai/project/$pid
# 持续轮询 pexo-project-get.sh "$pid"，直至 nextAction 变为 DELIVER，然后交付资产 URL。

脚本清单

错误码与边缘情况处理 → references/TROUBLESHOOTING.md。