用途:把商品照片做成可发布的商品视频。用户提供商品图片(Pexo 无法抓取 URL,需先下载再上传),由托管于 Pexo 的智能体完成脚本、模型选择、提示词与音乐等创作工作。使用者的角色是转交与跟进,而非自行创作。
配置:在 ~/.pexo/config 中设置 PEXO_BASE_URL="https://pexo.ai" 与 PEXO_API_KEY="sk-<your-api-key>",API key 与积分在 https://pexo.ai 获取。首次使用或未注册时按 references/SETUP-CHECKLIST.md 引导注册;配置出错运行 scripts/pexo-doctor.sh。
用法:用 pexo-project-create.sh "<short brief>" 创建项目并保存 project_id;用 pexo-upload.sh <project_id> <path> 上传素材,需以内联标签 <original-image>asset_id</original-image>(或 original-video、original-audio)引用,裸 asset_id 会被忽略;用 pexo-chat.sh <project_id> "<用户原话> <素材标签>" 逐字转交请求;每 60 秒以上运行 pexo-project-get.sh <project_id> 轮询并按 nextAction 处理:WAIT 继续轮询、RESPOND 转达文本或让用户选择预览方案(--choice <assetId>)、DELIVER 用 pexo-asset-get.sh 取回完整素材 URL 并以纯文本给用户、FAILED 解释 nextActionHint 并可重试、RECONNECT 发送 "continue" 后继续轮询。WAIT 期间切勿调用 pexo-chat.sh,否则会重复生产。
修改:交付后用户的新要求复用同一项目,再次 pexo-chat.sh 并轮询,不要新建项目。积分不足时按错误提示的购买链接或到 pexo.ai 的 Credits 购买后重试。若超过 30 分钟仍为 WAIT,可告知用户并询问是否继续等待。错误码与边界情况见 references/TROUBLESHOOTING.md。