mcpField
T
text-to-video

text-to-video

github.com/pexoai创意与媒体817109 次安装10 周前更新
代码仓库

关于 text-to-video

text-to-video 是调用托管式 Pexo Agent 的视频生成 Skill，适合希望从文本或脚本得到成片的用户。它转交原始请求并跟踪项目，Pexo 负责脚本、镜头模型选择、生成及音乐、字幕和转场。

主要功能

  1. 01提交文本或脚本请求
  2. 02上传并引用用户素材
  3. 03异步轮询项目状态
  4. 04传递预览选择与修订
  5. 05获取并交付成片链接

适用场景

  1. 01将文本创意制作成可发布视频
  2. 02上传素材并将其纳入视频项目
  3. 03根据预览选择方案并修改成片

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pexoai/pexo-skills --skill text-to-video

安装后在 Claude Code 中输入/text-to-video确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
SETUP-CHECKLIST.md
TROUBLESHOOTING.md
scripts/
_common.sh
pexo-asset-get.sh
pexo-chat.sh
pexo-doctor.sh
pexo-entitlements.sh
pexo-project-create.sh
pexo-project-get.sh
pexo-project-list.sh
pexo-upload.sh

详细介绍

文本转视频 — Pexo

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

将书面提示词或脚本转换为制作完成、可直接发布的视频。你无需自行生成任何内容：只需将请求交给托管的 Pexo Agent（与 pexo-agent 使用相同的后端，专用于文本转视频），然后交付结果。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 "<short brief>" → 保存 project_id。
  2. 上传用户提供的所有文件：pexo-upload.sh <project_id> <path> → 保存 asset_id，并以内联标签 <original-image>asset_id</original-image> 引用（或使用 <original-video>／<original-audio>）。必须使用标签——单独的 asset_id 会被忽略。Pexo 无法抓取 URL——先下载，再上传。
  3. 发送请求：pexo-chat.sh <project_id> "<user's exact words> <asset tags>"。 原样复制用户的话；只能添加资源标签。
  4. 告知用户（使用其语言）：已提交 ✓ · 约 15–20 分钟 · https://pexo.ai/project/<project_id>。
  5. **轮询：**每隔 ≥60 秒运行 pexo-project-get.sh <project_id>，并根据 nextAction 采取相应操作：
    • WAIT → 继续轮询；每轮约 5 次轮询后发送一条包含项目链接的简短进度更新。
    • RESPOND → 处理 recentMessages 中的每条事件：转达 Pexo 的文本（如果 Pexo 提问，等待用户回答，然后通过 pexo-chat.sh 发送用户的回复）；对于 preview_video，针对每个选项运行 pexo-asset-get.sh <project_id> <assetId>，展示 URL（A／B／C），让用户选择，然后运行 pexo-chat.sh <project_id> "<choice>" --choice <assetId>；对于 document 事件，告知用户。
    • DELIVER → 运行 pexo-asset-get.sh <project_id> <final 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> "<their feedback>"，然后再次轮询（步骤 5）。修改时绝不要创建新项目——这会丢失 Pexo 的服务端上下文。

积分

如果脚本因 “Credits balance”／“Insufficient credits” 失败：如果错误信息包含购买链接，就转发给用户；否则告知用户前往 https://pexo.ai/home → Credits → Buy Credits 添加积分。用户确认后重试。

示例

用户：“制作一段 30 秒的视频，介绍我们的全新咖啡订阅服务。”

pid=$(pexo-project-create.sh "coffee subscription promo")
pexo-chat.sh "$pid" "Make a 30-second video about our new coffee subscription."
# Tell the user: submitted, ~15–20 min, https://pexo.ai/project/$pid
# Poll pexo-project-get.sh "$pid" until nextAction is DELIVER, then deliver the asset URL.

脚本

脚本用法返回值
pexo-project-create.sh"<brief>"project_id
pexo-upload.sh<project_id> <file>asset_id
pexo-chat.sh<project_id> "<message>" [--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。

评论

支持 Markdown