Skip to content
AI Blog

DeepSeek API 申請與開發入門

最後更新：2026-09-09· 17 分鐘閱讀

🚀 快速通道

  • DeepSeek 國內版：點擊直達↗
  • DeepSeek 鏡像：開啟鏡像↗
  • 官方 DeepSeek：chat.deepseek.com ↗

DeepSeek API 申請與開發入門

更新時間：2026-08-12。

導讀

「DeepSeek API」「DeepSeek API 申請」「DeepSeek Key」對應的是把模型接到網站、腳本、客服機器人或內部工具。可上線的接入不只是「請求 200」，還要管：金鑰不進瀏覽器、逾時與重試、結構化校驗、用量與預算、日誌脫敏。 端點、模型名、價格與限流以 官方 API 文件 為準；下文用占位符，避免寫入易過期的具體型號與單價。

這篇解決什麼問題？

  • 完成帳號、計費與 API Key 準備
  • 用環境變數安全發起第一次請求
  • 設計逾時、重試、錯誤分類與成本控制
  • 上線前過一遍安全清單，並知道如何接到 Codex

開通前準備：帳號、Key、計費

  1. 從 DeepSeek 官網 進入官方開發／開放平台（入口文案以頁面為準）。
  2. 完成帳號登入與計費／儲值開通；設定預算或用量告警（若控制台提供）。
  3. 建立 API Key：立即複製到密碼管理器或金鑰服務；頁面可能不再完整顯示。
  4. 給 Key 打用途標籤（如 dev-chat／prod-summarizer），便於外洩後定向吊銷。
  5. 在文件中確認當前 base URL、鑑權頭、模型列表——不要從過期部落格抄。

網頁聊天帳號與 API 的配額、模型、帳單不要預設當成同一套。日常試用可走 DeepSeek V4 對話；產品整合必須走伺服器端 API。

環境變數：金鑰只放伺服器端

# Linux / macOS 範例（本地開發）
export DEEPSEEK_API_KEY="your-secret-here"
# Windows PowerShell（僅當前工作階段；生產請用平台 Secret）
$env:DEEPSEEK_API_KEY = "your-secret-here"

硬性規則：

  • Key 永遠不要寫進前端、行動 App、公開倉庫、截圖、ISSUE
  • 用 process.env／部署平台 Secret／雲廠商金鑰管理器
  • 不同環境（dev／staging／prod）使用不同 Key
  • 懷疑外洩 → 控制台立刻吊銷並輪換

第一個請求（占位符，請對照文件替換）

以下範例展示請求形狀；請將 OFFICIAL_API_ENDPOINT 與 MODEL_NAME_FROM_DOCS 替換為 api-docs.deepseek.com 中的當前值。

import os
import requests

api_key = os.environ["DEEPSEEK_API_KEY"]
endpoint = "OFFICIAL_API_ENDPOINT"  # 從官方文件複製
model = "MODEL_NAME_FROM_DOCS"      # 從官方文件／控制台複製

resp = requests.post(
    endpoint,
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "model": model,
        "messages": [
            {"role": "user", "content": "用三點解釋什麼是冪等性"}
        ],
    },
    timeout=60,
)
resp.raise_for_status()
print(resp.json())

跑通後立刻檢查：回應裡的用量欄位（若有）、延遲，以及你是否誤把 Key 打進了日誌。

限時內測型號（如 V4.1 Flash）

官方偶發放出中間版本內測（例如 DeepSeek V4.1 Flash）：通常 base_url 不變，只改 model 為帶過期日期的臨時 ID；計費與並發以當日通知為準。此類 ID 禁止寫死進生產設定，必須配回退到正式 Flash／Pro。專用步驟與評測清單見 V4.1 Flash 內測上手指南。

可複製業務提示（放在 messages 裡）

你是內部知識助手。只根據提供的 context 回答。
若 context 不足，回答「資料中未提及」並列出缺失資訊。
不得編造連結、法規條文或資料。
context:
"""
[脫敏段落]
"""
問題：[使用者問題]

串流輸出說明

互動式 UI 通常需要 streaming，讓使用者先看到部分 token。事件格式、SSE 欄位與用戶端解析方式以官方文件「串流」章節為準。注意：

  • 串流同樣要設總體逾時與空閒逾時
  • 中途斷開要可恢復或明確失敗，避免前端無限轉圈
  • 不要在瀏覽器持有 Key 去做「直連串流」；由後端代發

可靠性設計（上線必做）

  1. 逾時：連線逾時 + 讀逾時；避免請求掛死佔滿執行緒
  2. 重試：僅對 429／5xx／網路閃斷 做有限次指數退避；401／403／400 不要盲重試
  3. 冪等：寫操作帶業務冪等鍵，防止重試重複下單類副作用
  4. 校驗：要求 JSON 時做 schema 校驗；失敗則安全降級或有限次「修復請求」
  5. 隔離：單使用者 QPS 限額、全局限流、熔斷
  6. 可觀測：記錄 request_id（若回傳）、模型名、耗時、token、錯誤碼；不記錄原始身分證／銀行卡／完整對話隱私
  7. 版本：system prompt、模型名、溫度類參數納入設定版本管理

錯誤處理對照表

情況典型表現處理
認證失敗401／金鑰無效檢查環境變數與 Key 狀態；不重試
權限／地區限制403查官方說明與帳號狀態
參數錯誤400／模型名無效對照文件修正 model 與欄位
限流429退避、排隊、降並行、申請提額
伺服器錯誤5xx有上限重試 + 告警
逾時client timeout縮短上下文、降 max tokens、非同步化
輸出不合格JSON 壞掉校驗失敗路徑 + 有限次重試

成本控制

  • 限制輸入長度與最大輸出；長歷史做摘要或截斷
  • 對相同請求做快取（注意個人化與隱私邊界）
  • 按路由選模型：簡單分類用輕量檔，複雜推理再升檔（名稱以文件為準）
  • 記錄每日 token 與費用；設定預算告警
  • 批次處理盡量非高峰；避免無意義的多輪「再想想」循環

不要在教學或程式碼註解裡寫死「某模型每百萬 token 價格」——以官方定價頁即時資料為準。

安全清單（上線前必查）

  • Key 僅存在於伺服器端環境變數或金鑰管理器
  • 倉庫、CI 日誌、前端 bundle 無金鑰
  • 使用者輸入有長度限制與基礎過濾（按合規要求）
  • 日誌脫敏；保留期限明確
  • 定期輪換 Key；離職流程含吊銷
  • dev／staging／prod Key 分離
  • 瀏覽器與 App 從不直持 Key

與 Codex／編碼代理

把 DeepSeek 接到編碼代理時，同樣遵守「金鑰在本地／CI Secret、不進聊天記錄截圖」。逐步設定見：Codex DeepSeek 設定。

存取與入口

網頁入口用於人工試用；API 用於伺服器端整合。兩者模型列表與計費可能不同。

常見問題

API Key 可以放瀏覽器嗎？

不可以。任何下發到瀏覽器的字串都可能被使用者取出。應由後端代為呼叫 DeepSeek。

模型名報錯怎麼辦？

以控制台與 官方文件 的當前列表為準：可能已更名、未開通或拼寫錯誤。用 MODEL_NAME_FROM_DOCS 占位提醒自己每次回查。

如何控制成本？

限制上下文與輸出、快取可複用結果、分檔路由、設預算告警，並監控異常流量（被刷介面）。

是否需要保存完整對話？

只保存任務必需欄位；設保留期限；對 PII 脫敏。合規要求高於便利性。

Key 外洩了怎麼辦？

立即在控制台吊銷 → 建立新 Key → 排查 Git 歷史、CI 日誌、容器環境變數與前端產物 → 檢查帳單異常呼叫。

官方資源

下一步閱讀

行動路徑

今天：用環境變數跑通一條占位請求，列印用量與耗時。
明天：加上逾時、429 退避與 schema 校驗，刪除程式碼裡任何明文 Key。
本週：設預算告警，用 10 條真實輸入做基準，再決定預設模型檔位；需要代理則讀完 Codex 設定。

相關內容