DeepSeek API 網頁搜尋與檔案上傳設定指南

DeepSeek 在 2026 年 11 月 13 日，透過 API 參數把 App 裡的功能帶到 API。內建搜尋由模型決定是否使用，依回傳結果的查詢次數計費；獨立的 Search／Fetch 則由程式控制，僅針對成功請求計費；檔案上傳則透過獨立的 Files API，再以 file_id 引用。

啟用思考功能後，一次請求可能展開約 20 次工具呼叫，並分別按照搜尋與擷取次數計費。本指南會帶你完成啟用、檔案上傳與單次任務的成本估算，也會說明各種情境該選哪條路。

11 月 13 日更新後，DeepSeek App API 多了什麼

DeepSeek 在公告〈The full DeepSeek App experience, now via API〉中宣布，deepseek-flash 模型（DeepSeek-V4.1-Flash）現在可透過 API 使用網頁搜尋、檔案輸入與網址讀取。

根據Build a Chatbot 指南，Messages API、Responses API 與 Chat Completions API 都能使用這組功能。工具呼叫與上下文組裝會在伺服器端完成，客戶端只要渲染結構化區塊，再原封不動地傳回即可。DeepSeek 也提供開源瀏覽器示範展示串接方式，但明確標示僅供示範。

啟用網頁搜尋與網址讀取

依照Web Tools 指南，在針對 deepseek-flash 的請求中，於 tools 陣列宣告以下兩個工具：

"tools": [{"type": "deepseek_web_search"}, {"type": "deepseek_read_url"}]

關閉思考功能時，deepseek_web_search 的行為接近聊天搜尋：由模型自行判斷是否搜尋，一次呼叫可以包含多個查詢，回答則會附上引用。開啟思考功能後，同一工具會變成深度思考搜尋，在不同推理步驟之間交錯使用搜尋、open_page 與 find_in_page，回答前最多大約執行 20 次工具呼叫。

同一份Web Tools 指南也列出四項限制：

只有最新一則使用者訊息中的網址會被計算，最多取前 10 個不重複網址，並由模型決定要讀取哪些網址。
無法透過 tool_choice 強制指定工具：指定某個工具會回傳 HTTP 400，而 "none" 也會一併停用網址讀取。
啟用網頁工具、高安全性模式或標題生成後，temperature、top_p 及數個工具控制欄位會被靜默忽略。
使用過網頁工具的回覆無法接續對話，必須重新送出請求。

「每 1,000 次請求收費 $0.75，我想知道代理程式在背景中會發出多少次呼叫。有人算過一般研究任務的成本嗎？」——r/DeepSeek 的 u/Glum-Guitar-5083

不同路徑的計費方式不一樣。內建網頁搜尋會按照「有回傳結果的查詢」計費，一次呼叫包含三個查詢就算三次；內建 Fetch 則按照實際擷取的頁面計費，包括之後因安全審查而被替換成 url_not_allowed 或 unavailable 的頁面，但無法擷取的連結不收費。獨立的 Search／Fetch 只有在 HTTP 200，且搜尋結果不為空或確實回傳內容時才計費。兩種路徑的失敗或空結果搜尋都不收費。

不用自行解析器也能上傳檔案

Files API 讓你先上傳檔案，之後再用 file_id 引用。最小流程如下：

curl https://api.deepseek.com/files \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -F purpose="rich_layout_recognition" \
  -F file="@report.pdf"
# -> {"id": "file-api-xxxxxxxxxxxxxxxx", ...}

# then reference it in chat (Chat Completions shape):
# {"model": "deepseek-flash", "messages": [{"role": "user",
#   "content": [{"type": "text", "text": "Compare this with today's numbers"},
#   {"type": "file", "file_id": "file-api-xxxxxxxxxxxxxxxx"}]}]}

purpose 會決定處理方式，而且對文件而言必須放在 file 欄位之前。user_data 接受圖片（JPEG、PNG、GIF、WebP）、純文字、試算表與電子書；text_recognition 會將 PDF、Word、PowerPoint 以及圖片解析成純文字；rich_layout_recognition 則會回傳文字，並保留表格與欄位中的圖形。以 user_data 上傳 PDF 會回傳 HTTP 400，而解析後的文件不能再當成圖片使用，也無法下載。

類別	上限
使用 `file_id` 的圖片	64 MiB（內嵌 Base64 則為 32 MiB）
PDF／Word／PowerPoint	100 MiB，120 秒上傳解析時間
文字／試算表／電子書	32 MiB，10 分鐘上傳處理期限
帳戶配額	25 GiB、10,000 個檔案；可設定 1 小時至 30 天後到期，或永久保存

檔案隸屬於帳戶，而不是 API 金鑰；同一個 ID 可在 OpenAI 相容與 Anthropic 相容系列中使用，後者需要加入 anthropic-beta: files-api-2025-04-14 標頭。解析會在上傳期間進行，因此只有成功完成後才會取得 file_id。

內建工具與獨立 Search、Fetch 怎麼選

如果希望模型在對話中自行決定要不要搜尋或讀取內容，就使用內建工具。若要由程式控制流程，則可使用Search & Fetch 指南中的獨立 API：POST https://api.deepseek.com/v1/tools/search 用於依排名尋找內容，最多回傳 50 筆結果；rerank_score 範圍為 0–3，其中 1.5 以上代表高品質，authority 範圍為 0–4。POST https://api.deepseek.com/v1/tools/fetch 則可將單一網址擷取成 Markdown。獨立 Search 目前還不支援圖片搜尋，但 Web Tools 支援。

路徑	控制方式	計費單位	適合用途
內建 `deepseek_web_search`／`deepseek_read_url`	由模型在伺服器端決定	每個有結果的查詢／每個擷取頁面	附引用的聊天、深度研究
獨立 Search + Fetch	由你的程式決定	每 1,000 次成功請求各收費 $0.75	代理程式、RAG 管線

速率限制以帳戶為單位，而且彼此獨立：Search 為 100 QPS，Fetch 為 25 QPS，另有每個網域的 Fetch 上限；超過配額會收到 HTTP 429。408、429 與 5xx 應重試，其他 4xx 則先修正請求。獨立 Search 支援查詢運算子，例如 site:、-site:、"exact phrase"、lang:、after:／before:。

實際成本怎麼算

工具費用會疊加在 Token 費用之上：Search 與 Fetch 各自按每 1,000 次成功請求收費 $0.75；OCR、ASR 與 TTS 也有各自的工具價格，並提供限時優惠，細節請參閱公告。調整 count 只會改變結果數量，不會改變價格。

開發者的價格比較顯示，DeepSeek 搜尋約為每 1,000 次 $0.75；OpenAI 與 Claude 搜尋則約為每 1,000 次 $10（@berryxia），單看工具費用就有約 13 倍差距。

單一查詢的回答，工具費用不到美分的十分之一。若是深度思考任務，執行 8 次查詢與開啟 6 個頁面，大約會被計為 8 次搜尋加 6 次擷取，在 Token 費用之前，總工具費仍低於兩美分。真正需要留意的是使用量：代理程式若連續執行數十次搜尋，$0.75 的計費單位很快就會累積。建議按照成功呼叫次數編列預算、限制深度搜尋層級，並從最終的使用量物件記錄 tool_search 與 tool_fetch；其中的 web_search_requests 僅供顯示，不是實際計費數量。

上線前檢查：引用、安全性與示範程式

根據Web Tools 指南，引用會以 web_search_result_location 區塊回傳，其中包含網址、標題與引用文字。串流模式下，引用會以 citations_delta 事件出現；每個文字區塊最多包含一個網址，而且如果在後續請求中原樣回傳，這些引用會被忽略。跨回合傳遞時，請完整保留 signature 欄位與工具區塊：頁面讀取內容會透過 signature 還原；即使 signature 無效或缺失，請求仍會成功，但頁面內容會被捨棄。聊天機器人指南中的範例追蹤顯示，工具執行後輸入 Token 會從 40 增加到 9,078，其中 4,096 個來自快取，因此必須為搜尋膨脹後的對話歷史預留足夠上下文。

對公開應用程式而言，DeepSeek 要求執行安全檢查，並將審核、模型註冊與 AI 內容標示交由開發者處理。內建審查應視為第一道篩選；請明確處理 refusal 停止原因，並預期頁面未通過審查時會出現 url_not_allowed。這類遭封鎖的擷取仍會計費。聊天示範程式展示了串接方式，但所有內容都在瀏覽器中處理，正式上線前請自行建置後端。

常見問題

可以強制模型每次請求都搜尋嗎？

不行。工具是否執行由模型決定，在 tool_choice 中指定網頁工具會回傳 400。

哪些模型與端點支援網頁搜尋和檔案上傳？

Messages、Responses 與 Chat Completions 都支援 deepseek-flash。檔案的 file_id 引用則可在 OpenAI 相容與 Anthropic 相容系列中使用。

上傳的檔案可以和網頁搜尋一起使用嗎？

可以。這就是聊天機器人指南記載的使用方式：將檔案內容與伺服器端搜尋結合，並附上引用。

一般代理程式任務會觸發多少次搜尋？

簡單問題可能只需一次呼叫、搭配幾個查詢；啟用思考功能的研究任務則可能執行約 20 次工具呼叫。請逐項任務統計 tool_search 與 tool_fetch：內建工具按查詢或頁面計費，獨立 API 按成功請求計費，兩者都是每 1,000 次 $0.75。

先在示範程式中完成一次內建搜尋請求與一次檔案上傳，查看最終使用量物件中的 tool_search 與 tool_fetch 計數，再決定每項任務的工具費用是否值得，或是否應自行架設 Tavily 或 SearXNG 層。