技能介绍

要解决的问题

调用 RunwayML Gen-3 Alpha 这类异步视频生成 API 时，实际写代码的痛点往往不在发请求本身，而在三件事：一是文本到视频、图像到视频两种模式的请求参数组织方式不同，容易在工程里散落不一致的样板代码；二是生成任务不是即时返回的，需要轮询任务状态、处理排队与失败的中间态；三是多个片段产出后还要做合并与落盘，涉及 FFmpeg 的调用时机和产物管理。这个技能就是把这些步骤收敛成一个可复用的调用流程。

技能如何工作

核心能力围绕 Gen-3 Alpha API 展开：

双模式合成：支持 text-to-video（文本到视频）与 image-to-video（图像到视频）两种输入路径
任务生命周期管理：提交生成任务后进入轮询流程，跟踪任务状态直到完成或失败
输出拼接：任务完成后通过 FFmpeg 对生成的片段做拼接处理，得到最终可用的视频产物

典型的调用链路是：组装输入（文本或图像）→ 调用 API 创建生成任务 → 轮询任务状态 → 任务成功后拉取产物 → 用 FFmpeg 完成片段拼接与输出。对使用者来说，只需要关注输入素材和最终产物，中间的任务跟踪与合成细节由技能封装。

适用边界与注意点

需要注意，目前 SKILL.md 中没有自动提取到有来源支撑的安装和使用说明，也就是说上游并未提供经过验证的部署文档。在正式环境或敏感工作流中使用前，建议先通读上游仓库 https://github.com/1991513ccie-png/skills 的实际代码与说明，确认参数、轮询策略和 FFmpeg 调用方式符合你的场景后再接入。另外，API 侧的计费、限流和生成时长限制取决于 RunwayML 当时的服务条款，集成时应当自行核对。