# Luma 多关键帧改片：在指定帧插入三次状态，检查帧号与动作过渡

多关键帧必须使用源片真实帧网格。先用ffprobe回读帧数与帧率，再让keyframes和keyframe_indexes一一对应，避免秒与帧混用。

1. 回读8秒原始片
source.mp4是作者原生24fps动态素材，先运行ffprobe，不只相信文件名。记录是否恒定帧率与总帧数；若你换成可变帧率手机片，先另存CFR练习副本。

2. 提取0/48/96帧
用extract-frames.py按帧索引提取，确认0是第一帧，48约为2秒但索引仍是48。包内三张作者状态意图标明对应帧号，没有调用Luma生成。

3. 准备三张编辑关键帧
分别设计起始蓝、中段橙、后段绿状态，保持主体和相机参照。图像与索引文件成对命名，不能只靠排序猜哪一张属于哪个时间点。

4. 构造并行数组
request-example.json中的keyframes与keyframe_indexes长度一致、索引唯一且递增。URL为实际可访问素材路径后才提交，示例LOCAL_FILE不是可直接调用的公网地址。

5. 按video.edit当前接口提交
核对官方SDK与当前任务状态轮询说明，保留实际请求响应和输出。本文不含API密钥，也未上传或消耗额度。

6. 回读实际结果目标帧
从返回片再提取目标帧，检查三个状态是否按顺序出现。额外看过渡附近，记录突然跳变、早到和延迟，不能只截最像的一帧。

7. 保存帧网格与索引
交付原片、ffprobe报告、三关键帧、请求和实际结果。原生状态渲染是意图输入，不充当Luma编辑成功证据。

验收：索引唯一且数量匹配；不把秒数直接当帧号

执行边界：未运行目标云端AI、账号核验或付费生成；原生作者材料与官方示例不充当目标结果。见asset-identity.json。

官方依据：
https://docs.agents.lumalabs.ai/guides/faq/
