# Gemini 4 Argon 视频分析实战：镜头表、时间戳与人工核验

镜头表能帮助剪辑人员定位素材，但模型给出的时间戳需要验证。本篇使用 `gemini-4-argon` 分析已有视频，不生成视频；在 [Gemini 桥接指南](/zh/docs/llm/gemini-bridge-video)基础上，重点介绍剪辑交付与验收，不重复协议配置。

## 提交前定义镜头表

记录素材版本、实际时长、语言和音轨是否相关。要求每个可见镜头包含开始、结束、可见动作、可听证据及不确定性。区分描述与推断：“有人关门”可以观察，“为什么关门”通常无法仅凭片段确定。

使用获授权片段，核对实际文件类型和大小。含播放器的网页未必是视频直链。桥接指南明确了平台 URL 下载与内联请求限制，不能用 Google 原生上传额度替代平台传输契约。

## 请求第一版镜头表

确认账号可调用支持视频输入的 `gemini-4-argon` 路由。将以下请求体发往 `POST /v1beta/models/gemini-4-argon:generateContent`，使用 `x-goog-api-key: API_KEY`。计费调用前替换占位素材 URL。

```json
{
  "contents": [{
    "role": "user",
    "parts": [
      {"text": "为整个片段生成镜头表。用 Markdown 表格，列为开始 MM:SS、结束 MM:SS、可见动作、可听证据、不确定性。只描述视频能支持的内容。不确定的时间标记为近似。不要推断姓名、动机或片段之外的事件。若无法判断音频，写 unknown，不编造对白。"},
      {"fileData": {"mimeType": "video/mp4", "fileUri": "https://files.example.com/approved-clip.mp4"}}
    ]
  }],
  "generationConfig": {"maxOutputTokens": 4096}
}
```

Markdown 列名是应用层格式要求，不是强制结构化输出。检查响应候选项、文本块、结束状态和用量。没有候选项、被阻止或长度截断的响应不能视为“完整但没有镜头”。保留非文本上下文，不要为了追加请求把响应只压成一个字符串。

## 回到原始播放器核验时间

把时间转成秒，检查每行位于实际视频时长内、开始早于结束。检查顺序，并解释重叠或缺口，不能通过自动排序把错误掩盖掉。然后在原视频中逐个定位建议边界。看起来合理的时间戳不等于帧级准确。

| 检查项 | 核验内容 |
| --- | --- |
| 覆盖 | 是否考虑开头与结尾镜头 |
| 边界 | 建议时间附近是否确有切镜 |
| 视觉证据 | 主体和动作与原片相符 |
| 音频证据 | 对白或声音确实可听见 |
| 不确定性 | 复核后的表仍保留近似标记 |

需要精确帧的剪辑决策表，应由剪辑工具或人工建立边界。不要直接把近似模型时间戳当成自动破坏性裁切指令。

## 保留上下文，针对具体区间追问

一行不清楚时，指定区间和具体疑点。原生 Gemini 追加对话时，把完整返回的 candidate content 追加到原会话，再加用户问题。按桥接指南保留不透明签名字段，只复制可见文字可能丢失必要状态。原视频输入也应在下一次请求处理期间保持可用。

本地拆分长视频时，保存每段相对于原片的起始偏移量，复核时将分段时间转换回完整时间线。重叠片段可能重复提取同一镜头，应按原片时间和证据去重，不只比较文本相似度。每段分析和每次追问都是独立的用量请求。

## 评估可用性并保留原片

对获准样本记录修正过的边界、漏掉的镜头、无依据描述、人工复核时间与用量，再用[评估指南](/zh/docs/llm/evaluation)比较结果，不给未经测试的准确率。原片和复核后的镜头表一起保存，签名素材 URL 和敏感转写不进入公开日志。

2026-11-03 已核对 [Google 模型目录](https://ai.google.dev/gemini-api/docs/models)、[视频理解指南](https://ai.google.dev/gemini-api/docs/video-understanding)及平台桥接实现与指南。这些依据支持身份和视频分析概念，不代表账号权限、帧级准确性或 Google 原生文件 API 全部可用。