mcpField
V
video-batch-runner

video-batch-runner

github.com/postplusai创意与媒体271.0k 次安装今天更新
代码仓库

关于 video-batch-runner

video-batch-runner 是用于 PostPlus 视频生成请求组装与执行的技能，覆盖 Seedance 2.5 的生成模式。它依据素材角色选择端点，按当前架构校验请求，并通过发布版 postplus CLI 提交和恢复任务。

主要功能

  1. 01路由至六种生成模式
  2. 02从架构读取端点字段
  3. 03按预期角色绑定参考素材
  4. 04校验字段与时长
  5. 05通过 postplus CLI 提交和恢复
  6. 06下载已完成的结果

适用场景

  1. 01根据文本或图像生成片段
  2. 02编辑或延长现有视频
  3. 03批量处理独立片段
  4. 04恢复待处理的生成任务

安装

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

$npx skills add https://github.com/postplusai/postplus-skills --skill video-batch-runner

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

详细介绍

视频批量运行器

这是唯一的 PostPlus 视频生成技能。它负责组装创意请求，并在六种 Seedance 2.5 生成模式下执行；不要另行创建架构师、预检报告、参考素材规范或特定模型的提交器。

工作流

  1. 阅读需求说明并检查提供的媒体。只有当理解现有视频会实质性影响新渲染时，才先使用 media-analysis。
  2. 运行 postplus media schema --json，选择输入角色与任务相匹配的最精简 Seedance 2.5 端点，然后使用 postplus media schema --endpoint <endpoint> --json 加载其确切字段：
    • 没有驱动媒体：文本生成视频
    • 一张起始图像：图像/首帧生成视频
    • 锁定起始图像和结束图像：首尾帧生成视频
    • 多张用于引导结果的图像、视频或音频：参考视频
    • 更改现有视频的内容：视频编辑
    • 延续现有视频：视频延长
  3. 根据任务决定每项素材的角色。只有当素材必须控制身份、产品、首帧/尾帧、时间或动作属性时，才将其绑定到该属性。将风格和基准媒体视为灵感，并省略不应影响渲染的媒体。切勿仅因文件存在就推断其角色。
  4. 为每个片段编写一条完整、面向模型的提示词。包括可见主体及其动作、产品行为、场景、镜头、时间安排、语音/声音、连续性，以及每个提交参考素材的作用。当所选端点接受编号参考素材时，使用明确的 [image N]、[video N] 和 [audio N] 绑定。
  5. 根据当前架构验证字段、枚举值、默认值、基数和时长。不要在此技能中保留私有执行字段表。如果片段超过支持的时长或创意负荷，应在花费之前将其拆分为相互独立的提示词。
  6. 将每个本地路径、HTTPS URL、现有 PostPlus 媒体引用或数据 URI 直接传给对应的角色标志。CLI 会在一次托管提交前验证并准备本地媒体。仅使用所选端点公布的字段；不要预先上传媒体或构造私有负载。
  7. 如果预计运行时间符合命令预算，优先使用 --wait。如果创建操作仍返回待处理状态，使用 postplus media poll --handle <output.data.id> 轮询同一次运行。优先使用 CLI 为同一操作返回的动作或恢复命令。遵守其等待/恢复边界，切勿仅为检查状态而提交替代请求。
  8. 需要本地最终文件时，使用 postplus media-file download --url <fresh-output-url> --output-file <path> --skill video-batch-runner 下载已完成的输出。
  9. 生成成功后，交付原始结果、实际模型/端点、已提交的提示词和参考素材角色，以及原始运行信息。只有用户要求检查时，才检查完成的片段。生成结果的交付无需等待转录、帧提取或编辑。

执行规则

  • PostPlus 架构是判断端点可用性、输入字段、枚举值和默认值的权威依据。
  • 使用已发布的 postplus CLI。不要直接调用底层服务、编造私有字段，或创建特定服务的提交器技能。
  • 将私有请求和结果文件保存在当前工作文件夹的 .postplus/ 状态目录中；不要为交接而创建合同或规划文档。
  • 当前价格和余额确认后，所请求的任务会使用现有 PostPlus 额度执行。 仅估算的请求不会执行。额度不足时停止；不要充值、购买订阅，也不要重复执行结果不确定的付费操作。
  • 如果发生身份验证、传输、配额、请求格式错误、能力或执行失败，请报告类型化错误并停止。不要切换端点、重写请求，或声称本地计划已生成渲染结果。
  • 在批处理中，只有类型化错误 postplus_cli_hosted_media_content_policy_blocked 属于单项错误：将该项记录为已拦截，不要重写或重试，并继续处理其他独立项，同时报告未完成的项目。其他任何错误都会使批处理停止。

公共命令边界

  • 就绪检查：postplus doctor --skill video-batch-runner
  • 发现端点：postplus media schema --json
  • 读取所选端点的字段：postplus media schema --endpoint <endpoint> --json
  • 直接提交本地或远程角色媒体：postplus media create <endpoint> --skill video-batch-runner ... --wait
  • 恢复：postplus media poll --handle <output.data.id>
  • 下载：postplus media-file download --url <fresh-output-url> --output-file <path> --skill video-batch-runner
postplus media create video-seedance-2-5-text \
  --prompt "Describe the result you need" \
  --wait \
  --output ./result.json

遵循 CLI 的结构化结果和报告的后续操作；不要根据自由文本消息推断恢复方式。 需要时，请等待用户明确批准；某项操作并不代表获准消费额度、发布内容或覆盖文件。 通过返回的检查点或操作继续同一任务；切勿重新提交结果不确定的工作、重复已耗尽的恢复操作，或切换服务提供商来绕过失败。

评论

支持 Markdown