Skip to main content
POST
Gemini generateContent
Gemini 官方文档把视频场景拆成两类:视频理解通常走 generateContent,长任务式的视频生成则走 long-running operation。
  • 官方文档支持把视频以内联数据、Files API 文件、Cloud Storage URL 甚至 YouTube URL 的形式传给 Gemini
  • 视频理解适合摘要、镜头分析、时序问答和字幕辅助场景
  • 大文件和可复用视频更适合先上传到 Files API,再在 contents.parts 中引用
  • 如果你接的是 Veo 这类长任务生成模型,请改走 /v1beta/models/{model}:predictLongRunning
  • 视频理解的文本结果通常仍然从 candidates[].content.parts[] 读取
  • 长视频场景要先评估格式约束、抽帧频率和 token 成本

授权

x-goog-api-key
string
header
必填

路径参数

model
string
必填

Gemini model name.

示例:

"gemini-2.5-pro"

请求体

application/json
contents
object[]
必填
systemInstruction
object
generationConfig
object
safetySettings
object[]
tools
object[]

响应

Successful Gemini content response

candidates
object[]
usageMetadata
object