DeepSeek 搜索与抓取 API 定价及功能概览

DeepSeek 搜索与抓取 API 每 1,000 次成功调用收费 0.75 美元，为 LLM 代理提供低成本的实时网络访问

DeepSeek 宣布推出两个新的原始 JSON 端点——搜索和抓取——让语言模型代理能够检索实时网页结果和页面内容。两个 API 均按每次成功请求计费，价格为每 1,000 次调用 0.75 美元，无论返回多少条结果。

搜索 API 为查询提供结构化结果

关键要点： 搜索端点最多返回 50 条排名结果，包含标题、URL、摘要、总结以及可选的完整页面内容。

  • 端点： POST https://api.deepseek.com/v1/tools/search
  • 身份验证： 在 Authorization 标头中使用 Bearer 令牌；需要 Content-Type: application/json。
  • 请求字段（全部为 JSON）：
    • query（字符串，1-128 个字符，必填）
    • count（整数，默认 10，范围 1-50）
    • ori_question（字符串，可选，最多 128 个字符）
    • localization（字符串，可选 IP 地址）
    • need_content（布尔值，默认 false）——当为 true 时，响应包含页面的完整 Markdown 内容。
  • 支持的查询运算符包括 site:、-site:、-、-"..."、"..."、lang:、after: 和 before:。运算符可以在单个查询中组合使用。
  • 响应结构（200 OK）：
    {
  "results": [
    {
      "rerank_score": 2.4,
      "title": "DeepSeek V4 model released",
      "url": "https://example.com/deepseek-v4",
      "snippet": "...",
      "summary": "...",
      "content": "...",   // 仅当 need_content=true 时存在
      "site_name": "Example News",
      "site_icon": "https://example.com/favicon.ico",
      "date": "2026-06-01T00:00:00+00:00",
      "authority": 3
    }
  ]
}
  • 评分： rerank_score 范围为 0-3；分数 ≥ 1.5 表示高质量结果。authority 3-4 表示高权威来源。
  • 计费规则： 仅当请求返回 HTTP 200 且 results 数组非空时才计费。
  • 速率限制： 每个账户 5 QPS（与抓取 API 独立）。超过限制将返回 HTTP 429。

抓取 API 返回页面的 Markdown 内容

关键要点： 抓取端点获取单个 URL 并返回其标题和完整 Markdown 正文，同样按每 1,000 次成功调用 0.75 美元计费。

  • 端点： POST https://api.deepseek.com/v1/tools/fetch
  • 身份验证： 与搜索 API 相同的 Bearer 令牌方案。
  • 请求字段： url（字符串，必填，最大 8192 个字符，必须是有效的 HTTP/HTTPS URL，且不含凭据）。
  • 响应结构（200 OK）：
    {
  "title": "Example article",
  "content": "# Example article\n\nArticle content."
}
  • 计费规则： 仅当请求返回 HTTP 200 且 content 字段非空时才计费。
  • 速率限制： 每个账户 5 QPS，外加额外的每域名 QPS 限制；违反限制返回 HTTP 429。

错误处理遵循 OpenAI 兼容格式

关键要点： 错误返回包含 error.message、error.type 和 error.code 的 JSON 对象；param 字段始终为 null。

HTTP 状态码 典型原因
400 JSON 或字段值无效（例如 count 超出范围）
401 API 密钥缺失或无效
402 账户余额不足
403 抓取被目标站点安全策略阻止
404 URL 不可用、被阻止或内容无法提取
408 请求体读取超时
413 请求体过大
429 超过 QPS 限制
500 内部服务器错误
504 下游超时

重试指南： 对于 408、429 或任何 5xx 错误，请等待后重试。对于其他 4xx 错误，在修复请求之前不要重试。

社区对定价和限制的看法

关键要点： 用户认为 DeepSeek 的 0.75 美元/千次价格优于竞争对手，但对速率限制和反机器人稳健性表示担忧。

  • 定价比较： Brave Search API 收费 5 美元/千次，Kagi 12 美元/千次，Exa 4 美元/千次，而 DeepSeek 的 0.75 美元/千次明显更便宜。
  • 速率限制批评： 多位评论者指出，5 QPS 可能不足以满足高流量应用的需求，尤其是在预期有多个并发用户的情况下。
  • 反机器人处理： 关于 DeepSeek 如何处理 Cloudflare 挑战、CAPTCHA 或其他机器人保护的问题仍然存在；文档中未作说明。
  • 替代方案： 一些用户指出，免费的自托管选项如 searxng-ai-kit 或开源抓取服务（Jina、Parallel、Firecrawl、Tavily、Exa）对于个人项目更具成本效益。
  • 集成说明： 使用 DeepSeek 自己的 Harness、Claude Code 或 Codex 时，搜索/抓取调用目前免费；计费从北京时间 2026 年 11 月 1 日 00:00 开始。

实用使用技巧

关键要点： 为最大程度降低成本并保持在限制内，请仅请求所需字段并尽可能重用结果。

  1. 设置 need_content=false，除非下游模型明确需要完整页面文本；这可以避免不必要的数据传输。
  2. 批量查询，充分利用 count 限制（最大 50），以减少 HTTP 调用次数。
  3. 缓存成功结果，用于重复查询；缓存命中不会再次计费。
  4. 遵守 QPS 限制，在 HTTP 429 响应时添加指数退避。
  5. 通过 DeepSeek 仪表板监控计费；只有成功且非空的响应才计入 0.75 美元/千次的费用。

总结

DeepSeek 的搜索和抓取 API 为 LLM 代理提供低成本、与令牌无关的网络访问，价格为每 1,000 次成功请求 0.75 美元，具有适度的 5 QPS 限制和 OpenAI 兼容的错误处理。虽然价格低于主要竞争对手，但开发人员必须考虑速率限制约束、反机器人稳健性以及处理空结果计费细节的需求。

Sources

相关