DeepSeek 网页搜索与抓取
选择直接搜索、抓取网页，或让模型使用网页工具生成回答。
选择调用方式
| 需求 | 调用方式 |
|---|---|
| 按关键词查找网页，自行处理结果 | Search，返回链接、摘要和可选正文，无需 model |
| 已有 URL，需要读取正文 | Fetch，返回页面标题与 Markdown 正文，无需 model |
| 需要模型查资料后直接回答 | 通过 Responses 或 Messages 声明服务端网页工具，由模型选择和执行操作 |
以下请求使用平台 API Key；独立接口和模型工具均可能产生调用费用。
直接搜索与抓取
1. 搜索网页
curl 'https://api.agtcloud.cn/v1/tools/search' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"query": "DeepSeek site:api-docs.deepseek.com",
"count": 5,
"need_content": false
}'从 results 中选择相关网页，读取其 url。没有匹配结果时，调整搜索词或范围；需要在搜索结果中同时获取正文，可设置 need_content: true。
2. 抓取选定网页
将下面的 URL 替换为上一步选定的 results[].url：
curl 'https://api.agtcloud.cn/v1/tools/fetch' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"url": "https://example.com/"
}'读取 title 和 content，将 Markdown 正文用于展示、检索或后续模型输入。每次成功搜索和抓取分别计费，搜索返回多条结果仍只计一次搜索请求。
让模型调用网页工具
将 MODEL_ID 替换为支持对应工具的完整模型 ID。工具由服务端执行，客户端无需自行调用搜索或回传工具结果。
选择 deepseek-v4-pro。web_search 可执行搜索和打开网页，不需要单独声明 Fetch 工具。
curl 'https://api.agtcloud.cn/v1/responses' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"reasoning": {"effort": "none"},
"max_output_tokens": 4096,
"tools": [{"type": "web_search"}],
"input": "搜索 Python 官方网站，读取相关网页后简要介绍它的用途，并提供来源链接。"
}'完整请求与响应结构见 Responses 和 Messages。
查看结果与用量
| 调用方式 | 读取位置与含义 |
|---|---|
| 独立 Search／Fetch | Search 读取 results，Fetch 读取 title/content；响应不额外返回 usage |
| Responses 结果 | output 中的 web_search_call 描述网页操作，最终回答位于 message 的文本内容中 |
| Responses 用量 | usage.server_tool_use.tool_search 为成功搜索查询次数，一次工具调用包含多个查询时可能计为多次；tool_fetch 为成功读取网页的次数，包括打开网页和在网页内查找文本。两项均为零时，server_tool_use 会被省略 |
| Messages 结果 | content 中包含 server_tool_use、web_search_tool_result 和最终回答的文本块 |
| Messages 用量 | usage.server_tool_use.web_search_requests 统计尝试次数，可能包含失败或超过 max_uses 的尝试；tool_search 统计成功且有结果的搜索次数，平台按成功次数计搜索费 |
| 流式用量 | Responses 从最终 response.completed/incomplete/failed 的 response.usage 读取；Messages 从最后的 message_delta.usage 读取累计值，不与初始事件相加 |
声明工具不保证模型一定执行搜索；实际次数以返回用量为准。Responses 的 max_tool_calls 会被忽略，提示词中的次数要求也不能作为计费次数上限。