URL context

开发中

POST

v1beta/models/gemini-3-flash-preview:generateContent"

官方文档：https://ai.google.dev/gemini-api/docs/url-context?hl=zh-cn
借助网址上下文工具，您可以网址的形式向模型提供更多上下文。通过在请求中添加网址，模型将访问这些网页中的内容（只要不是限制部分中列出的网址类型），从而为回答提供信息并提高回答质量。

网址上下文工具适用于以下任务：

提取数据：从多个网址中提取价格、名称或关键发现等特定信息。
比较文档：分析多份报告、文章或 PDF，以找出差异并跟踪趋势。
综合和创建内容：整合来自多个来源网址的信息，生成准确的摘要、博文或报告。
分析代码和文档：指向 GitHub 代码库或技术文档，以解释代码、生成设置说明或回答问题。
以下示例展示了如何比较来自不同网站的两份食谱。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "parts": [
                {
                    "text": "Compare the ingredients and cooking times from the recipes at https://www.foodnetwork.com/recipes/ina-garten/perfect-roast-chicken-recipe-1940592 and https://www.allrecipes.com/recipe/21151/simple-whole-roast-chicken/"
                }
            ]
        }
    ],
    "tools": [
        {
            "url_context": {}
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'v1beta/models/gemini-3-flash-preview:generateContent"' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "parts": [
                {
                    "text": "Compare the ingredients and cooking times from the recipes at https://www.foodnetwork.com/recipes/ina-garten/perfect-roast-chicken-recipe-1940592 and https://www.allrecipes.com/recipe/21151/simple-whole-roast-chicken/"
                }
            ]
        }
    ],
    "tools": [
        {
            "url_context": {}
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-03-12 09:52:24

Google Maps

视频生成