如何使用 Deepseek V4 API

CometAPI
AnnaApr 24, 2026
如何使用 Deepseek V4 API

DeepSeek V4 不再只是傳聞或預告。截止至 April 24, 2026,DeepSeek 的官方文件表示 V4 預覽版已上線、開源,並可透過 API 使用,提供兩個變體:DeepSeek-V4-ProDeepSeek-V4-Flash。官方發佈重點包括 1M-token 上下文視窗、雙重推理模式,且 API 同時相容 OpenAI ChatCompletionsAnthropic 格式。DeepSeek 也表示舊版模型名稱 deepseek-chatdeepseek-reasoner 將於 July 24, 2026 退役。

對開發者而言,這種組合重要的原因很簡單:它降低了遷移摩擦,同時提高了你可構建內容的上限。你不需要學習全新的 API 形態;你只是更新模型名稱、保持 base URL 不變,並在更大的上下文視窗與更新的推理行為下交付。DeepSeek 的官方文件明確表示要保持 base URL,並將 model 參數改為 deepseek-v4-prodeepseek-v4-flash

在產品層面,V4-Pro 在智能體式編碼、世界知識與高難度推理方面更強,而 V4-Flash 則是更快、更經濟的選擇,對簡單的智能體任務仍有良好表現。CometAPI 以非常低的成本提供對兩個模型的存取。

DeepSeek V4 效能基準

DeepSeek 的預覽發佈將 V4-Pro 描述為 1.6T total / 49B active parameter 模型,將 V4-Flash 描述為 284B total / 13B active parameter 模型。同一公告稱,V4-Pro 在智能體式編碼基準上達到開源 SOTA,在世界知識方面領先目前的開源模型(除 Gemini 3.1 Pro 外),並在數學、STEM 與編碼上擊敗現有開源模型、並可與頂級閉源模型分庭抗禮。與此同時,V4-Flash 被描述為在推理品質上逼近 V4-Pro,且在簡單智能體任務上與之相當,同時保持更小、更快、更省成本。

V4-Pro 在多個代表性任務上相較 V3.2-Base 有所提升,包括 MMLU-ProFACTS ParametricHumanEvalLongBench-V2。這使其對於構建長上下文助理、重度代碼流程與知識密集型應用的團隊尤其相關。

基準表:V3.2 vs V4-Flash vs V4-Pro

BenchmarkV3.2-BaseV4-Flash-BaseV4-Pro-Base
AGIEval (EM)80.182.683.1
MMLU (EM)87.888.790.1
MMLU-Pro (EM)65.568.373.5
HumanEval (Pass@1)62.869.576.8
LongBench-V2 (EM)40.244.751.5

這些數字在實務中的意義

如果你在構建聊天機器人,基準差異可能感覺抽象;但如果你在構建倉庫級的編碼助理、合約分析工具,或需要在多次工具呼叫中維持長任務狀態的內部智能體,這樣的基準輪廓就會變得非常具體。更高的長上下文分數可轉化為更少的細節遺漏、更好的跨文件推理,以及更少在實際流程中出現的「請再重複一次」失敗。這正是 DeepSeek 發佈強調長上下文效率與智能體行為而非僅僅是純聊天品質的原因。

如何使用 DeepSeek V4 API

最簡潔的整合思路如下:

DeepSeek V4 使用與早期 DeepSeek 聊天模型相同的 API 介面,但你需要切換到新的 V4 模型名稱、保持 base URL 不變,並決定採用 V4-Pro 或 V4-Flash。 CometAPI 也確認同時支援 OpenAI 風格與 Anthropic 風格的介面。

步驟 1 — 取得 API 存取

DeepSeek 的首次呼叫文件表示,在呼叫模型前需要從 DeepSeek 平台取得一個 API 金鑰。官方文件展示了聊天端點、Bearer Token 模式與目前的 V4 模型名稱。

步驟 2 — 設定 base URL 與模型名稱

對於官方 DeepSeek API,文件記載的 base URL 為:

模型名稱為 deepseek-v4-flashdeepseek-v4-pro。DeepSeek 也指出,deepseek-chatdeepseek-reasoner 為舊版名稱,在過渡期間會對應至 V4-Flash 行為,並將於 2026-07-24 退役。

步驟 3 — 發送你的第一個請求

一個最小的 OpenAI 相容請求如下:

curl https://api.deepseek.com/chat/completions \  -H "Content-Type: application/json" \  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \  -d '{    "model": "deepseek-v4-pro",    "messages": [      {"role": "system", "content": "You are a helpful assistant."},      {"role": "user", "content": "Explain the difference between V4-Pro and V4-Flash."}    ],    "stream": false  }'

DeepSeek 的官方文件顯示相同的請求模式,並確認可透過將 stream 設為 true 啟用串流。

步驟 4 — 啟用思考模式、工具呼叫與串流

V4 模型支援思考/非思考模式JSON 輸出工具呼叫聊天前綴補全。模型也支援最高 1M context384K tokens 的最大輸出。

一個實用的 Python 範例:

from openai import OpenAIclient = OpenAI(
    base_url="https://api.cometapi.com",
    api_key="YOUR_DEEPSEEK_API_KEY",
)response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "You are a senior coding assistant."},
        {"role": "user", "content": "Review this architecture for bottlenecks."}
    ],
    stream=False,
    extra_body={
        "thinking": {"type": "enabled"},
        "reasoning_effort": "high"
    }
)print(response.choices[0].message.content)

此模式反映了 DeepSeek 在文件中對推理控制與思考模式的支援。

步驟 5 — 測試並投入生產

在你將此投入生產前,請驗證三件事:

  1. 你的工作負載是否真的受益於更大的上下文視窗。
  2. 模型是否應預設使用思考模式,或在非思考模式下快速作答。
  3. 工具呼叫對於你的流程是否至關重要,特別是對智能體與編碼助理。

V4 為智能體用例而設計,並已整合如 Claude Code 與 OpenCode 等工具。

DeepSeek V4-Pro vs V4-Flash vs V3.2

對多數團隊而言,正確選擇不是「哪個模型最好?」而是「哪個模型最適合這個工作負載?」答案取決於延遲、成本、推理深度與上下文長度。DeepSeek 的發佈將 V4-Pro 定位為面向艱難推理與智能體式編碼的旗艦,而 V4-Flash 則是高吞吐工作負載的高效選擇,同時仍具備強大的長上下文表現。V3.2 仍是較舊的基準,用於比較與遷移規劃。

Model最適用於優勢取捨
DeepSeek V4-Pro重度推理、編碼、智能體、研究V4 中整體能力最強;最適合高難度任務成本較高、計算資源占用較大
DeepSeek V4-Flash快速助理、長文檔流程、高吞吐回應更快;經濟;仍支援 1M 上下文在最難、知識最密集的任務上略弱
DeepSeek V3.2基準比較、過渡規劃可作為參考基準舊世代;不應作為新系統的目標狀態

這是我對產品團隊實務上的建議視角:
如果流程是關鍵任務,從 V4-Pro 開始。
如果流程以量為主且敏感於延遲,從 V4-Flash 開始。
如果你在遷移既有系統,使用 V3.2 作為基準參考,而非最終目的地。

DeepSeek V4 最適用的場景

編碼助理

DeepSeek 的發佈特別點名其在智能體式編碼上的表現,並與 Claude Code、OpenCode 等工具整合。這使 V4 對於程式碼審查副駕、倉庫級重構助理,以及需要在多輪互動中記住長任務狀態的開發者向智能體特別具吸引力。

長文檔分析

1M-token 上下文視窗是頭條功能,但真正的價值在於它解鎖了什麼:長合約、盡職調查資料包、事故日誌、支援維基與內部知識庫都可在不切成細小分塊的情況下處理。DeepSeek 的文件明確將此版本定位在超高上下文效率與降低計算/記憶體成本上。

智能體工作流程

如果你的產品使用工具呼叫、多步規劃或串聯動作,V4 比一般聊天模型更有看頭。DeepSeek 表示兩個 V4 變體都支援工具呼叫與思考模式,且預覽發佈指出 V4 已針對智能體能力進行優化。

搜尋、研究與支援系統

構建以搜尋為重的研究工具或客服系統的團隊,往往需要兼顧召回與結構化。DeepSeek 文件所述對 JSON 輸出與長輸出長度的支援,使 V4 成為這類系統可信的選擇,特別是當使用者體驗依賴穩定且結構化回覆,而非短對話時。

在生產中使用 DeepSeek-V4 API 的最佳實務

首先,按工作負載而非習慣選模型。對長文檔剖析、高吞吐助理與快速智能體迴圈使用 V4-Flash。當任務仰賴更困難的推理、更豐富的知識,或在複雜編碼與研究流程上需要更可靠的表現時,使用 V4-Pro。DeepSeek 的預覽說明與第三方模型頁面都指向這個方向。

其次,圍繞 1M-token 上下文視窗進行設計,但不要假設上下文越大答案就越好。大型上下文對合約、代碼庫、研究資料包與支援知識庫很有價值,但仍受益於良好的檢索、分塊與摘要紀律。DeepSeek 明確將 V4 定位於長上下文效率,並表示 1M 上下文是其官方服務的預設。

第三,保持你的提示結構化。因為 V4 支援 JSON 輸出與工具呼叫,它很適合抽取、分類、文檔分流、智能體路由與代碼輔助等流程。這些是長上下文與顯式推理最能發揮所長的區域。

第四,仔細監控遷移時程。如果你的堆疊仍呼叫 deepseek-chatdeepseek-reasoner,現在就規劃升級路徑。DeepSeek 已宣布這些舊名將於 2026-07-24 退役,且目前為相容性而對應至 V4-Flash 模式。

常見錯誤與避免方式

將 V4 當作一般聊天模型

最常見的錯誤是把 DeepSeek V4 當作普通的問答機器人並止步於此。那會浪費可用的效能空間。此次發佈明確是為了推理、編碼、工具與長上下文用例。如果你沒有使用這些能力,你基本上在為用不到的空間買單。

忽略上下文限制與推理模式

另一個錯誤是假設「1M 上下文」意味著可以忽略提示設計。你仍然需要清晰的結構、相關性篩選與理性的記憶策略。DeepSeek 支援思考與非思考模式,因此你的應用應該明確決定何時花費 token 在更深層推理,何時快速作答。

從舊模型名稱遷移得太晚

DeepSeek 已宣布 deepseek-chatdeepseek-reasoner 將於 2026-07-24 退役。如果你的產品仍然硬編碼這些名稱,遷移負債不再是假設,而是一個日程項目。

工具呼叫、JSON 輸出與智能體工作流程

DeepSeek-V4 支援工具呼叫JSON 輸出,使其適合用於結構化自動化,而不僅僅是純聊天;在非思考模式與思考模式下的工具呼叫皆受支援,意味著模型可以先進行推理、呼叫工具,然後在取得新資訊後繼續回應。

對智能體工作流程而言,有一個細節尤其重要:當一個思考回合包含工具呼叫時,隨後的請求必須完整傳遞 reasoning_content。這是一個達到生產級的實作細節,而非小註腳,因為智能體系統常常因截斷或錯誤處理中間推理狀態而失敗。

結論

DeepSeek V4 對於重視長上下文推理、編碼輔助與智能體工作流程的團隊而言,是一次有意義的升級。官方發佈為這次上線提供了實質支撐:兩個模型變體、相容 OpenAI 與 Anthropic、1M 上下文、工具呼叫支援,以及從舊版 DeepSeek 模型名稱的清晰遷移路徑。

如果你的用例複雜、對延遲敏感,或以多步推理為核心,請先測試 V4-Pro。如果你的優先考量是速度、吞吐與成本紀律,V4-Flash 是更好的起點。而若你希望在多個模型供應商間更快交付、又不增加整合混亂,CometAPI 作為一個實用層,能提供存取、可觀測性與模型可移植性。

準備好將 AI 開發成本降低 20% 了嗎?

幾分鐘內免費開始。包含免費試用點數。無需信用卡。

閱讀更多