DeepSeek上线Search与Fetch API,定价0.75美元千次
DeepSeek search and fetch – $0.75 per 1000 successful requests
推荐理由
Agent开发者的刚需工具,价格极具竞争力且接口规范清晰,建议直接接入你的RAG链路进行压测。
| 在此页面 ## 搜索与获取 搜索 API 和获取 API 为智能体和 RAG(检索增强生成)应用提供对实时网络内容的访问权限:- 搜索 API 根据查询查找网页并返回结构化结果。它由 DeepSeek 自研搜索引擎提供支持。- 获取 API 检索单个网页,并以 Markdown 格式返回其内容。两者均为原始 JSON API。它们使用与 DeepSeek API 相同的 Bearer 认证方式。基础 URL 为 https://api.deepseek.com:API | 端点 搜索 | POST https://api.deepseek.com/v1/tools/search 获取 | POST https://api.deepseek.com/v1/tools/fetch 有关完整的请求和响应模式,请参阅搜索 API 参考文档和获取 API 参考文档。## 身份验证 在请求头中发送您的 API 密钥和 JSON 内容类型:标头 | 必需 | 值 Authorization | 是 | Bearer Content-Type | 是 | application/json ## 搜索 API ## 请求 ``` curl https://api.deepseek.com/v1/tools/search \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "query": "DeepSeek V4 release", "count": 5, "need_content": true }' ``` ``` import requestsresponse = requests.post( "https://api.deepseek.com/v1/tools/search", headers={ "Authorization": "Bearer ", }, 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"]) ``` 请求字段:字段 | 类型 | 必需 | 默认值 | 描述 query | string | 是 | - | 搜索查询必须包含 1 到 128 个 Unicode 字符,不能全为空白字符,并支持以下列出的查询运算符。count | integer | 否 | 10 | 要返回的结果数量,介于 1 到 50 之间。ori_question | string | 否 | - | 触发搜索的用户原始问题,长度为 1 到 128 个字符,用于提升查询理解能力,若为 null 则视为未提供。localization | string | 否 | "" | 可选的 IP 地址,用于本地化搜索结果。need_content | boolean | 否 | false | 是否返回 content 中的页面内容;当为 false 时,content 始终为空字符串。请求体中的未知字段将被忽略。## 查询运算符 | ||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 查询将保留其搜索语法进行转发。以下示例将运算符与搜索词结合使用;您可以在一个查询中组合多个运算符。运算符 | 示例 | 描述 site: | DeepSeek site:github.com | 将结果限制为指定站点,若要针对多个站点,请用空格分隔 site: 子句并用 OR 连接它们,例如 DeepSeek site:github.com OR site:huggingface.co。 -site: | DeepSeek -site:example.com | 排除指定站点,多个站点之间用空格分隔。 - | DeepSeek -advertisement | 排除包含该词的页面,多个词之间用空格分隔。 -"..." | DeepSeek -"release notes" | 排除包含确切短语的页面(短语可包含空格),多个短语之间用空格分隔。"..." | DeepSeek "exact phrase" | 匹配确切短语,多个短语之间用空格分隔。 lang: | DeepSeek lang:zh,en | 将结果限制为指定的语言代码,多个代码之间用逗号分隔,例如 lang:zh,en。 after: | DeepSeek after:2025 或 DeepSeek after:2025-01-01 | 将结果限制为在指定日期之后发布的页面。 before: | DeepSeek before:2026 或 DeepSeek before:2026-06-01 | 将结果限制为在指定日期之前发布的页面。例如:``` { "query": "DeepSeek site:github.com OR site:huggingface.co lang:en after:2025", "count": 10} ``` ## 响应 成功的请求返回 HTTP 200 状态码及 results 数组。无匹配结果的正常搜索将返回空数组。``` { "results": [ { "rerank_score": 2.4, "title": "DeepSeek V4 model released", "url": "https://example.com/deepseek-v4", "snippet": "DeepSeek V4 is now available, with tool calling and long-context support.", "summary": "DeepSeek has released the V4 model.此次发布增强了对智能体工作流的工具调用和长上下文支持。抓取操作受目标站点的可用性和访问策略限制。## 错误 错误遵循与 OpenAI 兼容的错误格式。param 字段始终为 null。 ``` { "error": { "message": "'count' must be between 1 and 50", "type": "invalid_request_error", "param": null, "code": "invalid_request_error" }} ``` HTTP 状态码 | 描述 400 | 请求头或请求体无效,包括格式错误的 JSON 或无效的字段值。 401 | API 密钥缺失或无效。 402 | 账户余额不足。 403 | Fetch 请求被安全策略拒绝。 404 | Fetch 无法获取可用的页面内容,例如由于 URL 不可用、URL 被站点策略阻止、目标站点出错、不支持的内容类型,或页面中没有可提取的 Markdown 内容。 408 | 读取请求体超时。 413 | 请求体过大。 429 | 超出 Search 或 Fetch 的 QPS 限制。 500 | 发生内部服务器错误。 504 | 下游请求超时。Search 和 Fetch 均为只读操作。对于 HTTP 408、429 或 5xx 错误,请等待并重试。对于 HTTP 402 错误,请在重试前充值账户。在未更改请求的情况下,不要重试其他 4xx 错误。## 计费 Search 和 Fetch 按成功请求次数计费,而非按 token 或返回结果的数量计费:API | 单位 | 价格 Search | 每 1,000 次成功请求 | $0.75 Fetch | 每 1,000 次成功请求 | $0.75 |
更进一步:量化金融体系
看懂新闻只是起点——沿量化金融路径,把它变成能交付的工程能力