API功能與技術規格

Search API用於根據查詢尋找網頁並返回結構化結果，由DeepSeek內部搜尋引擎驅動。請求需包含query欄位（1至128個Unicode字元），可選參數包括count（返回結果數量，預設10，範圍1-50）、ori_question（原始問題以優化理解）、localization（IP地址用於本地化）及need_content（是否返回頁面內容）。

Fetch API則用於抓取單一網頁並將其內容轉換為Markdown格式。請求需提供url欄位，長度不超過8192字元，必須是包含主機的HTTP或HTTPS網址，且不含用戶名或密碼。抓取結果受目標網站的可用性及存取政策影響。

搜尋查詢運算子與結果欄位

Search API支援多種查詢運算子以精確控制結果，包括site:（限定特定網站）、-site:（排除特定網站）、-（排除包含特定詞的頁面）、"..."（精確匹配短語）、lang:（限定語言代碼）、after:/before:（限定發布日期範圍）。這些運算子可組合使用，例如同時限定多個網站或語言。

成功的搜尋請求返回HTTP 200及results陣列。每個結果包含rerank_score（相關性分數0-3，1.5以上視為高品質）、title、url、snippet（UI顯示用短摘要）、summary（模型閱讀用長摘要）、content（頁面內容，若need_content為false則為空）、site_name、site_icon、date及authority（權威等級0-4，3以上為高權威來源）。無匹配結果時返回空陣列。

計費模式與免費期限制

Search與Fetch API均按成功請求數量計費，而非按Token或返回結果數量。每1,000次成功請求收費0.75美元。只有當請求返回HTTP 200且產生有效結果時才計費：Search必須返回非空的results陣列，Fetch必須返回頁面內容。失敗請求、空搜尋結果及超時均不計費。

count參數僅控制返回結果的數量，不會影響單次請求的價格。值得注意的是，當透過DeepSeek Harness、Claude Code或Codex使用DeepSeek API時，伺服器端的工具呼叫已包含Search與Fetch功能。這些呼叫目前免費，但將於北京時間2026年11月1日00:00開始實施按請求計費。

速率限制與錯誤處理

每個帳戶的Search與Fetch API有獨立的QPS（每秒請求數）限制，各為5 QPS。流量互不消耗配額，且此限制在帳戶層級計算，與使用的API金鑰無關，也獨立於模型並發限制。超過帳戶層級QPS限制的請求將收到HTTP 429錯誤。此外，Fetch API還受域名層級的QPS限制，超過該限制同樣返回HTTP 429。

錯誤處理遵循OpenAI相容格式。常見錯誤包括：400（請求標頭或主體無效）、401（API金鑰缺失或無效）、402（帳戶餘額不足）、403（Fetch被安全政策拒絕）、404（無法取得可用頁面內容，如URL不可用、被網站政策封鎖或不支援的內容類型）、408（讀取請求主體超時）、413（請求主體過大）、429（超過QPS限制）、500（內部伺服器錯誤）及504（下游請求超時）。對於408、429或5xx錯誤，建議等待後重試；對於402錯誤，需先充值帳戶。其他4xx錯誤若不修改請求則不應重試。