Communitygithub.com

文本转视频

将文字提示或脚本转换为可直接发布的视频。Pexo后端负责所有创意工作——脚本撰写、模型选择、配乐、字幕和过渡效果——你只需转发用户的请求并交付结果。

文本转视频 是什么?

该技能是一个面向AI智能体的文本转视频工具,基于Pexo平台(https://pexo.ai)运行。智能体无需自行生成任何内容,只需创建项目、上传用户提供的文件、将用户的请求原样转发给Pexo后端,然后轮询直到视频交付。Pexo负责全部创意流程:撰写脚本、为每个镜头选择最佳模型、生成所有镜头、添加配乐、字幕和过渡效果。智能体的角色仅限于中继——不添加自己的指导意见,以免覆盖Pexo的判断。工作流包括创建项目、上传文件(如有)、发送请求、告知用户提交成功(约15-20分钟),然后每60秒轮询一次,根据`nextAction`状态(WAIT、RESPOND、DELIVER、FAILED、RECONNECT)执行相应操作。交付后用户可针对同一项目提出修改意见(如“缩短”、“换音乐”),直接复用已有项目上下文。该技能支持Cline、Claude Code、Cursor、Windsurf、GitHub Copilot、Codex CLI等平台。

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

在你喜欢的 AI 中提问

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

文档

文本转视频 — Pexo

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

将文字提示或脚本转换为可直接发布的视频。你无需自行生成任何内容:只需将请求交给托管的Pexo智能体(与pexo-agent相同的后端,限定为文本转视频范围),然后交付结果。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服务器端的上下文。

积分

如果脚本失败并显示“Credits balance” / “Insufficient credits”:如果错误中附有购买链接,将其转发给用户;否则告知用户在 https://pexo.ai/home → Credits → Buy Credits 添加积分。用户确认后重试。

示例

用户:“制作一个关于我们新咖啡订阅服务的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.

相关技能