产品视频 — 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>，然后以纯文本形式发送完整的资产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服务端的上下文。

积分

如果脚本因“积分余额不足”/“积分不够”失败：如果错误信息中携带了购买链接，请将其传递给用户；否则告知用户在 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

产品视频 — Pexo