视频理解-url [原生格式]

POST

/v1beta/models/{model-name}:generateContent

官方文档：https://ai.google.dev/gemini-api/docs/video-understanding?hl=zh-cn

请求参数

Path 参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "generationConfig": {
        "maxOutputTokens": 63000,
        "temperature": 1,
        "topP": 1,
        "thinkingConfig": {
            "thinkingBudget": 1760,
            "includeThoughts": true
        }
    },
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "视频中是什么"
                },
                {
                    "fileData": {
                        "mimeType": "video/mp4",
                        "fileUri": "https://buildingai.oss-cn-shenzhen.aliyuncs.com/static/buildingai-sora2/videos/9.mp4"
                    }
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/v1beta/models/:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer  {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "generationConfig": {
        "maxOutputTokens": 63000,
        "temperature": 1,
        "topP": 1,
        "thinkingConfig": {
            "thinkingBudget": 1760,
            "includeThoughts": true
        }
    },
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "视频中是什么"
                },
                {
                    "fileData": {
                        "mimeType": "video/mp4",
                        "fileUri": "https://buildingai.oss-cn-shenzhen.aliyuncs.com/static/buildingai-sora2/videos/9.mp4"
                    }
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-03-24 09:54:18

URL context

Imagen 4 开发中