MP4 Video to Prompt：分析私有参考视频
使用 MP4 Video to Prompt 工作流上传本地素材、逐镜校对分析结果，并在没有公开链接的情况下整理出可复用的 AI 视频制作简报。
MP4 Video to Prompt 适合不应该公开出现在网址上的参考素材，例如客户样片、内部粗剪、未发布广告、手机拍摄片段和私有创意测试。登录用户可以在 Copy Video 上传 MP4，分析其中可见的制作选择，并得到与公开参考一致的结构化提示词。
“私有素材”不等于“可以无条件上传”。开始 MP4 Video to Prompt 前，必须确认团队有权处理视频，并判断项目协议是否允许使用外部 AI 服务。下面会同时解释创作流程和文件背后的技术路径，让团队知道素材经过了哪些环节。
什么时候应该选择 MP4
当素材只在本地、尚未发布、无法通过稳定公开链接访问，或只允许团队内部使用时，可以选择 MP4 Video to Prompt。典型场景包括客户授权但不可公开的参考、需要整理镜头描述的粗剪、用于规划正式重拍的手机素材、发布前产品演示，以及用于建立内部提示词库的视觉测试。
如果素材本来就是公开且稳定的 YouTube 视频，优先使用链接。不要因为拿到了文件，就把十分钟公开视频重新上传。最好的 MP4 Video to Prompt 素材仍然应该短、典型，并围绕一个制作问题。
上传前准备文件
Copy Video 接受 Sender 所显示大小限制内的 MP4。上传前建议完成以下准备：
- 删除无关片头、片尾和重复拍摄。
- 尽量保留原始帧率。
- 避免没有必要的多次转码，以免运动细节损失。
- 如果需要分析节奏或对白，确认音轨存在。
- 使用团队能够识别的文件名。
- 写下这次 MP4 Video to Prompt 要回答的问题。
product-reveal-v3.mp4 比 final-final-2.mp4 更容易管理。文件名不会改变模型结论，但在团队比较多次 MP4 Video to Prompt 结果时可以减少混乱。
选择文件后发生了什么
Sender 首先检查扩展名、MIME 类型和文件大小。上传接口要求用户已经登录，并把素材存入该用户专属的对象路径，同时返回展示地址和内部存储 key。
开始分析时，服务器会检查 key 是否属于当前登录用户。这个所有权校验可以阻止一个账号要求 MP4 Video to Prompt 服务读取另一个账号的对象。
校验通过后，服务器从 R2 读取文件字节，再通过 Gemini Files API 上传临时文件。系统等待文件进入可分析状态，使用提供方返回的 URI 进行分析，并在请求结束后尝试删除 Gemini 临时文件。R2 地址不能直接假设为 Gemini 支持的文件 URI，因此 MP4 Video to Prompt 必须遵循提供方正式的文件生命周期。
使用上传优先的 Sender
打开 Copy Video Sender。因为私有本地素材是 MP4 Video to Prompt 的核心场景，所以界面默认选择 Upload File。登录后点击上传区域，选择已经准备好的文件。Sender 会显示文件名、大小和上传进度。
上传完成后再点击右侧箭头。分析期间，进度状态会显示提供方正在处理素材。完成的 MP4 Video to Prompt 结果会出现在 Sender 下方。复制之前，应把输出与原片放在一起逐镜检查。
如果上传失败，先检查格式、MIME 类型、大小和登录状态。如果上传成功但分析失败，应区分错误发生在哪个阶段。应用仍保留失败退款流程，不要在不了解原因时连续重复点击。
逐镜校对私有素材
素材来自团队内部，并不代表模型描述一定准确。每一条 MP4 Video to Prompt 结果都需要回到原片验证。
逐镜确认开始与结束帧、景别和角度、运镜与主体运动的区别、动作先后和结束状态、光源方向、对白与环境声，以及服装、道具、空间和运动方向的连续性。
手机素材常包含自动对焦变化、曝光滚动、防抖痕迹和突然晃动。MP4 Video to Prompt 应先如实描述这些视觉结果，而不是假设它们都是有意设计。改写阶段再决定要保留原始感，还是把它们替换成稳定、可控的正式制作语言。
常见问题
为什么不能直接把 R2 地址交给 Gemini？
对象地址并不自动等于 Gemini 文件 URI。MP4 Video to Prompt 服务端需要先读取存储对象，再通过 Gemini Files API 上传，才能让提供方按支持的流程处理媒体。
临时文件会删除吗？
分析请求结束后，服务端会在清理步骤中尝试删除 Gemini 临时文件。即使上传后分析报错，也会进入清理逻辑。清理失败会记录日志，但不会覆盖原始错误。
其他用户能分析我的存储 key 吗？
不能直接这样做。分析路由会检查 key 是否以当前用户预期的存储前缀开始，不符合 MP4 Video to Prompt 请求契约的引用会被拒绝。
可以上传客户原始素材吗？
只有在合同和内部政策明确允许时才可以。如果不确定，应先制作裁切、脱敏或合成参考，再使用 MP4 Video to Prompt。