Gemini - 视频理解（fileData）

POST

/v1beta/models/gemini-2.0-flash:generateContent

Gemini 视频理解 - 通过 Files API 上传视频后使用 fileUri

Request

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://newapi.mexxxxai.win/v1beta/models/gemini-2.0-flash:generateContent?key={{GEMINI_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contents": [
    {
      "parts": [
        {"fileData": {"mimeType": "video/mp4", "fileUri": "https://your-video-file-uri-from-files-api"}},
        {"text": "请描述这段视频的主要内容和关键时刻。"}
      ]
    }
  ],
  "generationConfig": {"temperature": 0.4, "maxOutputTokens": 2048}
}'

Response Example

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "这段视频时长约2分30秒，主要内容如下：\n\n**0:00-0:30** 开场介绍，展示了产品Logo和品牌标语。\n\n**0:30-1:20** 产品功能演示，展示了核心界面的操作流程，包括用户注册和主要功能模块。\n\n**1:20-2:00** 用户案例展示，通过3个真实用户的使用场景说明产品价值。\n\n**2:00-2:30** 结尾呼吁行动，显示下载链接和联系方式。\n\n整体风格专业，配乐轻快，旁白清晰。"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 8420,
    "candidatesTokenCount": 136,
    "totalTokenCount": 8556
  }
}

Modified at 2026-04-02 11:32:32

Gemini - 图片理解（fileData 方式）

Gemini - 音频理解