gemini-2.5-computer-use-preview-10-2025**- AI开放文档**

支持接口地址

POST:https://gw.hbapis.com/v1beta/models/gemini-2.5-computer-use-preview-10-2025:generateContent

API 支持

一种代理功能模型，专为直接界面互动而设计，可让 Gemini 感知和浏览数字环境。Gemini 2.5 电脑使用模式最适合浏览器自动化、多步骤软件任务和需要视觉推理和精确光标控制的界面测试。

模型限制

输入token限制:128000,输入token限制:64000

能力支持

借助“计算机使用”工具，您可以构建浏览器、移动设备和桌面设备控制代理，让其与用户交互并自动执行任务。借助屏幕截图，该模型可以“看到”电脑屏幕，并通过生成特定的界面操作（例如鼠标点击和键盘输入）来“行动”。与函数调用类似，您需要实现客户端执行环境，以接收和执行“计算机使用”操作。借助“电脑使用”功能，您可以构建能够执行以下操作的智能体：

自动执行网站上重复的数据输入或表单填写操作。

自动测试 Web 应用和用户流程

在各种网站上进行研究（例如，从电子商务网站收集产品信息、价格和评价，以便做出购买决策）

鉴权方式

使用 Bearer Token 鉴权，在请求 Header 中添加 Authorization 参数：

Authorization: Bearer YOUR_API_KEY

请求参数

请求头

Content-Type

类型：string

必填：否

说明：application/json

Authorization

类型：string

必填：是

说明：Bearer YOUR_API_KEY

请求体

model

类型：str；必填：是；说明：gemini-2.5-computer-use-preview-10-2025。注意原生端点写在 URL 路径里（/v1beta/models/{model}:generateContent），不在 body 中。

contents

类型：array；必填：是；说明：对话消息列表。

contents**[].****role **

类型：str；必填：是；说明：消息角色，user 或 model。单轮可省略，多轮循环必填。

contents[].parts[]

类型：str；必填：是；说明：消息内容片段列表，至少一个元素。

contents[].parts[].text

类型：int；必填：是；说明：文本内容，即操作意图，如 "Click the search box"。

t****ools

类型：array；必填：否；说明：工具声明。

**tools[].computerUse.environment **

类型：float；必填：否；说明：操作环境枚举，ENVIRONMENT_BROWSER（浏览器）或 ENVIRONMENT_UNSPECIFIED。决定模型可用的动作集。。

请求示例

实例1:

返回响应

成功请求返回 HTTP 200。不同端点的响应结构可能不同。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

API Key

在 header 添加参数

x-api-key

示例：

x-api-key: ********************

Body 参数application/json必填

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Click the search box on this page"
                },
                {
                    "inlineData": {
                        "mimeType": "image/png",
                        "data": "iVBORw0KGgoAAAANSUhEUgAAAUAAAADICAIAAAAWZq/8AAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAT9SURBVHhe7dVtbhwpGIVRb22WM7uYhc6fWUmm3BCC6I90O25KF84RsoBySinpfZKPf4FYAoZgAoZgAoZgAoZgAoZgAoZgAoZgswP++PBPBnybRzkdsRVl3y7bpijHQzv2l4d2X/ZtU5RjU29/vqcoj4p2M9zDhu420PLoNzcv+83nb/zcXK5/3T84Nv19vy+bQ9lfHtbN5Ro2dTeAEknTLsvmUO4P7dh+Pti0n73L80+/3ZfNcIRt3Q3gOpJjc/Oy3zz5C9dPi/54c182wxG29SiAI4+i7Ntl2xTlWLRjvynasW2KdmybYtj32s31I9jK2wPQGLyPuiCYgCGYgCGYgCGYgCGYgCGYgCGYgCGYgCHYxw8gloAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAh2GoBf8BDdVBWIWD2UgdlFWsGXA/QWXI2BMwulpwNAbOLJWdDwOxiydkQMLtYcjYEzC6WnA0Bs4slZ0PA7GLJ2dg04H8u6oE9PDkbWXYMuKWr4a08Mxtxtg64+fzv+OLmsSjHcn9ol0U5NvX2/q+1fbk/lCPv88xsxNk04KId+831/eHeo+G+6e+HX3684X2emY04OwbclGyOn73+5vJbn8q+vymeuT9+9tr9zUe8z0uzkWK7gIdO+nLKZjgWw6Pmmfv29JkN7/Pb2Ui0XcCHo5ZmuLl57NUHL/ZW/8z3vZAveGY24uwYMHtacjYEzC6WnA0Bs4slZ0PA7GLJ2RAwu1hyNgTMLpacDQGziyVnQ8DsYsnZEDC7WHI21gwY7qmDsgoBs5c6KKtY7XtgKwKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAI+x19//7fYqh/GXAI+xzD9C6z6Ycwl4HMM07/Aqh/GXAI+xzD9C6z6Ycwl4HMM07/Aqh/GXAI+xzD9C6z6Ycwl4HMM07/Aqh/GXAI+xzD9X1jf9Z7vWuXvw2QCPscw/a+u9oY/f9V3rctnMZuAzzFM/6vr+g3ltYebx3Z5/agerl746qpvYS4Bn2OY/ldXfUsXYb+5vm/760fD/ZfX8QbmE/A5hun/8iqvKu9s+pvr32w3Zd27f3Udb2A+AZ9jmP6X1vDH+xeWzXDs9/1NWffuX13HG5hPwOcYpv/VVd9yMdzcPParPvjjv8Ow6kuZS8DnGKZ/gVU/jLkEfI5h+hdY9cOYS8DnGKZ/gVU/jLkEfI5h+hdY9cOYS8DnGKZ/gVU/jLkEfI5h+hdY9cOYS8DnGKZ/gVU/jLkEfI5h+hdY9cOYS8AQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQ68eP/wFXBB3V/6USiAAAAABJRU5ErkJggg=="
                    }
                }
            ]
        }
    ],
    "tools": [
        {
            "computerUse": {
                "environment": "ENVIRONMENT_BROWSER"
            }
        }
    ],
    "generationConfig": {
        "temperature": 0
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1beta/models/gemini-2.5-computer-use-preview-10-2025:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Click the search box on this page"
                },
                {
                    "inlineData": {
                        "mimeType": "image/png",
                        "data": "iVBORw0KGgoAAAANSUhEUgAAAUAAAADICAIAAAAWZq/8AAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAT9SURBVHhe7dVtbhwpGIVRb22WM7uYhc6fWUmm3BCC6I90O25KF84RsoBySinpfZKPf4FYAoZgAoZgAoZgAoZgAoZgAoZgAoZgswP++PBPBnybRzkdsRVl3y7bpijHQzv2l4d2X/ZtU5RjU29/vqcoj4p2M9zDhu420PLoNzcv+83nb/zcXK5/3T84Nv19vy+bQ9lfHtbN5Ro2dTeAEknTLsvmUO4P7dh+Pti0n73L80+/3ZfNcIRt3Q3gOpJjc/Oy3zz5C9dPi/54c182wxG29SiAI4+i7Ntl2xTlWLRjvynasW2KdmybYtj32s31I9jK2wPQGLyPuiCYgCGYgCGYgCGYgCGYgCGYgCGYgCGYgCHYxw8gloAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAhmIAh2GoBf8BDdVBWIWD2UgdlFWsGXA/QWXI2BMwulpwNAbOLJWdDwOxiydkQMLtYcjYEzC6WnA0Bs4slZ0PA7GLJ2dg04H8u6oE9PDkbWXYMuKWr4a08Mxtxtg64+fzv+OLmsSjHcn9ol0U5NvX2/q+1fbk/lCPv88xsxNk04KId+831/eHeo+G+6e+HX3684X2emY04OwbclGyOn73+5vJbn8q+vymeuT9+9tr9zUe8z0uzkWK7gIdO+nLKZjgWw6Pmmfv29JkN7/Pb2Ui0XcCHo5ZmuLl57NUHL/ZW/8z3vZAveGY24uwYMHtacjYEzC6WnA0Bs4slZ0PA7GLJ2RAwu1hyNgTMLpacDQGziyVnQ8DsYsnZEDC7WHI21gwY7qmDsgoBs5c6KKtY7XtgKwKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAKGYAI+x19//7fYqh/GXAI+xzD9C6z6Ycwl4HMM07/Aqh/GXAI+xzD9C6z6Ycwl4HMM07/Aqh/GXAI+xzD9C6z6Ycwl4HMM07/Aqh/GXAI+xzD9X1jf9Z7vWuXvw2QCPscw/a+u9oY/f9V3rctnMZuAzzFM/6vr+g3ltYebx3Z5/agerl746qpvYS4Bn2OY/ldXfUsXYb+5vm/760fD/ZfX8QbmE/A5hun/8iqvKu9s+pvr32w3Zd27f3Udb2A+AZ9jmP6X1vDH+xeWzXDs9/1NWffuX13HG5hPwOcYpv/VVd9yMdzcPParPvjjv8Ow6kuZS8DnGKZ/gVU/jLkEfI5h+hdY9cOYS8DnGKZ/gVU/jLkEfI5h+hdY9cOYS8DnGKZ/gVU/jLkEfI5h+hdY9cOYS8DnGKZ/gVU/jLkEfI5h+hdY9cOYS8AQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQTMAQ68eP/wFXBB3V/6USiAAAAABJRU5ErkJggg=="
                    }
                }
            ]
        }
    ],
    "tools": [
        {
            "computerUse": {
                "environment": "ENVIRONMENT_BROWSER"
            }
        }
    ],
    "generationConfig": {
        "temperature": 0
    }
}'

gemini-2.5-computer-use-preview-10-2025

支持接口地址#

API 支持#

模型限制#

能力支持#

鉴权方式#

请求参数#

请求头#

请求体#

请求示例#

** 返回响应**#

请求参数

请求示例代码

返回响应

支持接口地址

API 支持

模型限制

能力支持

鉴权方式

请求参数

请求头

请求体

请求示例

返回响应