用途:通过 Pexo 托管智能体制作竖屏 9:16、以开头 3 秒钩子为核心的 YouTube Shorts。用户只需给出主题,Pexo 负责写脚本、生成镜头、配乐与字幕并合成成片。
主要能力:创建项目、上传用户提供的图片/视频/音频素材、发送请求、轮询项目状态、获取预览与最终成片、基于同一项目做修改。
使用方式:先在 ~/.pexo/config 配置 PEXO_BASE_URL="https://pexo.ai" 与 PEXO_API_KEY="sk-<your-api-key>";无账号时按 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> 等标签内联引用(裸 asset_id 会被忽略,Pexo 不能抓取 URL,需先下载再上传);用 pexo-chat.sh <project_id> "<用户原话> <asset tags>" 原样转发用户请求,不要自行添加时长、风格或模型等指令;告知用户已提交、约 15–20 分钟及项目链接;每 ≥60 秒运行 pexo-project-get.sh <project_id>,按 nextAction 处理:WAIT 继续轮询(每约 5 次发一行进度),RESPOND 处理 recentMessages(转发文本、用 pexo-asset-get.sh 取预览并让用户选 A/B/C 后以 --choice 回复、提及文档事件),DELIVER 用 pexo-asset-get.sh 取最终素材并把完整 URL(含全部查询参数,纯文本不截断)与项目链接发给用户,FAILED 解释 nextActionHint 并询问是否重试,RECONNECT 发送 "continue" 后继续轮询。WAIT 期间切勿调用 pexo-chat.sh,否则会重复生产。超过 30 分钟仍 WAIT 时告知用户并询问是否继续等待。修改复用同一 project_id,不要新建项目。额度不足时按错误中的购买链接或前往 https://pexo.ai/home → Credits → Buy Credits 充值后重试。
适用场景:需要快速产出可发布的竖屏 Shorts,且希望由托管智能体完成全部创意工作。
限制:技能本身不创作内容,只做转发与交付;不能抓取 URL;必须使用素材标签;轮询间隔与超时需遵守上述规则;错误码与边界情况见 references/TROUBLESHOOTING.md。