Gemini 视频理解

把视频 URL 传给 Gemini, 可做内容摘要 / 分镜描述 / 问答 / 字幕生成

POST /v1/chat/completions

Auth: {'type': 'bearer', 'prefix': 'sk-', 'description': 'API Key, 使用 `Authorization: Bearer sk-xxx` 鉴权'}

Gemini 支持视频输入, 通过 `content` 的 `input_video` / `video_url` 类型传入。 **支持格式**: mp4 / mov / avi / webm / flv / mkv / 3gp **视频上限**: - 2.5 Pro: 2 小时 (标准分辨率), 6 小时 (低分辨率) - 2.5 Flash: 1 小时 **典型用法**: 短视频内容理解、教学视频提取知识点、监控录像事件检测、广告片分镜拆解。

Request body

`model`	string	required	支持视频的 Gemini 模型, 如 `gemini-2.5-pro` / `gemini-2.5-flash`
`messages`	array	required
`role`	string	required
`content`	array
`type`	string
`text`	string
`video_url`	object
`url`	string	required	视频 URL
`fps`	integer		(可选) 分析帧率, 默认 1 FPS
`temperature`	number
`max_tokens`	integer
`stream`	boolean

Responses

200 — Gemini 对视频的理解

Example

curl https://api.router.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-pro",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "逐分钟拆解这个视频的关键事件"},
          {"type": "video_url", "video_url": {"url": "https://example.com/demo.mp4"}}
        ]
      }
    ]
  }'

API reference