| 開發/產品串接 | 申請 API key 後呼叫 Chat Completions | DeepSeek API 要先建立 API key,並用 Bearer 認證。 |
| 上線前核對 | Models & Pricing、List Models、服務狀態頁 | 模型名和收費看官方文檔/模型列表;懷疑服務異常就看狀態頁。 |
如果你未打算寫程式,先用網頁版最直接。官方首頁的 Start Now 是網頁體驗入口,同一頁亦有 Access API 和 Get DeepSeek App。 這適合先試答覆風格、推理表現,或者看看它是否配合你的日常用法。
如果網頁或 App 突然變慢、回應不穩,別急著改設定,先看 DeepSeek Service Status。狀態頁會列出 Web/APP 性能異常等已調查或已解決的事件。
DeepSeek App 公告建議用家在應用商店搜尋 DeepSeek,或到官方網站用直接連結下載;同一公告亦強調要只從官方渠道下載,避免被誤導。
收費資訊要分清楚看。App 公告寫明「100% FREE - No ads, no in-app purchases」,但 API 使用的價錢要另外查 Models & Pricing,兩者不要混為一談。
對開發者來說,基本流程不複雜:先建立 DeepSeek API key,然後在請求標頭用 Authorization: Bearer <TOKEN> 這種 Bearer 認證格式。 DeepSeek 文檔說 API 格式與 OpenAI 相容,所以可透過修改設定,用 OpenAI SDK 或其他 OpenAI API 相容軟件存取 DeepSeek API。
最基本的聊天端點是 /chat/completions。這個端點會按你傳入的對話內容產生模型回覆;請求 body 需要 messages 陣列,放入到目前為止的對話訊息。
以下只是結構模板。<DEEPSEEK_BASE_URL> 請填官方 Quick Start 提供的 base_url;<MODEL_ID> 則用 Models & Pricing 或 List Models 目前列出的模型名稱。
POST <DEEPSEEK_BASE_URL>/chat/completions
Authorization: Bearer <DEEPSEEK_API_KEY>
Content-Type: application/json
{
"model": "<MODEL_ID>",
"messages": [
{
"role": "user",
"content": "用一段說話介紹 DeepSeek。"
}
]
}
另外要留意:DeepSeek Quick Start 提到,為了兼容 OpenAI 而出現的 v1 寫法,與實際模型版本沒有關係;不要把 URL 路徑的 v1 當成模型版本。
DeepSeek 官方指南的示例使用 OpenAI(api_key=..., base_url=...) 建立 client,再用 client.chat.completions.create 發出請求。 下面用環境變數示範填入 API key、base URL 和模型名:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ['DEEPSEEK_API_KEY'],
base_url=os.environ['DEEPSEEK_BASE_URL'],
)
response = client.chat.completions.create(
model=os.environ['DEEPSEEK_MODEL'],
messages=[
{
'role': 'user',
'content': '用一段說話介紹 DeepSeek。',
}
],
)
print(response.choices.message.content)
串 API 最容易踩坑的地方,往往不是程式碼,而是模型名。官方 Quick Start 將 deepseek-chat、deepseek-reasoner 與 DeepSeek-V3.2 連結起來說明;但 Change Log 又寫明在 current period,這兩個名稱分別指向 deepseek-v4-flash 的非推理模式和推理模式。
所以開新項目或準備上線時,最好不要只照抄網上舊範例。模型名稱、可用性和價錢,應以官方 Models & Pricing 以及 List Models 為準。
DeepSeek 私隱政策說明,它適用於 DeepSeek apps、websites、software 及相關服務。 DeepSeek 亦另有使用條款。 如果你準備輸入客戶資料、未公開程式碼、內部文件或其他敏感內容,應先檢視這些文件,並配合你所屬組織的資料處理規則。
安裝 App 亦同理:優先使用官方渠道。DeepSeek App 公告已提醒用家只從官方渠道下載,避免被誤導。
Authorization: Bearer <TOKEN> 格式送出。一般用家,先由官方首頁的 Start Now 或官方 App 試起最省事。 開發者就先申請 API key,用 Bearer 認證和 OpenAI 相容的 /chat/completions 端點完成第一個呼叫。 真正放入工作流程或產品前,再核對模型名、價錢、服務狀態,以及私隱政策和使用條款。