Gemini 原生 URL 上下文 V2

POST https://api.quickrouter.ai/v1beta/models/gemini-2.5-pro:generateContent 在线调试 →

▼ Authorization

在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token

示例： Authorization: Bearer ********************

官方文档：https://ai.google.dev/gemini-api/docs/url-context?hl=zh-cn 借助网址上下文工具，您可以网址的形式向模型提供更多上下文。通过在请求中添加网址，模型将访问这些网页中的内容（只要不是限制部分中列出的网址类型），从而为回答提供信息并提高回答质量。网址上下文工具适用于以下任务：提取数据：从多个网址中提取价格、名称或关键发现等特定信息。比较文档：分析多份报告、文章或 PDF，以找出差异并跟踪趋势。综合和创建内容：结合多个来源网址中的信息，生成准确的摘要、博文或报告。分析代码和文档：指向 GitHub 代码库或技术文档，以解释代码、生成设置说明或回答问题。

请求参数

Query 参数

key string

必需

示例: YOUR_API_KEY

Header 参数

Content-Type string

必需

示例: application/json

Body 参数 application/json

contents array [object]

必需

parts array [object]

可选

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

示例

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

请求示例代码

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

"var myHeaders = new Headers();\nmyHeaders.append(\"Authorization\", \"Bearer YOUR_API_KEY\");\nmyHeaders.append(\"Content-Type\", \"application/json\");\n\nvar raw = JSON.stringify({\n   \"contents\": [\n      {\n         \"role\": \"user\",\n         \"parts\": [\n            {\n               \"text\": \"Interpreting this website https://www.youtube.com/watch?v=QCvF8mCPwdQ\"\n            }\n         ]\n      }\n   ],\n   \"tools\": [\n      {\n         \"UrlContext\": {}\n      }\n   ]\n});\n\nvar requestOptions = {\n   method: 'POST',\n   headers: myHeaders,\n   body: raw,\n   redirect: 'follow'\n};\n\nfetch(\"https://api.quickrouter.ai/v1beta/models/gemini-2.5-pro:generateContent\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));"

"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.quickrouter.ai\")\npayload = json.dumps({\n   \"contents\": [\n      {\n         \"role\": \"user\",\n         \"parts\": [\n            {\n               \"text\": \"Interpreting this website https://www.youtube.com/watch?v=QCvF8mCPwdQ\"\n            }\n         ]\n      }\n   ],\n   \"tools\": [\n      {\n         \"UrlContext\": {}\n      }\n   ]\n})\nheaders = {\n   'Authorization': 'Bearer YOUR_API_KEY',\n   'Content-Type': 'application/json'\n}\nconn.request(\"POST\", \"/v1beta/models/gemini-2.5-pro:generateContent%7B%7BYOUR_API_KEY%7D%7D\", payload, headers)\nres = conn.getresponse()\ndata = res.read()\nprint(data.decode(\"utf-8\"))"

返回响应

响应参数 🟢 200 OK · application/json

object

可选

{}

示例

{}

Gemini 原生 URL 上下文 V2

请求参数

请求示例代码

返回响应

相关文档