scenario-runway

Scenario Runway Video

概述

Scenario 中的 Runway 系列按用途分为两类：Gen4.5 根据文本或首帧图像生成新片段；Aleph 2 改写现有素材，只更改提示词中指定的内容，同时保留动作、音频和结构。使用 search 发现这两类模型；model_schema_get 提供参数规范。

连接与核心流程：使用 scenario skill；与模型无关的视频工作：使用 scenario-video skill。如果你可用的 skill 中缺少此处提及的配套 skill，请让用户安装它（npx skills add scenario-labs/skills --skill <name>）；若无人值守，则根据工具架构继续操作，并标记这一缺失。

快速参考

模式由输入决定（名称和上限以实时架构为准）：

模式	输入	行为
文本（Gen4.5）	prompt	按照 aspectRatio 生成；duration 为 2 到 10 秒
首帧（Gen4.5）	image + prompt	以该帧开场；duration 范围相同；忽略 aspectRatio
编辑（Aleph 2）	video + prompt	改写视觉内容；保留动作、音频和结构

编写本文时，Aleph 对源视频的限制为 30 秒和 16 MB，这是两项独立限制：高码率片段会先达到文件大小上限。其成本中位数约为 Gen4.5 的 6 倍，最高可达 15 倍，具体取决于源视频：请先对准确的载荷执行 dry_run。延迟中位数接近 6 分钟，因此 jobs_wait 会在任务进行中超时；请使用 pending_job_ids 再次调用。

Gen4.5 提示词应符合模式

文本模式需要同时描述视觉内容和动作。首帧已确定主体、构图和色彩，因此应将提示词全部用于描述动作、镜头和氛围。明确写出动作顺序（“跪下，然后站起，摄影机向上摇升”），并为包含多个动作段落的提示词设置 8 到 10 秒的 duration。用直白的语言说明镜头运动（固定镜头、摇摄、推轨、跟拍、环绕、升降），每个片段描述一到两种，并使用现在时。

aspectRatio 接受像素比例对（"1280:720"、"960:960"），且在编写本文时，文本模式仅支持 16:9 和 9:16 的比例对；其他画幅（1:1、4:3、3:4、21:9）应通过具有相应比例的首帧生成。

Aleph 只更改你明确指定的内容

Aleph 提示词应说明要进行的编辑：移除、替换、重新设计风格或重新布光。未指定的所有内容都会保留，包括动作和音频：Aleph 无法重新编排动作或添加镜头运动；必须更改动作时，请使用 Gen4.5 生成。最多可指定 5 张参考图像来引导编辑：keyframes 使用 seconds 或 at（0 到 1 之间的比例值）设置每张图像（uri）的位置；promptImage 使用 positionType 加 timestampSeconds 或 positionPercentage 设置位置。这些数组是两种替代方案，不能同时使用。

完整示例：替换实拍视频中的产品

1. 使用 target="models"、query="runway"、public=true 执行 search，例如，编辑时使用 model_runway-aleph-2，生成时使用 model_runway-gen4-5（编写本文时的实时搜索结果：每次会话都应重新查找）。
2. 进行其他操作前，先使用 Aleph id 执行 model_schema_get。
3. 将超过上限的源视频剪辑或压缩（参见 scenario-video）；使用 upload_asset 上传视频片段和产品静帧（参见 scenario skill）。
4. 使用 dry_run=true 和准确的 parameters={"prompt": "Replace the soda can with the bottle from the reference image. Keep everything else unchanged.", "video": "asset_clip", "keyframes": [{"uri": "asset_bottle", "at": 0}]} 执行 model_run； 每次剪辑后都要重新估算。
5. 使用 wait=false 再次执行，然后对返回的任务 id 调用 jobs_wait，并使用 pending_job_ids 重新调用；超时不代表失败，也绝不是再次执行 model_run 的理由。
6. 使用 asset_display 查看输出；检查每个镜头中的替换效果是否一致。

常见错误

• 同时传入 keyframes 和 promptImage：二者互斥，只能选一个。
• 在图像模式提示词中重复描述第一帧：改为描述运动和镜头。
• 将 aspectRatio 设为 "16:9" 或与 image 一起传入：只能使用像素对，且第一帧会覆盖它。
• 要求 Aleph 添加新的运动或镜头移动：按设计，源素材中的运动会持续保留。