部落格 / 服務動態

DeepSeek 搜尋 API 10 月 17 日開放：curl 呼叫示例，11 月 1 日起每千次 0.75 美元

2026-10-19cdnping 編輯部約 3 分鐘讀完

DeepSeek 在 2026 年 10 月 17 日向所有開發者開放了基於自研搜尋引擎的 Search 和 Fetch API。兩個介面都按“成功請求”計費，每千次 0.75 美元；透過 DeepSeek Harness、Claude Code、Codex 的服務端工具呼叫目前免費，北京時間 2026 年 11 月 1 日 00:00 起開始按次計費。

以下內容均來自 DeepSeek 官方文件，截至 2026 年 10 月 17 日頁面內容，具體以官方搜尋指南為準。

#發生了什麼？

據 10 月 17 日的官方公告，Search & Fetch API 在同一天的模型更新公告裡釋出。模型本身的變化見我們的另一篇文章：DeepSeek V4.1-Flash-1017 上線：deepseek-flash 換了新權重，開發者要不要改程式碼。

兩個介面的分工：

• Search：POST https://api.deepseek.com/v1/tools/search，返回結構化的搜尋結果。
• Fetch：POST https://api.deepseek.com/v1/tools/fetch，抓取單個網頁並返回 Markdown。

都使用 Authorization: Bearer <DeepSeek API Key> 鑑權，請求體是 JSON。

#怎麼呼叫？

#Search

query 必填，1–128 個字元。count 為 1–50，預設 10。need_content 預設 false，設為 true 才會返回頁面正文。ori_question 可以放使用者的原始問題，幫助理解查詢意圖。

curl https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Cloudflare Workers site:developers.cloudflare.com after:2026-01-01", "count": 5}'

查詢裡支援的語法有：site:、-site:（多個站點用 OR 連線）、-詞、"短語"、lang:zh,en、after:、before:，可以組合使用。

返回的 results 陣列裡，每條有 title、url、snippet（約 100–200 字）、summary（約 600–800 字，面向模型）、rerank_score（0–3，1.5 及以上為高質量）、authority（0–4，-1 表示未知）、date 等欄位。做 RAG 時可以先按 rerank_score 過濾，再決定要不要取全文。

#Fetch

只有一個 url 欄位，不超過 8192 字元，必須是 HTTP 或 HTTPS，不能帶使用者名稱密碼。

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"}'

返回 title 和 Markdown 格式的 content。能否抓到取決於目標站點的可用性和訪問策略。

#出錯了怎麼處理？

按官方的重試建議，狀態碼處理如下：

限流方面：Search 和 Fetch 各有 5 QPS 的賬號級限制，按賬號計算，兩者互相獨立。Fetch 另有按域名的 QPS 限制，同樣返回 429。

#11 月 1 日起怎麼收費？

計費規則有三點：

1. 單價都是 0.75 美元/千次成功請求，count 不影響價格。
2. 只有返回 HTTP 200 且有結果才計費：Search 的 results 非空，Fetch 取到了頁面內容。失敗、空結果、超時都不收費。
3. 透過 DeepSeek Harness、Claude Code、Codex 的服務端工具呼叫目前免費，官方說明按次計費從北京時間 2026 年 11 月 1 日 00:00 開始，即 UTC 10 月 31 日 16:00，價格以官方價格頁為準。

#月成本怎麼估？

月成本 ≈（月 Search 成功次數 + 月 Fetch 成功次數）÷ 1000 × 0.75 美元。

舉個假設的例子：一個 agent 每天平均成功搜尋 1000 次、抓取 2000 頁，按 30 天算，共 90000 次，約 67.5 美元。這只是演示演算法，你的實際次數要用日誌統計。注意 agent 的一次任務往往會觸發多次搜尋和抓取，建議先在日誌裡按介面記錄成功的 200 響應數，再乘單價。

#用 Claude Code 或 Codex 接 DeepSeek 的人要注意什麼？

如果你的搜尋走的是上述工具的服務端呼叫，11 月 1 日前不收費，之後會單獨計費，不再包含在模型 token 費用裡。接入方式可以參考：Claude Code 接自定義介面地址。對賬時按“token 費用”和“搜尋/抓取費用”分開看，核對方法見API 計費不對怎麼查。

建議在 11 月 1 日前做三件事：

• 統計最近一週的搜尋和抓取次數，用上面的公式估一個月成本。
• 在應用裡給搜尋設定次數上限，避免 agent 迴圈呼叫。
• 請求遇到 429 時做指數退避，別在 5 QPS 之外硬撐併發。

#怎麼盯住價格和可用性變化？

DeepSeek 的價格頁和更新日誌可以在 cdnping 的官網動態裡檢視逐行變動，也支援 RSS。API 入口是否可達，看 DeepSeek API 狀態，cdnping 每 5 分鐘從 Cloudflare 邊緣探測官方入口。需要判斷是不是自己這邊的問題，可以對照怎麼看 AI 服務狀態頁，或者直接看 DeepSeek 掛了嗎。注意，狀態探測只覆蓋入口可達性，不代表搜尋介面本身的成功率。

#參考來源

• DeepSeek Search & Fetch API 官方指南
• DeepSeek 2026-10-17 公告
• DeepSeek 模型與價格