Communitygithub.com

Make a Video — Pexo 视频生成

将用户的自然语言请求直接转发给 Pexo 托管的 AI 代理,自动完成脚本、镜头选择、模型、音乐和剪辑,最终交付完整视频。

Make a Video — Pexo 视频生成 是什么?

该技能让 AI 代理作为中继层,将用户的原始视频需求(如“制作一个30秒的咖啡订阅推广视频”)一字不差地传递给 Pexo 平台的托管后端,由后者端到端完成所有创意工作——包括脚本撰写、镜头选择、模型调用、音乐适配和视频剪辑。AI 代理只负责项目管理:创建项目、上传用户提供的文件(图片/视频/音频,需使用正确的标签引用)、发送请求后持续轮询状态。轮询过程会智能处理 WAIT(等待)、RESPOND(响应反馈、预览视频选择)、DELIVER(交付最终视频 URL)和 FAILED(失败重试)等状态。交付后的修改请求会在同一项目内复用,无需重建,从而保留服务器端上下文。支持基于 Claude Code 等主流 AI 代理工作流,通过脚本实现与 Pexo API 的交互,并提供了配置与故障排查指南。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pexoai/pexo-skills/tree/main/skills/make-a-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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/ 目录下。使用用户的母语回复。

  1. 创建项目: pexo-project-create.sh "<简短说明>" → 保存 project_id。
  2. 上传用户提供的任何文件: pexo-upload.sh <project_id> <路径> → 保存 asset_id,以内联方式引用,如 <original-image>asset_id</original-image>(或 <original-video> / <original-audio>)。标签是必需的——单独的 asset_id 会被忽略。Pexo 无法爬取 URL——请先下载,然后上传。
  3. 发送请求: pexo-chat.sh <project_id> "<用户的确切文字> <资产标签>"。 完全复制用户的原文;仅添加资产标签。
  4. 告知用户(使用他们的语言):已提交 ✓ · 约15–20分钟 · https://pexo.ai/project/<project_id>。
  5. 轮询: 每隔至少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。

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

相关技能