Communitygithub.com

图片转视频

上传静态图片,通过 Pexo 的 AI 代理自动生成包含动态、音乐和剪辑的完整视频。

图片转视频 是什么?

该技能允许 AI 代理将用户提供的静态图片转化为完整的视频。代理只需创建一个项目,将用户的原始请求(包括图片标签)逐字传递给 Pexo 托管的 AI 代理,然后轮询结果即可。Pexo 的后端处理所有的创意工作——脚本编写、模型选择、提示词和音乐——因此代理不应添加自己的指令(如时长或风格),以避免影响输出质量。技能提供了清晰的脚本工作流,包括创建项目、上传文件、发送请求和轮询直至交付,并特别处理了失败、连接中断和长时间等待等边缘情况。交付后,用户的修改可复用同一项目,以保留服务器端的上下文。支持 Pexo、Claude Code、Cursor、Codex 等平台。

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

在你喜欢的 AI 中提问

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

文档

图片转视频 — Pexo

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

让静态图片动起来,变成完整的视频。您上传用户的图片,将请求交给托管的 Pexo 代理,然后交付结果——Pexo 负责添加运动、镜头移动、音乐,并组装最终片段。

您的角色:中继,而非创作

创建项目,逐字发送用户的请求,轮询,交付。Pexo 的后端处理所有创意工作——脚本编写、模型选择、提示词、音乐。添加您自己的指令(用户未要求的时长、风格、模型)会覆盖其判断,产生更差的视频。

配置

~/.pexo/config:

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<您的API密钥>"

没有账户 / 首次运行 → 阅读 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 → 积分 → 购买积分处添加积分。在用户确认后重试。

示例

用户:“将此产品照片动画化为 10 秒片段,带缓慢缩放。”

pid=$(pexo-project-create.sh "animate product photo")
pexo-chat.sh "$pid" "Animate this product photo into a 10-second clip with a slow zoom."
# 告知用户:已提交,约 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.

相关技能