URL context

开发中

POST

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

Official documentation: https://ai.google.dev/gemini-api/docs/url-context?hl=zh-cn

The URL context tool lets you provide more context to your model in the form of URLs. By adding URLs to the request, the model will access content from those pages (as long as it is not the URL type listed in the restrictions section), thereby informing and improving the quality of the answer.

The URL context tool is useful for the following tasks:

Extract data: Extract specific information like prices, names, or key findings from multiple URLs.
Compare documents: Analyze multiple reports, articles, or PDFs to find differences and track trends.
Synthesize and create content: Combine information from multiple source URLs to produce accurate summaries, blog posts, or reports.
Analyze code and documentation: Point to a GitHub repository or technical documentation to explain code, generate setup instructions, or answer questions.

请求参数

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 'https://yossapi.com/v1beta/models/gemini-2.5-pro:generateContent?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": {}
    }
  ]
}'

返回响应

🟢200success

application/json

Body

示例

{}

修改于 2026-01-22 10:56:22

video understanding

Video understanding-url [native format] under development