Make a Video — Pexo 视频生成 是做什么的?
Pexo: https://pexo.ai — 在此处获取 API 密钥、查看项目渲染进度以及购买积分。
根据用户的一句话想法制作完整视频。您将用户的请求一字不差地传递给托管的 Pexo 代理,并交付结果——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> <路径>→ 保存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> <最终 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 → 积分 → 购买积分。用户确认后重试。
示例
用户:“制作一个关于我们新咖啡订阅的30秒视频。”
pid=$(pexo-project-create.sh "咖啡订阅推广")
pexo-chat.sh "$pid" "制作一个关于我们新咖啡订阅的30秒视频。"
# 告知用户:已提交,约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> <文件> | 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。