Pexo Agent 是一个 AI 视频生成技能，可接入 Claude Code 及其他 AI 编程智能体，覆盖从自然语言描述到成片视频的完整制作管线，包括脚本、分镜、逐镜头生成、音乐、字幕、口型同步与最终合成。它的定位是让用户无需提示词工程、无需视频剪辑，即可获得可直接发布的成品视频。
一、用途 Pexo 面向需要快速产出视频内容的场景，典型用途包括：从产品照片或 URL 生成产品视频广告；根据文本描述制作 TikTok、Instagram Reels 和 YouTube Shorts；制作风格一致、带转场的多镜头品牌视频；根据脚本生成带 TTS 旁白的解说视频；从产品目录批量生成电商视频内容；为 A/B 测试生成营销视频变体。
二、主要能力
- 自动模型选择：Pexo 根据镜头内容类型自动挑选最合适的视频模型，无需用户判断使用哪个模型，涵盖 Seedance 2、Kling 3.0、HappyHorse 等 10 余个模型，并随新模型发布持续增加。
- 完整制作管线：从脚本、故事板、逐镜头生成，到音乐、字幕、口型同步和最终合成，输出的是成片视频而非原始片段。
- 五种输入类型：文生视频、图生视频、URL 生视频（抓取页面）、脚本生视频、音频生视频。
- 格式与时长：支持 5–120 秒，画幅比例包括 16:9（横屏）、9:16（竖屏，适配 TikTok、Reels、Shorts）、1:1（方形）。
- 后期能力：AI 音乐、TTS 旁白、声音克隆、口型同步、字幕、转场。
- 制作时长参考：15 秒 3 镜头视频约 8 分钟；60 秒品牌视频约 20 分钟。
- 支持的素材格式：图片 jpg、png、webp、bmp、tiff、heic；视频 mp4、mov、avi；音频 mp3、wav、aac、m4a、ogg、flac。
三、使用方式 前置配置：在 ~/.pexo/config 中设置 PEXO_BASE_URL="https://pexo.ai" 与 PEXO_API_KEY="sk-<your-api-key>"。首次使用或遇到配置错误时运行 pexo-doctor.sh 并按输出处理，详见 references/SETUP-CHECKLIST.md。
核心脚本：pexo-project-create.sh [project_name]（创建项目，返回 project_id）；pexo-project-list.sh（列出项目）；pexo-project-get.sh <project_id>（获取 nextAction、nextActionHint、recentMessages）；pexo-upload.sh <project_id> <file_path>（上传素材，返回 asset_id）；pexo-chat.sh <project_id> <message> [--choice <id>] [--timeout <s>]（向 Pexo 发送消息）；pexo-asset-get.sh <project_id> <asset_id>（获取素材与视频 url）；pexo-entitlements.sh（查询积分与套餐）；pexo-doctor.sh（诊断报告）。
典型流程：创建项目 → 上传素材（如有）→ 原样转发用户消息（仅附加资源标签）→ 通知用户已提交、预计时长与项目链接 https://pexo.ai/project/{project_id} → 每 60 秒轮询 pexo-project-get.sh → 按 nextAction 处理（WAIT 继续轮询；RESPOND 转达消息或展示预览选项；DELIVER 交付成片；FAILED 处理失败；RECONNECT 重连）→ 交付时在 recentMessages 中找到 final_video 事件，用 pexo-asset-get.sh 取回 url 并以纯文本完整发送。
素材引用需使用强制标签：<original-image>asset-id</original-image>、<original-video>asset-id</original-video>、<original-audio>asset-id</original-audio>，裸 asset ID 会被忽略。Pexo 无法抓取网页 URL，用户若提供文件链接，应先下载再上传。
四、适用场景与限制 适用于产品广告、社媒短视频、多镜头品牌视频、脚本解说、电商批量内容与营销变体测试。使用时需注意：轮询期间只能调用 pexo-project-get.sh，WAIT 期间调用 pexo-chat.sh 会触发重复制作；每条发给 Pexo 的消息都会消耗 token，建议合并信息；交付 URL 必须完整包含查询参数，截断或 Markdown 包裹会导致 403 或链接失效；若 30 分钟后仍为 WAIT，应暂停轮询并询问用户。积分不足时按错误信息中的购买链接处理，或引导用户访问 https://pexo.ai/home → 右上角 Credits → Buy Credits → Extra Credits，充值后重试失败步骤。费用、价格与官方文档中未提供的其他细节暂未提供。