视频重构帧（Reframe video）

取一段已完成的视频片段，将其置于一个不同宽高比的新画布上，再由模型自动延展原始画面未覆盖的区域，以填满整个新画布。例如，一条横屏主素材可被重构为适用于社交平台的竖屏版本，或适配信息流的正方形版本——过程中无需裁剪主体内容，因为模型会智能生成新边缘区域。这是一种“外绘式（outpaint-style）”边缘生成技术，区别于 edit-video（该操作仅调整画面视觉风格，且保持原始宽高比不变），也不同于普通裁剪（会直接丢弃像素）。

需收集的输入项

• 源视频（URL 或上传文件）。即待重构帧的原始视频片段。
• 目标宽高比 / 画布尺寸（例如：16:9 → 9:16，或 1:1）。该参数决定新输出的 width 和 height。
• 新扩展区域的内容描述。一段简短说明，用于指示画面延伸方向上的环境内容（例如：“上方为天空，下方为海面”，“左侧延伸出更多街道”）。该提示词将直接影响模型对边缘区域的生成效果。
• 可选：源视频在新画布中的位置（若非居中放置），可用于将新增空间偏向某一侧边缘。
• 可选：目标分辨率等级（360p 至 1080p）。

所用模型

• Luma Ray 3.2（luma:ray@3.2）——本任务专用模型。支持通过 inputs.video 输入视频，并在不同宽高比的新画布上进行重构；同时支持 settings.sourcePosition 参数控制源视频在画布中的定位。调用前请务必确认其状态为 live，并使用 runware-models 与 runware-run 技能检查其完整 schema。切勿硬编码已过时的模型选择。
• 当前暂无通用回退模型用于视频重构帧。若该能力不可用，替代方案仅为简单裁剪（会导致主体丢失）或在相同宽高比画布上做帧扩展（参见“技巧”章节）。

工作流程

1. 通过 runware-run 解析模型 schema，确认其是否支持 inputs.video、支持的 width/height 组合列表，以及 settings.sourcePosition 的结构定义。
2. 上传源视频，或将视频 URL 填入 inputs.video 字段。
3. 异步调用 videoInference：该接口立即返回一个 taskUUID，随后需轮询 getResponse 直至任务完成。视频重构帧属于耗时型视频任务，切勿在同步调用中阻塞等待。
4. 将 width 和 height 设置为一组支持的目标宽高比组合（必须与源视频宽高比不同）。
5. 撰写提示词，明确指出新扩展区域应延续的内容，确保模型沿原场景自然延展，而非凭空生成无关内容。
6. 从响应中的 videoURL 获取结果视频。审阅扩展边缘区域的表现；若延展效果偏离预期，可尝试使用更精确的提示词，或调整 sourcePosition 后重试。

技巧

• 明确命名新扩展区域的内容。 重构帧提示词应具体描述待延展的周边环境（例如：“延续灯塔上方的天空与下方的海面，匹配原始画面的光照与运动特征”），从而引导模型延续原有场景，而非随意猜测。提示词的重要性与画布设定同等关键。
• 从支持的宽高比组合中选择新画布尺寸。 width/height 必须是 Ray 3.2 实际支持的输出尺寸（与图像/视频生成所用尺寸集一致），对应分辨率等级为 360p 至 1080p。请选择宽高比匹配目标需求的组合（例如：9:16 对应 720 × 1280；1:1 对应 960 × 960）。
• 确保主体远离待扩展的边缘区域。 当主体远离即将延展的画布边缘时，模型拥有最大发挥空间，重构效果更可靠。
• 通过 sourcePosition 控制扩展方向。 默认情况下，源视频居中置于新画布。使用 settings.sourcePosition 可覆盖默认行为，其中 x、y、width、height 均以**画布比例分数**表示（取值范围为 0.0–1.0）。将源视频推向某一边缘，模型将在相反方向生成扩展内容（例如：增大 x 将源视频右移，使左侧生成新的海面；增大 y 将源视频下移，使顶部生成更多天空）。
• 缩小源视频尺寸以实现全向延展，而非仅转换宽高比。 将 sourcePosition 中的 width 和 height 设为小于 1.0 的值（例如：仅保留中间 60% 区域），模型将围绕原始区域完整生成四周扩展内容。此举可将重构帧转化为任意画布（包括同宽高比画布）上的帧扩展操作。
• 将重构帧作为最终步骤执行。 首先使用 edit-video 锁定画面视觉风格，再对处理后的结果执行重构帧，确保延展的是已具备理想观感的视频素材。

关键参数说明

• inputs.video —— 源视频（URL 或 base64 编码字符串）。必填项。
• width / height —— 新画布尺寸。必须为模型支持的宽高组合，且建议与源视频宽高比不同。输出分辨率等级覆盖 360p 至 1080p。
• positivePrompt —— 描述新扩展区域应延续的内容。该提示词主导边缘生成逻辑。
• settings.sourcePosition —— 结构为 { x, y, width, height }，各项均为画布比例分数（0.0–1.0）。启用该参数时，四个字段均需提供。x/y 控制源视频位置，width/height 控制其缩放尺寸；当 width/height 小于 1.0 时，模型将在源视频周围填充扩展内容。
• 重构帧仅支持标准动态范围（SDR）输出，按秒计费。请通过 runware-models 或预演调用（runware-run）确认具体资费标准。
• 务必依据最新 schema（runware-run）核对字段名称及当前支持的宽高组合，切勿凭经验猜测。

质量标准

• 输出视频严格符合指定的目标宽高比，且原始主体内容完整保留，无任何裁剪。
• 扩展边缘区域延续原始场景（光照、运动、内容风格一致），不出现无关或臆造内容。
• 原始区域内画面运动保持稳定，不受重构帧过程干扰。
• 若扩展区域出现偏差，应优化提示词以更精准描述周边环境，或调整 sourcePosition 使扩展空间出现在期望位置。

相关技能

runware-run、runware-models、runware-prompting；edit-video（在源宽高比下调整画面视觉风格，为本操作的并列功能），建议先在此环节锁定画面风格，再执行重构帧作为最终步骤。