如何在中國境外使用 DeepSeek API：設定與檢查

要在中國境外使用 DeepSeek API，先選擇支援你的帳戶和部署地點的服務。你可以評估 DeepSeek 直連平台，或 Tokenhot 等閘道器。無論哪種方式，都需要該服務的端點、該服務簽發的 API 金鑰，以及所選路徑實際支援的模型識別符號。

沒有一個延遲數字或註冊規則適用於每個國家、帳戶和供應商。在圍繞服務構建前，請檢查所在地區當前的註冊和付款選項。閘道器是一種訪問選項；不應被視為可以忽略服務可用性規則的許可。

更新於 2026 年 9 月 14 日。程式碼示例是基於文件的起點，不是線上 API 效能測量。

直接訪問 DeepSeek 還是使用閘道器？

決策項	DeepSeek 直連	Tokenhot 閘道器
端點	https://api.deepseek.com	https://api.tokenhot.ai/v1
憑據	來自 DeepSeek 平台的金鑰	來自 Tokenhot 控制檯的金鑰
模型選擇	DeepSeek API 文件中的當前識別符號	Tokenhot 目錄中的準確路徑識別符號
計費	DeepSeek 帳戶和當前第一方費率	Tokenhot 帳戶和顯示的閘道器費率
評估主要原因	與模型提供商直接建立關係	透過一個服務訪問多個模型家族

端點和 SDK 設定見 DeepSeek quick start和 Tokenhot quick start。金鑰是服務專屬的：不要將 DeepSeek 金鑰傳送到 Tokenhot，也不要將 Tokenhot 金鑰傳送到 DeepSeek。

如果現有 DeepSeek 帳戶已支援工作負載，請先測試該路徑。若需要更廣目錄或不同帳戶安排，請比較閘道器選項。我們的 OpenRouter 替代方案指南涵蓋初次 API 呼叫之外的相容性和供應商選擇問題。

複製舊示例前檢查模型名稱

DeepSeek 當前 quick start 推薦 deepseek-flash。它說明舊 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 名稱在直連服務上仍可接受，但請求現使用 DeepSeek V4.1 Flash，因為對應的舊模型已退役。同一頁面稱 V4 Pro API 服務會在 2026 年 9 月 14 日後繼續。當前 DeepSeek API 識別符號。

因此，可用別名並不能證明呼叫的是未變更模型。在部署配置中記錄端點、請求模型、可用時返回的模型後設資料和驗證日期。

不要假設閘道器遵循相同別名或退役時間表。明確選擇其列出的識別符號。歷史 V4 Pro 釋出、基準和權重要求請見 DeepSeek V4 Pro 指南。

使用 Python 發出一個小型首次呼叫

安裝支援可配置基礎 URL 和 Chat Completions 用戶端的官方 OpenAI Python SDK：

pip install openai

對於直連訪問，在 DeepSeek 平台建立金鑰，並在環境中設定 DEEPSEEK_API_KEY。先使用短提示詞，使身份驗證和模型選擇能在不產生大工作負載時得到檢查。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
    timeout=120.0,
    max_retries=0,
)

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Explain an API gateway in two sentences."}],
    stream=False,
)
print(response.choices[0].message.content or "")
print(response.usage)

顯式超時和關閉自動重試可讓初始診斷執行更易解釋。它們是示例設定，不是每種工作負載的推薦限制。理解服務錯誤和應用時間預算後，再配置有界重試策略。

對於 Tokenhot，在 API 金鑰控制檯獲取金鑰，在模型目錄選擇 DeepSeek 路徑，並在伺服器環境設定 TOKENHOT_API_KEY 和 TOKENHOT_MODEL。將用戶端和模型配置替換為：

client = OpenAI(
    api_key=os.environ["TOKENHOT_API_KEY"],
    base_url="https://api.tokenhot.ai/v1",
    timeout=120.0,
    max_retries=0,
)
model = os.environ["TOKENHOT_MODEL"]

在相同的基本 Chat Completions 呼叫中傳入 model=model。透過配置選擇模型，避免在教程中嵌入未經驗證的閘道器別名。將憑據保留在伺服器中，避免放入瀏覽器 bundle、公開倉庫和診斷截圖。

分別新增串流傳輸和推理選項

基本請求可用後，在所選路徑測試串流傳輸。對於 Chat Completions 流，在訪問內容前檢查 chunk 是否含有 choice：

stream = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Give three checks before deploying an API client."}],
    stream=True,
)
try:
    for chunk in stream:
        if chunk.choices:
            text = chunk.choices[0].delta.content
            if text:
                print(text, end="", flush=True)
finally:
    stream.close()

此處的 client 和 model 指向上面所選配置；對於直連示例，設定 model="deepseek-flash"。程式碼列印回答內容。不要假設每個推理模型都會將中間輸出嵌入字面 <think> 標籤。只解析路徑文件規定的欄位，並將輔助推理資料與最終回答分開。

DeepSeek 當前直連示例將 reasoning_effort 與 thinking 物件一起使用。這不能證明任意閘道器接受相同擴充套件或取值。僅在核對路徑文件後新增這些控制項。工具、結構化輸出、影像輸入和長上下文也應逐項測試：共享用戶端介面並不讓每個模型功能可互換。

更換供應商前先診斷訪問錯誤

一次失敗請求本身不能證明存在區域網路封鎖。先檢查 HTTP 狀態、服務錯誤訊息、端點和模型選擇。

症狀	首先檢查
身份驗證錯誤	金鑰是否由接收請求的服務建立，且仍有效？
餘額不足	API 帳戶是否有可用於此路徑的餘額？
參數或模型無效	當前模型是否接受傳送的識別符號、欄位和值？
速率限制	請求併發或 token 數量是否高於帳戶允許水平？
超時或伺服器過載	小請求能否完成，服務是否報告了事故？
流中斷	連線是否提前關閉，應用是否錯誤地將部分文字視為完整回答？

DeepSeek 對身份驗證失敗記錄 401、餘額不足 402、無效參數 422、限流 429，以及伺服器問題 500/503。閘道器程式碼可能不同。請閱讀相關服務的錯誤參考，而不是將一個供應商的重試策略套用到每條路徑。DeepSeek 錯誤碼。

為支援保留請求 ID 和已脫敏錯誤後設資料。不要將 API 金鑰或私密提示詞貼上到公開 issue 報告。對於重複失敗，每次只更改一個變數：金鑰、模型、請求體或網路位置。這會讓結果可執行。

從部署區域測量延遲

從應用執行的伺服器區域比較路徑。附近的閘道器入口會影響網路連線時間，但生成還取決於排隊、輸入長度、模型計算、推理模式和輸出長度。

對每項測試使用相同提示詞、併發、輸出設定和時間視窗。測量首個回答 token 的時間、總完成時間、成功率和已計費用量。記錄計時是否包含連線建立，以及輔助推理是否在回答文字前到達。在有足夠觀察值後分別報告中位延遲和尾部延遲。

對長上下文任務，使用真實文件長度。短問候不能證明一條路徑在大型程式碼庫上的表現。對串流介面，除成功回應外還要測試中斷和取消。本文不作通用低於 200ms 承諾，因為未包含受控的區域基準。

按實際路徑比較帳單和資料條款

使用你將支付的端點當前報價。第一方 DeepSeek 價格與 Tokenhot 閘道器費率是不同報價。快取輸入、普通輸入、推理輸出和隨時間變化的定價都會改變有效成本；LLM API 定價比較提供可復現的計算框架。

新增資金前，檢查帳戶顯示的支付方式和任何最低購買額。不要假設每個國家都支援相同的卡或錢包。

對於敏感工作負載，審閱閘道器和上游供應商適用的資料條款。詢問哪條路徑處理請求、保留哪些執行日誌，以及適用哪些合約保留設定。傳輸加密、關於保留的營銷宣告和已完成的合規評估回答的是不同問題。

進入生產前

確認帳戶受支援、準確模型可用、有代表性的請求能完成，並且使用量如預期出現。然後測試串流傳輸、錯誤處理、請求限制和應用所需的模型特定功能。儲存帶日期的配置記錄，使後續別名或價格變動可見。

閘道器設定從 Tokenhot quick start開始，直連訪問從 DeepSeek quick start開始；在擴大流量前，用自己的工作負載評估路徑。