DeepSeek Search API：定價與 Python 搜尋至 Fetch 擷取範例

文件查核日期：2026 年 10 月 20 日。下方範例已使用測試資料在本機檢查，尚未對付費的正式端點執行。

DeepSeek Search API 讓應用程式能取得網路搜尋結果。搭配使用的 Fetch API 則將單一網頁擷取為 Markdown。DeepSeek 於 2026 年 10 月 17 日開放這兩個介面，並分別按呼叫次數計費。依公布的美元費率，兩者每 1,000 次應計費請求各為 $0.75。它們使用 DeepSeek API 金鑰與官方 api.deepseek.com 位址。來源：發布公告、定價。

本指南示範先搜尋一次，再視情況擷取網頁。範例使用的是 DeepSeek 自有服務，並非說明 SeedRouter 提供的 Search 或 Fetch 端點。

DeepSeek Search API 與 Fetch API 有什麼不同？

Search 尋找候選網頁。Fetch 讀取你已選定的網頁。

兩者都接受 JSON，並使用 Bearer 驗證。獨立的搜尋請求包含 query；擷取請求則包含 url。它們是各自獨立的請求，不是能為每次聊天補全自動加入網路存取的設定。官方 Search 與 Fetch 指南提供了兩個介面的文件。

Search 也接受 need_content。當它設為 true 時，搜尋結果可以包含網頁內容。送出另一個請求前，請先檢查回傳內容：如果已包含所需資訊，就可能不必再單獨呼叫 Fetch。

執行 Python 範例前的準備

你需要 Python 3、可對外連線的 HTTPS 網路環境，以及具有適當帳號存取權限的 DeepSeek API 金鑰。請在執行腳本的終端機中，將金鑰存入環境變數：

export DEEPSEEK_API_KEY="your-deepseek-api-key"

範例使用 Python 標準函式庫，不需安裝套件。它會送出一次 Search 請求。如果有結果，就印出第一筆結果的標題與 URL，接著擷取該網頁。執行時可能產生費用；程式不會印出金鑰。

Python 範例：搜尋、選擇結果並擷取內容

將以下內容儲存為 deepseek_search.py。執行前，先將 QUERY 改成你需要查詢的資訊。

import json
import os
import urllib.error
import urllib.request

BASE_URL = "https://api.deepseek.com"
QUERY = "Python documentation pathlib"


def call(path, payload):
    request = urllib.request.Request(
        BASE_URL + path,
        data=json.dumps(payload).encode("utf-8"),
        headers={
            "Authorization": "Bearer " + os.environ["DEEPSEEK_API_KEY"],
            "Content-Type": "application/json",
        },
        method="POST",
    )
    try:
        with urllib.request.urlopen(request, timeout=30) as response:
            return json.load(response)
    except urllib.error.HTTPError as error:
        raise RuntimeError(f"DeepSeek returned HTTP {error.code}") from None


def main():
    search = call(
        "/v1/tools/search",
        {"query": QUERY, "count": 5, "need_content": False},
    )
    results = search.get("results", [])
    if not results:
        print("No search results; no Fetch request was made.")
        return

    selected = results[0]
    print(selected.get("title", "Untitled result"))
    print(selected["url"])

    page = call("/v1/tools/fetch", {"url": selected["url"]})
    content = page.get("content", "")
    if not content:
        print("The selected page returned no content.")
        return
    print(page.get("title", ""))
    print(content)


if __name__ == "__main__":
    main()

執行方式：

python3 deepseek_search.py

這是一個小型範例，因此直接選取第一筆結果。在實際應用程式中，應選擇符合問題的網頁，檢查其網域與發布背景，並將 URL 與擷取文字一起保留。搜尋排名最前面的結果，仍須與你要產生的答案相關。

請求格式依循 DeepSeek 的 Search 參考文件與 Fetch 參考文件。本機語法檢查與測試資料驗證，可以確認程式如何組成請求及選擇執行分支，但無法確認正式服務的帳號存取權、回應速度或擷取品質。

DeepSeek Search API 定價：哪些請求會計費？

公布的美元價格為 Search 每 1,000 次成功且應計費的請求 $0.75，Fetch 亦同。搜尋沒有結果時不計費；Fetch 則在成功擷取內容時收費。透過 count 指定的結果數量，不會改變單次搜尋的價格。計費條件請參閱目前的價格表。

舉例來說，1,000 次應計費搜尋加上後續 1,000 次應計費擷取，擷取相關費用合計為 $1.50。這是依公布費率計算的示例，不是實測帳單，也不是對任何特定查詢結果的保證。之後用模型摘要這些網頁所消耗的 token，屬於另一筆費用。

限時免費的適用範圍更窄。DeepSeek 表示，其 API 使用者透過 DeepSeek Harness、Claude Code 與 Codex 伺服器端工具發出的 Search／Fetch 呼叫，暫時不計費。這類用量將從 2026 年 10 月 31 日 16:00 UTC 開始計費，也就是北京時間 11 月 1 日 00:00。公告並不代表本指南中的獨立 Python 請求一律免費。官方公告。

需要考量的參數與失敗情況

文件規定搜尋查詢長度為 1–128 個 Unicode 字元。count 預設為 10，接受 1–50。Python 範例刻意只要求五筆結果，並將網頁內容的擷取留給後續 Fetch 請求。加入其他欄位來擴充請求前，請先查閱 Search 參考文件。

空的結果陣列代表搜尋成功，但沒有符合的結果。範例會在此停止。HTTP 錯誤會另外處理，逾時則讓執行停止，不會自動建立另一個請求。較大型的應用程式應明確設定重試次數上限與額外支出。

擷取到的 Markdown 是外部來源資料。請保留來源 URL，檢查內容是否回答了問題，並將網頁內嵌的指示視為網頁內容，而非對應用程式下達的指令。若將內容傳給語言模型，請在提示詞中維持這項區分，並在產生的答案中保留引用來源。

常見問題

DeepSeek API 可以搜尋網路嗎？

可以。獨立的 Search 與 Fetch 介面已有文件。呼叫一般聊天端點與呼叫這些擷取端點，是不同的操作；請依你正在建立的工作流程，遵循對應的規格。

DeepSeek Search API 有免費方案嗎？

引用的公告描述的是特定程式開發代理整合中，伺服器端工具的限時免費使用。它沒有確立適用於所有獨立 Search 或 Fetch 請求的一般免費方案。批次執行前，請先檢查目前的計費頁面。

每次搜尋後都需要 Fetch 嗎？

不需要。搜尋可能已提供足夠資訊，尤其在 need_content: true 回傳可用內容時。需要單獨擷取所選網頁時，再使用 Fetch 即可。

先從一條擷取流程開始

DeepSeek Search API 用來尋找來源，Fetch 則擷取選定的網頁。先從一個查詢開始，檢查結果與內容，再決定應用程式是否需要更多網頁或模型產生的摘要。同一天公布的另一項模型更新，請參閱 10 月 17 日模型檢查點更新：基準測試與變動。