Como Integrar e Usar a DeepSeek Search & Fetch API para Aplicações RAG
本文能帮你掌握如何使用 DeepSeek 的 Search 与 Fetch API，为你的 AI 代理（Agents）和 RAG（检索增强生成）应用实时获取网络内容。
什么是 DeepSeek Search & Fetch API？
DeepSeek 提供的 Search API 和 Fetch API 允许开发者和 AI 应用直接访问动态的网页内容：
- Search API：由 DeepSeek 自研搜索引擎驱动，根据查询条件查找网页并返回结构化结果。
- Fetch API：检索单个网页，并将其内容转换为整洁的 Markdown 格式。
两者均采用原始 JSON API 格式，并使用与 DeepSeek API 相同的 Bearer 认证方式。基础 URL 为 https://api.deepseek.com。
步骤指南：如何调用 Search 与 Fetch API
1. 获取并配置 API 密钥
首先，在请求头（Header）中附带你的 API 密钥以及 Content-Type：
Authorization: Bearer <DeepSeek API Key>Content-Type: application/json
2. 调用 Search API 搜索网页内容
你可以使用 cURL 或 Python 发送 POST 请求到 https://api.deepseek.com/v1/tools/search。
Python 示例代码：
import requests
response = requests.post(
"https://api.deepseek.com/v1/tools/search",
headers={
"Authorization": "Bearer <DeepSeek API Key>",
},
json={
"query": "DeepSeek V4 release",
"count": 5,
"need_content": True,
},
)
response.raise_for_status()
for result in response.json()["results"]:
print(result["title"], result["url"])
print(result["summary"])
3. 调用 Fetch API 获取单个网页的 Markdown
如果你只需要抓取特定 URL 的内容并转换为 Markdown，可以向 https://api.deepseek.com/v1/tools/fetch 发送请求。
cURL 示例代码：
curl https://api.deepseek.com/v1/tools/fetch \
-H "Authorization: Bearer <DeepSeek API Key>" \
-H "Content-Type: application/json" \
-d '{ "url": "https://example.com/article" }'
常见问题
| 错误代码 | 描述与排查建议 |
| :--- | :--- |
| 400 | 请求头或请求体无效（如 JSON 格式错误或字段值不合法）。请检查请求参数。 |
| 401 | API 密钥缺失或无效。请确认 Authorization 头部配置正确。 |
| 402 | 账户余额不足。请在调用前给账户充值。 |
| 404 | 无法抓取可用页面内容（如 URL 失效、被网站策略阻止、或无提取价值的内容）。 |
| 429 | 超出 QPS 限制。Search 和 Fetch 限制为每秒 5 次请求（QPS 5），请实现重试退避机制。 |
对于 408、429 或 5xx 错误，建议等待一段时间后重试；对于 402 错误，请先充值再重试。
在本站快速上手 Claude / GPT / Gemini / Grok
本文涉及的能力可以直接在本站的中转 API 上调用，兼容 OpenAI / Anthropic 官方 SDK：
无需科学上网，国内可直连，5 分钟完成接入。
