快速入門：DeepSeek Coder API 整合

基礎 URL 與驗證

您的 API 金鑰用於驗證對我們託管端點的所有請求。使用基礎 URL https://api.coderdeepseek.cc/v1 使用任何 OpenAI SDK 或 HTTP 客戶端。模型標識符嚴格為 uncensored. 此服務運行於我們自有的伺服器上，並非轉售其他廠商的模型。註冊後（透過 Google 或電子郵件），您將立即獲得 API 金鑰。請妥善保管此金鑰，因為它控制著您的預付餘額。

驗證依賴於 Authorization header。將您的金鑰作為 Bearer token 傳遞。每個請求都必須包含此標頭，以避免 401 我們不使用查詢參數進行身份驗證。這確保了標頭的乾淨性並與標準中介軟體相容。

傳送請求：聊天完成

聊天完成端點處理您的提示並返回文字輸出。發送 POST 請求至 /v1/chat/completions. 包含模型名稱、messages 陣列以及您希望的參數。系統處理文字輸入並回傳文字輸出。您可以控制回應格式與停止條件。這適用於簡單查詢與複雜的程式碼任務。

使用以下 curl 指令測試您的連線。取代 YOUR_API_KEY 搭配您的實際金鑰。請求使用 uncensored 該模型標識符。這確認您的身份驗證和信用額度處於活躍狀態。

Copycurl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

驗證回應包含 choices 陣列。每個選項都包含一條帶有生成內容的訊息。檢查 usage 物件以取得 token 數量。這有助於您準確監控支出。

Python SDK 集成

使用官方 OpenAI 套件將 API 整合至您的 Python 專案。將基礎 URL 設定為我們的端點。使用您的 API 金鑰初始化客戶端。這使您能夠使用熟悉的方法，例如 chat.completions.create. SDK 自動處理 JSON 序列化與 HTTP 請求。

將模型配置為 uncensored。以標準格式傳遞您的訊息。SDK 支援我們的所有功能，包括函數呼叫和 JSON 模式。您可以直接設定 temperature 和 top_p 等參數。這使得從其他供應商遷移變得輕鬆。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.coderdeepseek.cc/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)

處理網路錯誤或無效請求的例外情況。如果您解析原始回應，請檢查狀態碼。這能確保應用程式具有強大的錯誤處理能力。SDK 已抽象化大部分複雜度。

Node SDK 整合

使用 Node.js OpenAI SDK 將您的 JavaScript 或 TypeScript 專案與 API 整合。安裝套件並設定基礎 URL。這可維持您現有程式碼結構的相容性。您可以使用與 Python 相同的方法。SDK 支援 CommonJS 和 ES 模組。

將模型設定為 uncensored。傳遞您的訊息和參數。SDK 會處理串流和非串流請求。您可以捕獲錯誤並適當記錄。這確保您的應用程式在負載下保持穩定。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.coderdeepseek.cc/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);

使用簡單的提示詞測試您的整合。驗證回應是否符合您的預期。檢查回應物件中的 token 使用量。這有助於您追蹤成本和效能。SDK 讓快速迭代變得輕鬆。

串流回應與 Token 用量

在請求主體中將 stream: true 在您的請求中。API 會傳回伺服器發送事件 (SSE) 串流。您會收到即時生成的文字區塊。這可降低長回應的感知延遲。最後一個區塊包含總 Token 使用量。

解析 SSE 事件以提取內容。連接區塊以形成完整回應。監控 usage 最後一個區塊中的物件。這為您提供準確的 token 數量以進行計費。串流傳輸非常適合即時應用程式。

Copystream = 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)

優雅地處理網路中斷。如果串流斷開，請重新連線。API 不會重新傳送先前的區塊。您必須在客戶端重建完整文字。這能提供順暢的使用者體驗。

限制、錯誤與上下文視窗

我們的 API 實施了嚴格的限制以確保穩定性。您每個金鑰每分鐘可進行 300 次請求。最多 8 個請求可以同時運行。請求主體不得超過 8 MB。超過這些限制將導致 429 速率限制錯誤。使用指數退避演算法處理這些錯誤。

上下文視窗為 100,000 個 token。這包含提示詞與補全內容。每次請求的最大輸出為 16,000 個 token。若未設定 max_tokens預設為 2,048。A 401 表示您的金鑰無效。一個 402 表示您沒有信用額度。請透過加密貨幣充值以繼續使用服務。