视频理解

POST

v1beta/models/{model}:generateContent

Gemini 视频理解接口（原生格式）。
支持的模型：
gemini-2.5-pro
gemini-2.5-flash
gemini-2.0-flash
gemini-1.5-pro
gemini-1.5-flash
支持的视频格式：
video/mp4
video/webm
video/mov
video/avi
video/x-flv
video/mpg
video/mpeg
video/3gpp
上传方式：
URL方式：通过 fileData.fileUri 传递视频URL
Base64方式：通过 inlineData 传递Base64编码的视频数据

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "parts": [
                {
                    "text": "Please summarize this video in 3 sentences"
                },
                {
                    "fileData": {
                        "mimeType": "video/mp4",
                        "fileUri": "https://example.com/sample-video.mp4"
                    }
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'v1beta/models/:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "parts": [
                {
                    "text": "Please summarize this video in 3 sentences"
                },
                {
                    "fileData": {
                        "mimeType": "video/mp4",
                        "fileUri": "https://example.com/sample-video.mp4"
                    }
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "The video shows a cat playing with a ball of yarn in a living room. The cat appears energetic and playful throughout the clip. The video ends with the cat resting on a couch."
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP",
            "index": 0
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 1024,
        "candidatesTokenCount": 45,
        "totalTokenCount": 1069
    }
}

修改于 2026-03-16 14:55:01

媒体识别

文本生成