MiniMax H3 首尾帧契约

适用场景

在 MiniMax H3 首尾帧视频任务前，检查两张脱敏图片的格式、尺寸、大小、比例、端点角色和目标时长，避免把不可兼容的参考图送入 API 或本地工作流。脚本只检查元数据，不读取或上传图片。

前置条件

• - Python 3.9 或更高版本
• 一份不含原始文件路径、图片内容、密钥和个人信息的 JSON 元数据
• 用户已确认图片权利和目标平台的当前模型名、时长与分辨率能力

输入与输出

输入包含 model、duration_sec、resolution、first_frame 和 last_frame，每个画面包含 ref、format、bytes、width、height 和 short_side_px。输出目录生成 fl2va_frame_contract.json 与 fl2va_frame_contract.md。

安装或导入

保持目录结构，直接运行 scripts/check_frame_contract.py。不需要第三方包。

执行步骤

CODEBLOCK0

脚本检查 JPG、JPEG、PNG 或 WebP，单图小于 20 MB，短边大于 300 px，宽高比在 2:5 到 5:2 之间，首尾尺寸一致，并对 6 秒或 10 秒目标时长给出可复核报告。它不会下载、打开或上传图片。

错误恢复

按报告重新导出或裁切图片，并重新填写脱敏元数据。若首尾画面构图差异很大，报告不会替用户判断过渡是否自然，应在提交前人工确认主体、构图和运动路径。

权限、隐私与不可逆边界

只读取脱敏元数据，不接触图片内容，不调用 MiniMax、不创建任务、不扣费。图片权利、模型名、真实分辨率和平台限制必须由用户在实际提交前确认。

验收方法

运行示例输入，确认状态为 ready_for_review。把尾帧尺寸改成不一致或把短边改为 300，确认脚本以非零退出码阻断。