Skip to Content
模型用法DeepSeek

DeepSeek 系列

DeepSeek 的 V4 系列模型,包括 V4.1 Flash、V4 Pro 與 V4 Flash。透過 OpenAI 相容介面呼叫,同時支援 Anthropic 原生介面,可直接在 Claude Code 等工具中使用。

常見任務

模型

V4 系列上下文為 1M token,最大輸出 384K token。V4.1 Flash 支援圖片輸入,其餘模型僅支援文字。完整的模型清單與即時價格請參閱模型頁 。

常用模型 ID(呼叫時原樣複製)
DeepSeek V4.1 Flashdeepseek/deepseek-v4.1-flash支援圖片輸入
DeepSeek V4 Prodeepseek/deepseek-v4-pro-0813
DeepSeek V4 Flashdeepseek/deepseek-v4-flash-0731

別名與版本

別名指向說明
deepseek-v4-prodeepseek/deepseek-v4-pro-0813一律指向 V4 Pro 的最新版本
deepseek-v4-flashdeepseek/deepseek-v4-flash-0731一律指向 V4 Flash 的最新版本
deepseek-flashdeepseek/deepseek-v4.1-flash—
  • 別名須不帶 deepseek/ 前綴使用,例如 "model": "deepseek-v4-pro";寫成 deepseek/deepseek-v4-pro 會回傳 404。
  • DeepSeek 官方 API 的 deepseek-chat、deepseek-reasoner 在 OfoxAI 上無法使用,請改用上表的模型 ID。
  • 早期版本 deepseek/deepseek-v4-pro-0423、deepseek/deepseek-v4-flash-0423 仍可呼叫,開啟思考的方式與新版本不同,請見思考模式。

呼叫範例

deepseek_basic.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.chat.completions.create( model="deepseek/deepseek-v4-flash-0731", messages=[{"role": "user", "content": "用一句話解釋什麼是冪等性。"}], extra_body={"thinking": {"type": "disabled"}}, ) print(resp.choices[0].message.content)

思考模式

重點V4.1 Flash、V4 Pro、V4 Flash 預設開啟思考,複雜問題可能耗時 2 分鐘以上。不需要思考時,請將 thinking 的 type 設為 disabled。
模型預設關閉思考開啟思考
V4.1 Flash、V4 Pro(0813)、V4 Flash(0731)開啟"thinking": {"type": "disabled"}預設即開啟
V4 Pro(0423)、V4 Flash(0423)關閉預設即關閉"reasoning_effort": "high"

實測同一道數學題,V4 Pro 預設思考約 1.2 萬 token、耗時約 2 分鐘;關閉思考後約 20 秒。思考 token 依輸出單價計費,數量請見 usage.completion_tokens_details.reasoning_tokens。

讀取思考內容

deepseek_reasoning.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.chat.completions.create( model="deepseek/deepseek-v4-flash-0731", messages=[{"role": "user", "content": "17 × 23 等於多少?"}], ) msg = resp.choices[0].message details = getattr(msg, "reasoning_details", None) or [] print("[思考]", "".join(d.get("text", "") for d in details)) print("[回答]", msg.content)
  • 非串流回應中,思考內容位於 message.reasoning_details,請將各項的 text 依序串接。
  • 串流回應中,思考內容位於 delta.reasoning_content,與 DeepSeek 官方 API 一致。
  • 多輪對話時,歷史訊息中不需要回傳思考內容。

在 Claude Code 中使用

DeepSeek V4 系列支援 Anthropic 原生介面,位址為 https://api.ofox.ai/anthropic,可在 Claude Code 等基於 Anthropic 協定的工具中使用:

Claude Code 設定值
ANTHROPIC_BASE_URLhttps://api.ofox.ai/anthropic
ANTHROPIC_AUTH_TOKEN貼上你的 OfoxAI API Key
ANTHROPIC_MODELdeepseek/deepseek-v4-pro-0813
Terminal
curl https://api.ofox.ai/anthropic/v1/messages \ -H "x-api-key: $OFOX_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek/deepseek-v4-flash-0731", "max_tokens": 4000, "thinking": {"type": "disabled"}, "messages": [{"role": "user", "content": "用一句話解釋什麼是冪等性。"}] }'
  • 透過 Anthropic 介面呼叫時,思考內容以 thinking 區塊回傳,"thinking": {"type": "disabled"} 同樣可關閉思考。
  • 開啟思考時請設定足夠大的 max_tokens。額度不足時,回應中可能只有 thinking 區塊而沒有回答。

Claude Code 的完整設定步驟請見 Claude Code 設定。

JSON 輸出與工具呼叫

response_format 支援 {"type": "json_object"} 與 {"type": "json_schema", ...};工具呼叫使用標準的 tools 參數:

deepseek_json.py
import json import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.chat.completions.create( model="deepseek/deepseek-v4-pro-0813", response_format={"type": "json_object"}, messages=[{"role": "user", "content": "以 JSON 回傳 price 與 currency:球拍和球共 1.10 美元,球拍比球貴 1 美元,球多少錢?"}], extra_body={"thinking": {"type": "disabled"}}, ) print(json.loads(resp.choices[0].message.content))

使用 json_object 時,請在提示詞中寫明「以 JSON 回傳」及所需欄位。

提示快取

DeepSeek 會自動快取重複的請求前綴,不需要修改請求。命中量請見 usage.prompt_tokens_details.cached_tokens,命中部分依快取讀取單價計費。快取採盡力而為,前綴相同的請求也可能未命中。

供應商

模型供應商
V4.1 FlashDeepSeek 官方(deepseek)、火山引擎(volcengine)
V4 Pro(0813)、V4 Flash(0731)火山引擎(volcengine)
V4 Pro(0423)、V4 Flash(0423)Azure AI Foundry(azure_foundry)

指定供應商的方式請見供應商路由。

常見錯誤

重點請求很慢或回答為空,多半與預設開啟的思考有關;不需要思考時請關閉。
HTTP · type錯誤原文原因處理方式
404 model_not_foundModel 'deepseek/deepseek-v4-pro' not found別名帶了 deepseek/ 前綴,或模型 ID 拼錯別名不帶前綴;或使用完整模型 ID
404 model_not_foundModel 'deepseek-chat' not found使用了 DeepSeek 官方 API 的模型名稱改用 deepseek-v4-flash 等
200,回答為空或只有思考內容—思考用盡了輸出額度調高 max_tokens,或關閉思考
請求逾時—預設開啟思考,複雜問題耗時較長關閉思考、使用串流輸出,或將用戶端逾時設定為 300 秒以上

其他通用錯誤請見錯誤處理。

官方文件

官方文件描述的是直連 DeepSeek 時的行為。在 OfoxAI 上呼叫時,模型 ID 與介面位址以本頁為準。

常見問題

DeepSeek 的模型 ID 怎麼寫?

完整寫法如 deepseek/deepseek-v4-pro-0813。也可以使用別名 deepseek-v4-pro、deepseek-v4-flash(一律指向最新版本),別名不帶 deepseek/ 前綴。

deepseek-chat 和 deepseek-reasoner 還能用嗎?

在 OfoxAI 上無法使用,會回傳 404。請改用 deepseek-v4-flash 或 deepseek-v4-pro,並透過 thinking 參數控制是否思考。

DeepSeek 如何關閉思考?

傳入 "thinking": {"type": "disabled"},在 OpenAI SDK 中放在 extra_body 裡。V4.1 Flash、V4 Pro(0813)、V4 Flash(0731)預設開啟思考。

DeepSeek V4 Pro 為什麼這麼慢?

V4 Pro 預設開啟思考,複雜問題可能思考上萬 token、耗時 2 分鐘以上。不需要深度推理時請關閉思考,或改用 V4 Flash。

DeepSeek 的 reasoning_content 在哪裡?

串流回應中位於 delta.reasoning_content;非串流回應中位於 message.reasoning_details,請將各項的 text 串接。

Claude Code 可以用 DeepSeek 嗎?

可以。ANTHROPIC_BASE_URL 設為 https://api.ofox.ai/anthropic,模型填入 deepseek/deepseek-v4-pro-0813 等 V4 系列模型 ID。

DeepSeek 支援圖片輸入嗎?

V4.1 Flash 支援圖片輸入,其餘 DeepSeek 模型僅支援文字。

最後更新於