深度求索開放 Search/Fetch API:代理上網每千次成功請求零點七五美元——Harness/Claude Code/Codex 至十一月一日前仍免費

重點摘要

深度求索(DeepSeek)已向開發者開放獨立的 Search 與 Fetch 應用程式介面,讓人工智能代理與檢索增強生成(RAG)應用可直接上網搜尋與擷取網頁內容。官方文件列明兩項介面均按「成功請求」計費,每千次成功請求各為零點七五美元;失敗、空結果與逾時不收費。經 DeepSeek Harness、Claude Code 或 Codex 由伺服器端觸發的同類呼叫,目前仍免費,將於二零二六年十一月一日北京時間零時起改為按次計費。

深度求索開放 Search/Fetch API:代理上網每千次成功請求零點七五美元——Harness/Claude Code/Codex 至十一月一日前仍免費

深度求索(DeepSeek)已向開發者開放獨立的 Search 與 Fetch 應用程式介面,讓人工智能代理與檢索增強生成(RAG)應用可直接上網搜尋與擷取網頁內容。官方文件列明兩項介面均按「成功請求」計費,每千次成功請求各為零點七五美元;失敗、空結果與逾時不收費。經 DeepSeek Harness、Claude Code 或 Codex 由伺服器端觸發的同類呼叫,目前仍免費,將於二零二六年十一月一日北京時間零時起改為按次計費。

本文已核對深度求索官方 API 文件中的 Search & Fetch 指南與定價頁,並輔以科技媒體對同一公告的報道,確認端點、計費規則與速率限制均可獨立複核。

深度求索開放 Search/Fetch API:代理上網每千次成功請求零點七五美元——Harness/Claude Code/Codex 至十一月一日前仍免費

深度求索在官方 API 文件宣布,Search(搜尋)與 Fetch(擷取)兩項工具介面現已可用,並由自家搜尋引擎驅動。兩者均為原始 JSON API,採用與一般 DeepSeek API 相同的 Bearer 金鑰認證,基底網址為 https://api.deepseek.com。搜尋端點為 POST /v1/tools/search,擷取端點為 POST /v1/tools/fetch。來源真實性已驗證:以下技術細節與價格均摘自官方指南與 Models & Pricing 頁面,並與獨立科技媒體對同一產品線的報道交叉核對。

本文整理介面能力、計費與速率限制、對代理開發與企業落地的含義,以及香港與亞洲團隊在組建「可上網」智能體時須留意的工程與合規邊界。

一、核心事件:代理終於有官方「上網工具」價目表

技術細節

根據官方 Search & Fetch 指南:

  • Search API:依查詢字串回傳結構化搜尋結果;結果可含標題、網址、短摘要(snippet)、供模型閱讀的長摘要(summary)、可選全文(need_content)、站點名稱、權威度(authority,0–4)與重排分數(rerank_score,0–3;1.5 或以上視為高品質)。
  • Fetch API:對單一 HTTP/HTTPS 網址擷取頁面,並以 Markdown 回傳標題與內容,方便代理或 RAG 管線直接餵入模型。
  • 查詢約束:query 須為 1 至 128 個 Unicode 字元;count 預設 10、可設 1–50;另支援 ori_question、localization(可選 IP 以本地化結果)等欄位。
  • 查詢運算子:文件列明可原樣轉發搜尋語法,包括 site:、-site:、排除詞、精確片語、lang:、after:/before: 日期過濾等,便於企業把搜尋範圍鎖在指定網域或語種。

定價頁與指南一致寫明:Search、Fetch 各自按成功請求計價,每千次成功請求零點七五美元;不以 token、亦不以回傳結果條數計費。count 只影響回傳數量,不改變單次請求單價。官方定義「可計費」為回傳 HTTP 200 且產生結果——Search 須非空 results 陣列,Fetch 須成功回傳頁面內容;失敗請求、空搜尋結果與逾時不收費。

速率方面,每個帳戶對 Search、Fetch 分別限制每秒 5 次請求(QPS),兩者配額互不挪用,且與模型並發上限分開計算;超出帳戶 QPS 或 Fetch 的每網域 QPS 將收到 HTTP 429。指南亦列明 402(需儲值)、404(無法擷取可用內容)、408/504(逾時)、413(請求體過大)等錯誤處理建議。

另有一項對代理產品線影響甚大的過渡安排:透過 DeepSeek Harness、Claude Code 或 Codex 使用 DeepSeek API 時,伺服器端工具呼叫已會打到 Search/Fetch;這些呼叫目前免費,按次計費自二零二六年十一月一日北京時間零時起生效。

二、技術原理深度解析

傳統聊天補全 API 只處理「模型進、模型出」;代理若要「查最新資料」或「讀指定頁」,過去多倚賴第三方搜尋/爬取服務,或自建爬蟲與反爬對抗。DeepSeek 把搜尋與擷取收成兩條與模型金鑰共用認證的工具端點,等於在同一供應商帳號下提供「推理+上網」最小閉環。

Search 側強調結構化欄位與重排分數,方便代理在多候選中篩選;Fetch 側直接輸出 Markdown,降低 HTML 清洗成本。官方強調兩者為唯讀介面,並建議對 408、429、5xx 採退避重試,對其他 4xx 則應先修正請求再重試——這與企業把工具呼叫納入可觀測、可重試的代理編排層的做法一致。

對照同日科技媒體報道,外界亦把定價解讀為面向代理工作負載的「按次查網」商品化:開發者可預估每千次成功上網的美元成本,而不必先把搜尋計費綁死在 token 用量上。需注意:媒體對「免費期截止」常以 UTC 換算表述,本文一律以官方「北京時間十一月一日零時」為準。

四、日常應用場景

1. 開發者與技術團隊

可把 Search/Fetch 接進自研代理、RAG 管線或現有編碼助手外掛:先 Search 找候選頁,再 Fetch 讀全文,最後交由 deepseek-flash 等模型綜合。查詢運算子有助把範圍限於官方文件站、GitHub 或內部公開知識庫鏡像,減少幻覺來源。

2. 企業與隱私敏感行業

企業仍須自行評估:外送查詢字串與目標 URL 會離開內網;涉及客戶資料、未公開財報或受監管行業內容時,應在代理層做提示脫敏、網域白名單與稽核日誌。若工作負載必須「數據不出境」,應優先考慮私有部署與受控知識庫,而非把敏感查詢直接打到公有搜尋 API。

3. 一般用戶

一般消費者不會直接呼叫這兩條端點,但會間接受惠於「會上網的助手」:客服機器人、研究助理、編碼代理若接上 Search/Fetch,回答可引用較新的公開網頁。用戶仍應核對權威度與原始連結,避免把摘要當最終依據。

4. 香港與亞洲市場視角

香港與亞洲大量初創、外包與企業資訊科技團隊正把代理接到內部工單、知識庫與對外研究流程。官方價目表(每千次成功請求零點七五美元、帳戶級 QPS 5)讓財務與架構師較易做成本上限;同時十一月一日起 Harness/Claude Code/Codex 路徑將結束免費,依賴伺服器端工具呼叫的產品須提前改預算與快取策略。支援 lang: 與本地化參數,亦有利中英雙語查詢場景。

五、專業評價與潛在考量

優勢

  • 官方、可複核的代理上網工具鏈,認證與模型 API 一致,整合成本低。
  • 按成功請求計費、空結果與失敗不收費,計費邊界相對清晰。
  • 搜尋語法與 Markdown 擷取對工程落地友善;與 Harness 等代理執行環境已打通。

需要留意的地方

  • QPS 5 對高並發客服或批次研究可能偏緊,需佇列、快取與多帳戶隔離策略。
  • Fetch 受站點政策、內容類型與反爬限制,404/無法抽 Markdown 屬預期風險,不能假設「任意 URL 必成功」。
  • 十一月一日起編碼助手路徑結束免費,隱藏成本可能突然浮現;應在截止前盤點工具呼叫量。
  • 公有搜尋不替代企業私有知識治理;合規與資料主權場景仍需私有模型與受控語料。

結語

深度求索把「搜尋」與「讀頁」做成與模型並列的官方工具商品,並公開每千次成功請求零點七五美元的價目與十一月一日的免費期截止——這對正在量產人工智能代理的團隊是可執行的成本訊號,而非抽象概念。接下來關鍵在於:把工具呼叫納入可觀測編排、用網域與語法鎖住可信來源,並在計費切換前完成用量盤點。

若香港企業需要把同類代理能力建在私有資料與本地合規邊界之內,可參考 YSK Limited 的企業私有 LLM 全託管(Dataset → QLoRA/LoRA → 私有 API,年費 HK$88,000 起,強調數據不出境):https://ysk.hk/services/ai-automation


參考來源

  1. DeepSeek API Docs — Search & Fetch guide:https://api-docs.deepseek.com/guides/search/
  2. DeepSeek API Docs — Models & Pricing(Search & Fetch Pricing):https://api-docs.deepseek.com/quick_start/pricing/
  3. PPC Land — DeepSeek prices web search for AI agents at $0.75 per 1,000 calls(2026-10-17):https://ppc.land/deepseek-prices-web-search-for-ai-agents-at-0-75-per-1-000-calls/

延伸閱讀 · 相關服務與產品