驗證與 Base URL 設定
您的 API 金鑰用於驗證對我們伺服器所有請求。只需使用 Google 或電子郵件地址註冊,並從您的儀表板複製金鑰。將其貼入環境變數作為 DEEPSEEK_API_KEY 並將您的客戶端指向 https://api.keyapideepseek.com/v1. 此基礎 URL 適用於任何標準的 OpenAI 相容函式庫。
curl https://api.keyapideepseek.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
}'您可以透過列出可用模型來驗證您的設定。回應確認您的金鑰有效且處於啟用狀態。此步驟確保您的整合指向正確的無過濾端點,然後再發送提示。
聊天完成端點
The POST /v1/chat/completions 端點接受您的提示並返回模型回應。您發送包含訊息、系統指令以及溫度等參數的 JSON 主體。模型 ID 始終為 uncensored. 單一模型處理您的所有文字生成需求,無路由複雜性。
from openai import OpenAI
client = OpenAI(base_url="https://api.keyapideepseek.com/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)Python SDK 自動處理 HTTP 請求。您將金鑰和基礎 URL 傳遞給客戶端構造器。其餘程式碼反映標準的 OpenAI 模式。這確保了您稍後可以切換供應商而無需重寫整個應用程式邏輯。
串流回應與 Token 用量
在請求主體中將 stream: true 在您的請求中。API 返回伺服器發送事件 (SSE) 區塊串流。每個區塊包含部分文字和使用統計數據。最後一個區塊包含該請求的總 token 數量。
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)串流可降低使用者的感知延遲。您可以即時顯示 token。這對於長文生成或互動式聊天介面至關重要。請監控最後一個區塊中的 token 使用情況,以準確追蹤預付額度的消耗。
JSON 模式與函式呼叫
透過設定強制執行結構化輸出 response_format 以 {"type": "json_object"}. 模型將回傳有效的 JSON 而非自由形式的文字。這非常適合 API 整合或資料擷取任務。您也可以定義函式定義以進行工具使用。
該模型支援 tool_choice 參數。您可以強制執行特定函式,也可以讓模型自行決定。這種靈活性允許您構建複雜的代理。確保您的函式架構是嚴格類型的,以避免客戶端代碼中的解析錯誤。
速率限制與併發
每個 API 金鑰的速率限制為每分鐘 300 次請求。您最多可同時進行 8 個並行請求。最大請求主體大小為 8 MB。這些限制可防止濫用,並確保所有使用者的穩定效能。超出這些限制將返回 429 錯誤。
在您的客戶端程式碼中實作指數退避。在短延遲後重試失敗的請求。這能優雅地處理暫時性的網路問題。您的預付信用額僅在成功完成時收費,速率限制的重試不會收費。
錯誤處理與拒絕
401 錯誤表示您的金鑰無效或已過期。402 錯誤表示預付信用額度不足。429 錯誤表示您已達到速率限制。該模型會拒絕包含涉及未成年人色情內容的請求。所有其他合法的成人內容均允許。
檢查錯誤回應主體以獲取詳細訊息。記錄這些錯誤以除錯整合問題。您的信用額度不會因失敗的請求而被消耗。這種透明的計費模型幫助您準確預測成本,且無隱藏費用。
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.keyapideepseek.com/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);