> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 老张API 联网搜索：GPT、Grok 用 web_search，Gemini 用 google_search

> 让模型先搜索网页再回答，并返回来源链接：GPT 与 Grok 通过 Responses API 的 web_search 工具，Gemini 通过原生 generateContent 的 google_search 工具；含请求示例、引用解析和按次计费说明。

联网搜索是服务端工具：模型自己决定搜什么、搜几次，读完结果后给出带来源链接的回答，你的程序不需要执行任何函数。老张API按厂商的原生方式提供，GPT 和 Grok 用 Responses，Gemini 用原生 `generateContent`。

| 项目 | GPT、Grok | Gemini |
| - | - | - |
| 端点 | `POST /v1/responses` | `POST /v1beta/models/{model}:generateContent` |
| 工具 | `{"type": "web_search"}` | `{"google_search": {}}` |
| 搜索费 | 每次搜索 \$0.01 | 每次搜索 \$0.014 |
| 来源链接 | `url_citation` 注释 | `groundingMetadata` |

搜索费之外，模型读取的搜索结果按输入 token 计费，一次搜索通常会增加数千到上万输入 token。

联网请求比普通请求慢，一次通常要十几秒到一分钟，客户端超时建议设为 300 秒。

## 支持的模型

2026 年 10 月 14 日验证可用：

| 方式 | 模型 |
| - | - |
| Responses `web_search` | `gpt-6.1-sol`、`gpt-6-sol`、`gpt-5.6-luna`、`gpt-5.4-mini`、`gpt-5.4-nano`、`grok-4.5` |
| Gemini `google_search` | `gemini-4-argon`、`gemini-3.8-flash`、`gemini-3.5-flash-lite` |

Chat Completions 的 `web_search_options` 参数不可用，会返回 400 `Unknown parameter`。已经基于 Chat Completions 开发的应用，把需要联网的请求改走 Responses。

## GPT 与 Grok：Responses web\_search

运行前安装 SDK（`python -m pip install openai`），并设置 `LAOZHANG_API_KEY` 环境变量。

```python theme={null}
import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LAOZHANG_API_KEY"],
    base_url="https://api.laozhang.ai/v1",
    timeout=300.0,
)

response = client.responses.create(
    model="gpt-5.4-mini",
    input="昨天标普 500 指数收盘是多少点？请给出来源。",
    tools=[{"type": "web_search"}],
)
print(response.output_text)

for item in response.output:
    if item.type == "message":
        for part in item.content:
            for note in part.annotations or []:
                if note.type == "url_citation":
                    print(note.title, note.url)
```

`response.output` 里依次出现：

* `web_search_call`：每次搜索一项，有几项就收几次搜索费
* `message`：最终回答，`annotations` 里是 `url_citation` 来源

把 `model` 换成 `grok-4.5` 写法相同。`grok-4.5` 一次请求可能搜索多次，耗时和搜索费会相应增加。

## Gemini：google\_search

运行前安装 SDK（`python -m pip install google-genai`）：

```python theme={null}
import os

from google import genai
from google.genai import types

client = genai.Client(
    api_key=os.environ["LAOZHANG_API_KEY"],
    http_options={"base_url": "https://api.laozhang.ai", "api_version": "v1beta", "timeout": 300_000},
)

response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents="昨天标普 500 指数收盘是多少点？请给出来源。",
    config=types.GenerateContentConfig(tools=[types.Tool(google_search=types.GoogleSearch())]),
)
print(response.text)

grounding = response.candidates[0].grounding_metadata
if grounding:
    print("搜索词：", grounding.web_search_queries)
    for chunk in grounding.grounding_chunks or []:
        print(chunk.web.title, chunk.web.uri)
```

搜索费按 `web_search_queries` 里的搜索词个数计算。`grounding_chunks` 是模型引用的网页，`uri` 是 Google 的跳转链接，打开后到达原网页。

不用 SDK 时，直接发送 JSON：

```bash theme={null}
curl -s "https://api.laozhang.ai/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: ${LAOZHANG_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "昨天标普 500 指数收盘是多少点？请给出来源。"}]}],
    "tools": [{"google_search": {}}]
  }'
```

Gemini 的 OpenAI 兼容接口不支持这个工具，联网时请使用原生格式。

## 在调用日志里核对搜索费

控制台「日志」中，带联网搜索的请求会显示「Web Search 工具调用 N 次」和对应额度；通过[日志查询 API](/api-capabilities/log-query) 读取时，在 `other` 字段的 `web_search_billing` 里。总费用 = 搜索次数 × 单次价格 + token 费用。

## 常见问题

### 模型没有搜索就直接回答了？

工具只是"允许搜索"，由模型判断是否需要。问题本身需要最新信息时，模型通常会搜索；想提高搜索概率，在提示词里写明"请联网查询并给出来源"。

### 能限制只搜某些网站吗？

可以在提示词里要求优先引用某些网站，但模型不保证只用这些来源。上线前用少量请求确认效果。

### Nano Banana 的 Google 搜索也是这个价格吗？

是。Nano Banana 图像模型开启 Google 搜索接地时，同样按每次 \$0.014 另收，见 [Nano Banana 2.1](/api-capabilities/nano-banana-2-1-image)。

## 相关文档

* 让模型调用你自己的函数：[函数调用](/api-capabilities/function-calling)
* Responses 与 Chat Completions 的区别：[OpenAI 模型接入](/api-reference/openai#chat-completions-与-responses-怎么选)
* Gemini 原生格式的完整字段：[Gemini 原生协议](/api-reference/gemini)
* 模型 token 单价：[模型与价格总表](/models)

## 参考资料

* OpenAI：[Web search 工具](https://developers.openai.com/api/docs/guides/tools-web-search)
* xAI：[Search tools](https://docs.x.ai/docs/guides/tools/search-tools)
* Google：[Grounding with Google Search](https://ai.google.dev/gemini-api/docs/google-search)
* 老张API搜索费与 token 用量：控制台[调用日志](https://api.laozhang.ai/log)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.