DeepSeek 系列

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

常見任務

關閉或開啟思考思考預設開啟，耗時較長時如何關閉。在 Claude Code 中使用透過 Anthropic 介面呼叫 DeepSeek。JSON 輸出與工具呼叫 response_format 與 tools。錯誤排查回答為空、請求逾時、模型不存在。

模型

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-pro`	`deepseek/deepseek-v4-pro-0813`	一律指向 V4 Pro 的最新版本
`deepseek-v4-flash`	`deepseek/deepseek-v4-flash-0731`	一律指向 V4 Flash 的最新版本
`deepseek-flash`	`deepseek/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 仍可呼叫，開啟思考的方式與新版本不同，請見思考模式。

呼叫範例

Python

deepseek_basic.py


import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/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.io/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.io/anthropic，可在 Claude Code 等基於 Anthropic 協定的工具中使用：

Claude Code 設定值

ANTHROPIC_BASE_URLhttps://api.ofox.io/anthropic

ANTHROPIC_AUTH_TOKEN貼上你的 OfoxAI API Key

ANTHROPIC_MODELdeepseek/deepseek-v4-pro-0813

Terminal


curl https://api.ofox.io/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.io/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 Flash	DeepSeek 官方（`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_found`	`Model 'deepseek/deepseek-v4-pro' not found`	別名帶了 `deepseek/` 前綴，或模型 ID 拼錯	別名不帶前綴；或使用完整模型 ID
404 `model_not_found`	`Model '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.io/anthropic，模型填入 deepseek/deepseek-v4-pro-0813 等 V4 系列模型 ID。

DeepSeek 支援圖片輸入嗎？

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