作者注:deepseek-flash 已能內置聯網搜索,但思考開關會改變搜索方式,賬單按 query 計次,下一輪只保留回答正文。本文講清三處和普通工具調用不同的地方,以及什麼時候不該讓模型自己搜。
2026-11-13,DeepSeek 官方宣佈把 App 裏的對話能力開放到 API。這次帶上這套能力的只有 deepseek-flash,對應版本是 DeepSeek-V4.1-Flash-1017。聲明一個 deepseek_web_search,deepseek-flash 就能自己上網,工具調用和上下文拼接都在服務端完成。
很多人會把它理解成”打開一個開關,剩下的和普通函數調用一樣”。這不是一個簡單的開關。思考開不開,搜索方式就不一樣;返回裏顯示的次數並不是扣費次數;到了下一輪,模型搜過、讀過、想過的東西都不在上下文裏。
核心價值:讀完本文,你會知道 deepseek-flash 在思考、賬單、下一輪這三處和普通工具調用有什麼不同,也能判斷什麼時候該讓模型自己搜,什麼時候該由程序來搜。

deepseek-flash 會搜也會忘:三處核心要點
先給出結論。下表列的是 deepseek-flash 內置搜索和你熟悉的”模型發起調用、程序執行、結果回傳”之間的三處差別。
| 要點 | deepseek-flash 的實際行爲 | 和普通函數調用的差別 |
|---|---|---|
| 思考 | 思考關閉時是帶引用的網頁或圖片搜索;思考打開時變成深度思考搜索 | 同一個工具聲明,會因爲思考開關變成兩種流程 |
| 賬單 | 內置搜索按 query 條數計次,一次搜索裏有三個 query 就算三次 | 不是”調用一次算一次”,usage 裏的次數也不等於扣費次數 |
| 下一輪 | 搜索結果、打開過的頁面和思考都不進入下一輪,只保留回答正文 | 普通函數調用的結果通常由你自己寫回歷史,可以保留 |
deepseek-flash 三處差別的由來
三處差別都來自同一個設計:工具調用發生在服務端。你看不到中間的 tool call 消息,也沒有機會決定哪些內容寫回歷史。服務端替你搜索、讀取、拼接上下文,回答結束後中間過程也一併丟掉。
這樣接入很省事,代價是控制權少了。哪些 query 被發出去、打開了哪幾頁、下一輪還能不能引用上一輪的原文,都由服務端決定。理解了這一點,後面三節的內容就都能對上。
deepseek-flash 的思考開關如何改變搜索
官方文檔 Build a Chatbot 給出的對照很明確:同樣聲明 deepseek_web_search,思考開關不同,行爲就不同。

| 思考開關 | 聲明的工具 | 實際行爲 | 鏈接會不會另讀 |
|---|---|---|---|
| 關閉 | deepseek_web_search |
按問題搜網頁或圖片,回答帶引用 | 不涉及 |
| 關閉 | deepseek_web_search + deepseek_read_url |
帶引用搜索,用戶消息裏的鏈接另行抓取 | 會 |
| 打開 | deepseek_web_search |
深度思考搜索,多步推理中自己搜、自己打開頁面 | 由模型自己決定打開哪些頁 |
| 打開 | deepseek_web_search + deepseek_read_url |
仍是深度思考搜索 | 不會單獨讀鏈接 |
| 任意 | 只有 deepseek_read_url |
識別用戶消息裏的鏈接並抓取 | 會 |
deepseek-flash 深度思考搜索的兩個坑
第一個坑是鏈接讀取。用戶貼了一個鏈接,你以爲聲明瞭 deepseek_read_url 就一定會讀這一頁。但只要思考打開、同時聲明瞭 deepseek_web_search,這一輪就走深度思考搜索,鏈接不再單獨讀取,要不要打開這頁由模型在推理中決定。如果你的產品承諾”貼鏈接就讀原文”,要麼關掉思考,要麼這一輪只聲明 deepseek_read_url。
第二個坑是參數。打開 deepseek_web_search、deepseek_read_url、safety_check 爲 high 或者打開 title 之後,服務端會忽略一批採樣參數,比如 temperature、top_p,三條協議忽略的名單不完全相同。max_tokens(Responses 協議裏是 max_output_tokens)仍然生效,但它限制的是一輪裏每一步推理的輸出,不是整輪合計。所以在深度思考搜索裏,用 max_tokens 估算一輪的成本上限是不準確的。
deepseek-flash 聯網賬單怎麼算
賬單是最容易算錯的地方,因爲這裏有兩套計數單位,下面分開說。

| 場景 | 計數單位 | 怎樣算一次 | 不計費的情況 |
|---|---|---|---|
| 內置網頁搜索 | query | 返回結果的一次搜索裏有幾個 query 就算幾次 | 失敗、沒有結果 |
| 內置圖片搜索 | 圖片 + 區域 | 每張圖算 1 次,模型在圖裏框出的每個區域再加 1 次 | 失敗、沒有結果 |
| 內置讀鏈接 | 成功抓取的頁 | 抓到就計費,包括隨後因安全審覈被替換成 url_not_allowed 或 unavailable 的頁 |
抓不到的鏈接 |
| 深度思考搜索裏重複訪問 | 真實抓取 | 只有真正從網上抓的那一次計費 | 同一頁再次打開、頁內移動、內容已隨搜索結果帶回 |
| 獨立 Search / Fetch 接口 | 成功請求 | HTTP 200 且有結果纔算一次,count 不改變這次的價格 |
失敗、空結果、超時 |
官網價目頁(2026-11-15)上,Search(文本和圖片)和 Web fetch 都是每 1000 次 0.75 美元。單價相同,但內置工具”一次”指一個 query,獨立接口”一次”指一個成功請求,兩者的數量不能直接比較。
deepseek-flash 的 usage 字段別看錯
返回的 usage 裏有兩組看起來很像的字段,含義並不相同:
| 字段 | 含義 | 能不能用來對賬 |
|---|---|---|
web_search_requests |
展示用的搜索結果塊數量,包含錯誤 | 不能 |
web_fetch_requests |
展示用的抓取結果塊數量,包含錯誤 | 不能 |
tool_search |
計費的搜索次數 | 能 |
tool_fetch |
計費的抓取次數 | 能 |
tool_image_search |
計費的圖片搜索次數 | 能 |
如果你按 web_search_requests 做用量統計,數字可能會偏高,因爲裏面包含失敗的結果塊;同時它又看不出一次搜索裏有幾個 query。對賬要用 tool_* 這三個字段。
工具費是 token 費之外另外收取的。官網 deepseek-flash 的 token 價分高峯和閒時:高峯是週一到週五 UTC 01:00–04:00 和 06:00–10:00(不含中國法定節假日),其餘時間都是閒時,閒時價格是高峯的一半。
deepseek-flash 下一輪爲什麼”忘了”
官方文檔說明,多輪對話中,上一輪的搜索結果、打開的頁面和思考都不會進入下一輪上下文,只保留回答正文。
所以標題裏的”會忘”,指的是上下文被清掉,並不是說模型沒搜到。上一輪它可能讀了五個頁面、引用了三段原文,到下一輪手裏只有自己寫出的那段回答。用戶追問”第二個來源原文怎麼說的”,模型要麼重新搜一遍(又產生一次工具費),要麼只能根據自己的回答去推測。

什麼時候不該讓 deepseek-flash 自己搜
下面這些情況,更適合由程序來決定搜什麼,而不是交給模型:
- 需要跨輪引用原文:比如法規條款、合同、長文檔問答,下一輪還要依據原文回答。
- 需要可預測的賬單:深度思考搜索會發出幾個 query、打開幾頁,事先無法控制。
- 需要限定信息源:只允許某幾個站點,或者必須排除某些站點。
- 貼鏈接必須讀原文:思考打開時鏈接可能不會被單獨讀取。
- Key 不在 DeepSeek 官網:所用平臺不一定已經接上內置工具,下一節具體說明。
deepseek-flash 快速上手:想把網頁留住怎麼做
想把網頁留在上下文裏,做法是把”搜”和”答”拆開:程序調用搜索和抓取接口,自己把正文拼進 messages,再交給 deepseek-flash 回答。這樣網頁原文在你自己保存的歷史裏,下一輪不會丟失。
API易 apiyi.com 上已經有兩個獨立接口可用:deepseek-search 和 deepseek-fetch,2026-10-21 上架。它們不是對話模型,不消耗 token,按成功請求次數計費,計費規則與官網獨立接口一致。步驟如下:
- 在 API易 控制檯新建令牌,分組選
default或svip。用 ClaudeCode 分組會返回 503,錯誤原文是no available channels for model deepseek-search。 - 搜索:
POST到/v1/tools/search,基址https://api.apiyi.com,請求體不需要model字段。 query必填,1–128 個字符,支持site:、-site:、引號、lang:、after:、before:count取 1–50,默認 10,不影響價格need_content默認false,設爲 true 時會一併返回正文localization填用戶 IP,填zh-CN這類語言代碼會返回 400- 抓取:選中要讀的鏈接,
POST到/v1/tools/fetch,url必須是帶域名的 http 或 https 地址,最長 8192 個字符,不能包含用戶名和密碼。 - 回答:把截取後的正文作爲一條消息放進 messages,調用
deepseek-flash,OpenAI 兼容的base_url設爲https://api.apiyi.com/v1。 - 保留:把這段網頁正文寫進你自己的對話歷史,下一輪繼續帶上,或者只保留摘要以控制 token。
上游限流按文檔:Search 爲 100 QPS,Fetch 爲 25 QPS,同一域名另有限制。文檔複測還提到兩點:亂碼關鍵詞也可能返回幾條結果並照常計費;有些站點對不存在的頁面會返回首頁(軟 404),Fetch 會當成成功請求計費。抓取前最好自己先過濾一遍鏈接。
🎯 技術建議:需要跨輪引用原文的場景,建議先在 API易 apiyi.com 用新用戶的免費測試額度把”search → fetch → deepseek-flash”這條鏈路跑通,確認正文截取長度和計費次數符合預期後再上線。
deepseek-flash 的 Key 不在官網時要注意什麼
需要說清楚的一點:截至 2026-11-15,API易 的型號總表和實時動態都沒有寫明 deepseek-flash 已經支持 deepseek_web_search。實時動態裏最新一條 DeepSeek 相關內容是 2026-11-11 的經濟版上線,11 月 13 日這套 App API 還沒有出現。因此在 API易 上調用 deepseek-flash,不能認爲聲明 deepseek_web_search 就能讓它自己搜,目前它的定位是回答模型。
下表是 2026-11-15 的價格數據,token 價單位爲美元 / 100 萬 token,按次型號單位爲美元 / 次:
| 型號 | API易 apiyi.com 標價 | 官網對照 | 說明 |
|---|---|---|---|
deepseek-flash |
輸入 0.3,輸出 1.2,緩存讀 0.006 | 高峯同爲 0.3 / 1.2 / 0.006,閒時減半 | 總表沒有閒時半價 |
deepseek-search |
0.0009 / 次(即 0.90 / 1000 次) | 0.75 / 1000 次 | 分組僅 default、svip |
deepseek-fetch |
0.0009 / 次(即 0.90 / 1000 次) | 0.75 / 1000 次 | 分組僅 default、svip |
能力頁寫的 0.90 美元 / 1000 次和總表的 0.0009 美元 / 次是同一個標價。按 API易 文檔,計入充值加贈後,充值大客戶實付約 0.75 美元 / 1000 次,與官網持平;一般用戶實付約 0.82 美元 / 1000 次。這兩個是加贈折算後的數字,不是總表標價。價格含稅,可以開票。
另外,OCR、ASR、TTS 在 API易 暫未上架,我們會盡快上架這個模型;型號與價格以平臺型號列表爲準。
💡 選擇建議:如果業務需要官網內置搜索的”模型自己多步搜”,目前要用官網的 Key;如果更看重原文可留存、賬單可預測,用 API易 apiyi.com 的獨立接口加 deepseek-flash 回答,整個流程都在你自己手裏。
常見問題 FAQ
Q1: deepseek-flash 的內置搜索是什麼?
它是 deepseek-flash(V4.1-Flash-1017)上的服務端工具 `deepseek_web_search`,在 Messages、Responses、Chat Completions 三條協議上都能使用。工具調用和上下文拼接由服務端完成,工具費在 token 費之外單獨收取。
Q2: deepseek-flash 自己搜和程序調用 Search / Fetch 有什麼區別?
內置搜索按 query 計次,中間結果不會留到下一輪;獨立接口按成功請求計次,`count` 不影響價格,返回的正文由你自己決定是否保留。前者接入更省事,後者更可控。
Q3: deepseek-flash 這套聯網能力是什麼時候發佈的?
DeepSeek 官方於 2026-11-13 發佈(北京時間 22:24),新聞頁和更新日誌是同一天。API易 上的 `deepseek-search` 和 `deepseek-fetch` 是 2026-10-21 上架的,與這次發佈不是同一件事。
Q4: 經濟版或 V4 Pro 能自己搜嗎?
官方說明這套對話能力只在 deepseek-flash 上提供,不要套用到 deepseek-v4-pro 或經濟版 ID 上。API易 的經濟版 `deepseek-v4-1-flash-economy-261017` 與 V4.1-Flash-1017 加載同一份權重,只是速度更慢。文檔所述的估算是首字約 2 秒、每 token 約 15 毫秒。它不是搜索接口。
Q5: 在 API易 怎樣讓 deepseek-flash 基於網頁回答?
用 `default` 或 `svip` 令牌調用 `/v1/tools/search` 和 `/v1/tools/fetch`,把正文拼進 messages,再調用 `deepseek-flash`。具體參數見 API易 apiyi.com 文檔中心的 DeepSeek Search / Fetch 頁面。
Q6: 對外提供服務時,安全設置要注意什麼?
官方要求對外提供服務時必須打開 `safety_check`(文檔示例 level 爲 high),並自行完成內容安全審覈、大模型登記和 AI 標識。打開後 `temperature` 等採樣參數會被忽略,模型拒答時 `stop_reason` 爲 `refusal`。模型安全按輸出 token 計費,不單列單價。
Q7: 一個 query 都沒搜到結果,會扣錢嗎?
內置搜索失敗或沒有結果時不計費。獨立接口只有在 HTTP 200 且有結果時才扣費,400 和抓取失敗的 404 不扣費。但文檔複測提到,亂碼關鍵詞和軟 404 仍可能被計費。
deepseek-flash 會搜也會忘 Key Takeaways
- 思考改變搜索方式:思考關閉是帶引用的搜索,思考打開是多步的深度思考搜索。
- 鏈接不一定被讀取:思考打開且聲明瞭
deepseek_web_search時,不會單獨讀鏈接。 - 賬單按 query 計次:一次搜索裏有三個 query 就算三次,失敗或空結果不計費。
- 對賬看 tool 字段:
web_search_requests只用於展示,扣費次數看tool_search等字段。 - 下一輪只剩回答:網頁、頁面和思考都會被丟掉,”會忘”指的是上下文。
- 想留住網頁就自己搜:在 API易 apiyi.com 用
deepseek-search加deepseek-fetch,再交給 deepseek-flash。
總結
deepseek-flash 會搜也會忘,要注意三件事:
- 思考:同一個
deepseek_web_search聲明,會因爲思考開關走兩條不同的流程,讀鏈接的行爲也隨之改變。 - 賬單:內置工具按 query、圖片和框選區域計次,獨立接口按成功請求計次,兩套單位不要混在一起算。
- 下一輪:只保留回答正文,需要跨輪引用原文時,應該由程序自己搜索並保存內容。
如果你的 Key 在 API易,目前文檔沒有寫 deepseek-flash 已接入內置搜索。可以先用 API易 apiyi.com 的免費額度把獨立接口加 deepseek-flash 的組合跑一遍,再決定是否需要官網的內置搜索。
📚 參考資料
- DeepSeek 新聞頁(2026-11-13):App 能力開放到 API 的公告
- 鏈接:
api-docs.deepseek.com/zh-cn/news/news261113 -
說明:確認只有 deepseek-flash 帶上這套能力
-
DeepSeek Build a Chatbot 指南:思考開關與工具組合的行爲對照
- 鏈接:
api-docs.deepseek.com/guides/build_a_chatbot -
說明:深度思考搜索、讀鏈接、多輪上下文規則
-
DeepSeek Web Tools 指南:內置工具的 Usage and Billing
- 鏈接:
api-docs.deepseek.com/guides/web_tools -
說明:按 query 計次、usage 字段含義
-
DeepSeek 價目頁:token 價、高峯與閒時、工具單價
- 鏈接:
api-docs.deepseek.com/quick_start/pricing -
說明:2026-11-15 數據
-
API易 DeepSeek Search / Fetch 文檔:獨立接口參數與計費
- 鏈接:
docs.apiyi.com/api-capabilities/deepseek-search-fetch/overview -
說明:分組要求、參數限制、文檔複測說明
-
API易 型號總表:實時型號與價格
- 鏈接:
docs.apiyi.com/models - 說明:型號與價格以此爲準
作者: APIYI 技術團隊
技術交流: 歡迎在 API易 apiyi.com 首頁聯繫我們,更多資料可訪問 docs.apiyi.com 文檔中心
