Communitygithub.com

AI视频生成 — Pexo

通过Pexo平台,将用户提供的文本、图片或脚本转译为成品视频,代理后端自动处理所有创意工作。

AI视频生成 — Pexo 是什么?

该技能允许AI代理(如Claude Code、Cursor)将用户的请求(文本、图片或脚本)通过Pexo平台生成完整的视频。代理只需将请求原样转发给Pexo托管的代理,后者负责脚本编写、模型选择、提示词生成和音乐匹配等所有创造性工作。 技能支持以下工作流:创建项目、上传文件(需先下载后上传,Pexo无法抓取URL)、发送用户请求、轮询状态直至交付。轮询过程中需根据返回的nextAction(WAIT、RESPOND、DELIVER、FAILED、RECONNECT)执行相应操作,例如在RESPOND时处理预览视频选择或文档事件,在DELIVER时返回完整的资产URL。 用户可通过同一项目进行修订(如调整时长、换音乐、换镜头),这能保留Pexo端上下文。当积分不足时,技能会引导用户购买积分。技能还提供了完整的脚本集和配置指南,确保从新手到高级用户都能快速上手。

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

在你喜欢的 AI 中提问

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

文档

AI视频生成 — Pexo 是做什么的?

Pexo: https://pexo.ai — 获取API密钥,查看项目渲染,购买积分。

根据用户提供的任何内容(文本、图片或脚本)生成一个成品视频。你只需将请求转发给托管的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服务端的上下文。

积分

如果脚本因“Credits balance”/“Insufficient credits”失败:如果错误信息包含购买链接,将其传递给用户;否则告知用户在 https://pexo.ai/home → Credits → Buy Credits 处添加积分。用户确认后重试。

示例

用户:“生成一个20秒的AI视频,介绍我们的效率应用。”

pid=$(pexo-project-create.sh "AI视频应用介绍")
pexo-chat.sh "$pid" "生成一个20秒的AI视频,介绍我们的效率应用。"
# 告知用户:已提交,约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.

相关技能