URL context

POST

/v1beta/models/gemini-2.5-pro:generateContent

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

借助网址上下文工具，您可以网址的形式向模型提供更多上下文。通过在请求中添加网址，模型将访问这些网页中的内容（只要不是限制部分中列出的网址类型），从而为回答提供信息并提高回答质量。

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

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

Header 参数

Body 参数application/json

示例

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Interpreting this website https://www.youtube.com/watch?v=QCvF8mCPwdQ"
        }
      ]
    }
  ],
  "tools": [
    {
      "UrlContext": {}
    }
  ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/v1beta/models/gemini-2.5-pro:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Interpreting this website https://www.youtube.com/watch?v=QCvF8mCPwdQ"
        }
      ]
    }
  ],
  "tools": [
    {
      "UrlContext": {}
    }
  ]
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-03-08 01:18:40

视频理解

音频理解