DeepSeek API怎麼用：Python調用、思考模式、價格與常見報錯

適用於誰

• 搜「deepseek api 怎麼用」「deepseek api 價格」，已經拿到 API Key、想跑通第一段代碼的人；
• 從舊教學照抄 deepseek-chat、deepseek-reasoner 發現對不上的人。

本文根據 DeepSeek 官方 API 文檔整理，資料核對於 2026-10-11。還沒有 Key 的話先看《DeepSeek API Key 怎麼獲取》。

結論先說

1. DeepSeek API 兼容 OpenAI 和 Anthropic 兩種格式，裝好 OpenAI SDK、把 base_url 換成 https://api.deepseek.com 就能調用。
2. 當前模型名是 deepseek-flash 和 deepseek-v4-pro。官方更新日誌寫明，舊名字 deepseek-chat、deepseek-reasoner 原定於 2026-07-24 停用，舊教學裏的寫法要換掉。
3. 思考模式預設開啟，不需要推理的簡單任務可以關掉，回答更快。
4. 價格分高峰和空閒兩個時段，空閒時段是高峰價格的一半。

步驟

1. 安裝 SDK 並設定 Key

bash
pip3 install openai
export DEEPSEEK_API_KEY="你的 Key"      # Windows PowerShell 用 $env:DEEPSEEK_API_KEY="你的 Key"

2. 發出第一個請求

下面的寫法與官方「首次調用 API」示例一致：

python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("DEEPSEEK_API_KEY"),
    base_url="https://api.deepseek.com",
)

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "你是一個嚴謹的助手，回答使用簡體中文。"},
        {"role": "user", "content": "用三句話解釋什麼是 token。"},
    ],
    stream=False,
)

print(response.choices[0].message.content)
print(response.usage)   # 這次請求實際消耗的 token

關於 token，官方給的粗略換算是：1 箇中文字符約 0.6 個 token，1 個英文字符約 0.3 個 token，實際以返回結果裏的 usage 為準。

3. 選模型

官方「模型與價格」頁（2026-10-11 核對）列出的兩個模型：

兩者都支持 JSON Output、Tool Calls、Responses API 和 Anthropic API 格式。官方 2026-09-10 的發佈說明稱 V4.1 Flash 在性能、費用、速度上已全面超過 V4 Pro，因此新項目一般直接用 deepseek-flash。更新日誌隨後說明，2026-09-14 之後繼續提供 deepseek-v4-pro 的調用服務、計費方式不變，如有變動會另行通知。

4. 開關思考模式

思考模式預設開啟，預設強度為 high。用 OpenAI SDK 時，thinking 參數要放在 extra_body 裏：

python
response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "9.11 和 9.8 哪個大？說明理由。"}],
    reasoning_effort="high",                       # low / high / max
    extra_body={"thinking": {"type": "enabled"}},  # 關閉寫 "disabled"
)

print(response.choices[0].message.reasoning_content)  # 思考過程
print(response.choices[0].message.content)            # 最終回答

官方文檔裏幾條容易踩的規則：

• 思考模式下 temperature、presence_penalty、frequency_penalty 不生效（傳了不報錯，但沒有作用）；
• 多輪對話如果沒有用工具調用，歷史輪次的 reasoning_content 不需要回傳；如果請求裏帶了 tools，歷史的 reasoning_content 必須完整回傳，否則返回 400。

5. 流式輸出

把 stream 設為 True，逐塊讀取：

python
stream = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "寫一首關於秋天的四行詩"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta
    if getattr(delta, "content", None):
        print(delta.content, end="", flush=True)

等待期間伺服器會發保活內容：非流式請求持續返回空行，流式請求返回 : keep-alive 註釋。用官方 SDK 時不用管；自己解析 HTTP 響應就要跳過它們。請求發出 10 分鐘後仍未開始推理，伺服器會關閉連接。

6. 算一下要花多少錢

官方價格（元 / 百萬 token，2026-10-11 核對，官方聲明價格可能變動）：

高峰時段是北京時間週一至週五（不含法定節假日）9:00–12:00、14:00–18:00，其餘時間（含週末和節假日全天）都是空閒時段。批量任務放到晚上或週末跑，費用減半。

常見問題

Q：報錯碼分別是什麼意思？

按官方錯誤碼錶：400 請求體格式錯誤；401 API Key 錯誤；402 餘額不足；422 請求參數錯誤；429 請求速率達到上限；500 伺服器內部故障；503 伺服器繁忙（負載過高，稍後重試）。

Q：429 怎麼處理？

限速按帳號計算，與用幾個 Key 無關：一個請求從發出到響應完成算一個並發，超過上限就返回 429。做法是降低並發、加上帶退避的重試；確實需要更高並發可以向官方提交擴容工單。

Q：舊代碼裏的 deepseek-chat 還能用嗎？

官方更新日誌寫的是這兩個舊名字原定 2026-07-24 停用。直接改成 deepseek-flash，需要推理就用思考模式參數控制。

Q：能在 Cursor、Claude Code 這類工具裏用嗎？

可以。支持自定義 OpenAI 兼容接口的工具填上面的 base_url 和 Key 即可；Claude Code 的官方接法見《DeepSeek 接入 Claude Code 教學》。

Q：API 能聯網搜尋嗎？

API 裏沒有聊天產品那樣的「智能搜尋」開關。官方文檔說明，通過 Anthropic 兼容接口在 Claude Code 中可以直接使用由 DeepSeek 提供的 Web Search 工具（搜尋結果的總結會額外消耗 token）；其他場景可以用工具調用（Tool Calls）接入你自己的搜尋服務，具體以官方文檔為準。

參考資料

• DeepSeek API 文檔：首次調用 API — https://api-docs.deepseek.com/zh-cn/
• 模型與價格 — https://api-docs.deepseek.com/zh-cn/quick_start/pricing
• 思考模式 — https://api-docs.deepseek.com/zh-cn/guides/thinking_mode
• Token 用量計算 — https://api-docs.deepseek.com/zh-cn/quick_start/token_usage
• 限速與隔離 — https://api-docs.deepseek.com/zh-cn/quick_start/rate_limit
• 錯誤碼 — https://api-docs.deepseek.com/zh-cn/quick_start/error_codes
• 更新日誌 — https://api-docs.deepseek.com/zh-cn/updates