DeepSeek 用戶快速上手指南

基礎 URL 與身份驗證

要使用我們的 API，請將你的客戶端指向 https://api.deepseekapi.top/v1。你不需要更改端點路徑；標準的 /v1/chat/completions 能如預期運作。驗證依賴於註冊時產生的單一 API 金鑰。請將此金鑰以 Bearer token 的形式傳入 Authorization 標頭。如果金鑰遺漏或無效，伺服器會回傳 401 錯誤。在發出第一個請求之前，請確保你的環境變數設定正確。

• 基礎 URL：https://api.deepseekapi.top/v1
• 驗證標頭：Authorization: Bearer YOUR_API_KEY

複製curl https://api.deepseekapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

聊天補全端點

我們的 API 接受標準的聊天完成請求。向 /v1/chat/completions 發送 POST 請求，並指定模型 ID 為 uncensored。該模型接收文字輸入並生成文字輸出，且不套用官方 DeepSeek 或其他主要供應商常見的內容過濾器。這使其非常適合創意寫作、角色扮演或不受限制的数据處理。你可以使用 temperature 和 top_p 等參數來控制行為。回應包含生成的文字和 token 使用統計數據。

請記住，該模型並非 GPT、Claude 或其他廠商的模型。它是一個獨立的開放權重模型，針對無限制的合法用途進行了調優。請查看定價頁面以了解 token 費用。

複製from openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapi.top/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK 整合

對於 Node.js 開發者而言，流程與標準 OpenAI 整合完全相同。使用您的特定基礎 URL 和 API 金鑰初始化用戶端。在設定中將模型設為 uncensored。SDK 會處理請求生命週期，包括重試和錯誤處理，就像處理任何 OpenAI 相容服務一樣。這允許您以最小的摩擦重用現有的程式碼庫。請確保使用最新版本的 openai npm 套件以獲得完全相容性。

API 支援同步和非同步呼叫。您可以使用標準的 messages 陣列格式傳遞訊息。回應結構符合 OpenAI API 規範，使遷移變得簡單直接。

複製import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekapi.top/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

串流回應

在請求中設定 stream: true 以啟用串流輸出。API 會返回伺服器發送事件 (SSE) 串流。每個區塊包含部分回應，讓你可以即時顯示生成的文字。Token 使用數據僅包含在串流的最後一個區塊中，而非每個區塊。此設計在減少有效載荷大小的同時，仍能提供準確的計費指標。你無需配置特殊的 stream_options 即可取得使用數據；它會在結尾自動提供。

處理串流事件以即時更新您的使用者介面。當模型完成回應或達到限制時，串流便會結束。

複製stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

函式呼叫與 JSON 模式

API 透過 tools 和 tool_choice 參數支援函式呼叫。在請求中定義您的函式，模型將返回結構化的工具呼叫。您也可以透過將 response_format 設為 {"type": "json_object"} 來強制執行嚴格的 JSON 輸出。這對於生成結構化數據且避免解析錯誤非常有用。該模型經過調優，能可靠地遵循這些指示。

將函式呼叫與串流結合以實現動態互動。API 會在多次對話中保持上下文，允許複雜的多步驟工作流程。請確保您的函式定義清晰且結構良好，以獲得最佳結果。

限制、錯誤與上下文視窗

您的上下文視窗為 100,000 個 token，包含提示詞與補全。每次請求的最大輸出為 32,000 個 token，若未設定 max_tokens，則為 2,048 個 token。速率限制為每分鐘 300 次請求，每支金鑰 8 個並行請求。若超過這些限制，您將收到 429 錯誤。401 錯誤表示金鑰無效，而 402 錯誤表示您的預付額度已耗盡。錯誤與拒絕回應不會消耗 token。請求限制為 8 MB 的主體。使用 Google 或電子郵件註冊即可立即獲得金鑰。