DeepSeek API:五分鐘內完成第一個請求
將您現有的 OpenAI 相容用戶端指向我們的基礎 URL,並使用註冊期間產生的金鑰進行驗證,即可在五分鐘內獲得第一個回應。
基礎 URL 與驗證
我們的 API 遵循標準 OpenAI 介面,因此你只需修改客戶端設定中的兩個值。將基礎 URL 設為 https://api.getdeepseekapi.com/v1,並在建立帳戶後立即於 取得 API 金鑰 頁面顯示的 API 金鑰。無需手機號碼或信用卡即可開始,並獲得 0.50 美元的試用額度,有效期為七天。
每個帳戶一次僅允許一個活躍金鑰。如果您更換金鑰,舊金鑰將立即失效。這簡化了開發與生產環境中的金鑰管理,無需複雜的權限範圍。
發送聊天補全請求
向 /v1/chat/completions 發送標準 POST 請求以獲取文字回應。該端點接受包含系統提示詞與使用者查詢的 messages 陣列,以及設為 uncensored 的 model 識別碼。此模型運行於我們自己的 GPU 伺服器上,並經過調校,可在合法成人用途下無內容審查地回答問題。
確保請求主體小於 8 MB。如果金鑰無效或已過期,伺服器將返回 401 錯誤。如果預付額度已耗盡,您將收到需要儲值的 402 錯誤。您可以透過加密貨幣(USDT 或 USDC)開始儲值,最低金額為 $10。
curl https://api.getdeepseekapi.com/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."}]
}'
安裝並使用 Python SDK
使用官方 OpenAI Python 函式庫是整合的最快方式。透過 pip 安裝套件,然後使用自訂基礎 URL 和 API 金鑰配置用戶端。model 參數必須設為 uncensored,以確保您正在與我們的特定執行個體通訊。
此方法適用於任何 OpenAI 相容 SDK,包括用於 Node.js 或 Go 的 SDK。用戶端會自動處理序列化與重試。請記住,模型識別碼並非像 GPT-4 這樣的供應商名稱;它是我們無審查模型的特定識別碼。
from openai import OpenAI
client = OpenAI(base_url="https://api.getdeepseekapi.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)
Node.js 整合
對於 JavaScript 環境,請安裝 OpenAI SDK 並類似 Python 範例進行配置。將 baseUrl 設為我們的端點並提供 API 金鑰。Node SDK 支援同步和非同步模式。
在建構請求時,請在參數中指定 model: 'uncensored'。這可確保用戶端將請求發送到正確的模型端點。SDK 統一處理串流和非串流回應,允許您在無需更改核心請求邏輯的情況下交換實作方式。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.getdeepseekapi.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);
啟用串流輸出 (SSE)
將 stream 參數設為 true 以接收伺服器發送事件 (SSE) 回應。伺服器會傳送一系列資料區塊,每個區塊包含部分產生的文字。這可降低長回應的感知延遲,並讓用戶端在產生 token 時即時顯示。
確保您的用戶端程式碼正確處理串流終止事件。串流不會改變定價或 token 計數;您仍會為輸入和輸出的每 1M token 付費。總上下文視窗仍限制為 100,000 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)
限制、錯誤與上下文視窗
您的 API 金鑰每分鐘限制為 300 次請求。如果超過此閾值,伺服器將返回 429 錯誤,表示速率限制。每個請求主體不得超過 8 MB。上下文視窗支援 100,000 token,用於提示詞與補全的總和,因此在設計應用程式時必須同時考慮輸入和輸出的長度。
常見錯誤包括金鑰無效的 401、預付額度不足的 402 以及速率限制的 429。您可以隨時從帳戶設定中重新生成 API 金鑰,這會立即使舊金鑰失效。如果您懷疑金鑰洩漏或需要在環境之間更換憑證,這非常有用。
API 技術參數
購買額度前,請先確認介面是否符合你的需求——以下是全部真實參數。
| 項目 | 說明 |
|---|---|
| 介面格式 | 相容 OpenAI:任何 OpenAI SDK 只需更換 base URL 和金鑰 |
| 端點 | POST /v1/chat/completions · GET /v1/models |
| 驗證 | Authorization: Bearer YOUR_KEY |
| 模型 ID | uncensored |
| Base URL | https://api.getdeepseekapi.com/v1 |
| 上下文視窗 | 100,000 tokens(輸入與輸出合計) |
| 取樣參數 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| JSON 模式 | response_format: {"type": "json_object"} |
| 串流輸出 | 支援 SSE,最後一段包含 token 用量 |
| 最大輸出 | 不另設輸出上限;提示+回覆共 100,000 個 token 視窗內,max_tokens 可選 |
| 函式呼叫 | 支援 tools、tool_choice;回覆包含 tool_calls(串流同樣支援),結果以 role: tool 訊息回傳 |
| 速率限制 | 每把金鑰每分鐘 300 次請求 |
| 請求大小 | 每次請求不超過 8 MB |
| 並行請求 | 每把金鑰同時最多 8 個請求 |
| 回應標頭 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 額度效期 | 付費額度永不過期,無訂閱 |
| 儲值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整數金額 |
| 免費試用 | $0.50,有效期 7 天,不需信用卡 · 試用金鑰:2 個並行請求,每分鐘 60 次;首次儲值後恢復完整限額(8 和 300) |
| 價格 | 輸入 $0.25 / 百萬 tokens · 輸出 $1.00 / 百萬 tokens |
| 計費 | 預付額度,按實際 token 用量扣費;錯誤和拒絕不收費 |
| 贈送額度 | 滿 $50 送 5%,滿 $100 送 10% |
| 登入 | Google 或電子郵件 + 密碼 |
| 內容政策 | 允許成人內容;涉及未成年人的性內容一律拒絕 |
| 金鑰 | 每個帳戶一把有效金鑰;產生新金鑰後舊金鑰失效 |
錯誤代碼
錯誤以 JSON 回傳,type 欄位固定;失敗或被拒絕的請求不計費。
| 狀態碼 | 類型 | 含義 |
|---|---|---|
400 | bad_request | JSON 無效、訊息為空、參數錯誤或超出上下文視窗 |
401 | missing_key · invalid_key · key_revoked | 缺少金鑰、金鑰錯誤或已被新金鑰取代 |
402 | no_credit | 餘額不足——儲值後立即恢復 |
403 | content_blocked | 涉及未成年人的性內容——拒絕且不計費 |
404 | not_found | 未知端點 |
413 | request_too_large | 請求內容超過 8 MB |
429 | rate_limited · concurrency | 超過每分鐘 300 次或 8 個並行——稍後重試 |
503 | upstream_busy | 模型忙碌——幾秒後重試 |
問答
上下文視窗的大小是多少?
上下文視窗為 100,000 token,計算方式為輸入提示詞 token 與輸出補全 token 的總和。這並非僅限於輸入的 100,000 token。
此服務支援函式呼叫嗎?
是的,<code>/v1/chat/completions</code> 端點支援工具與函式呼叫。您可以在請求中定義工具,模型將針對其返回結構化參數。
我該如何處理 402 錯誤?
402 錯誤表示您的預付額度餘額為零。您可以使用加密貨幣(USDT 或 USDC)開始儲值,最低金額為 $10。額度永不過期。
只差一張表單,即可取得金鑰
建立帳戶、複製金鑰、更改基礎 URL。這就是整個設定。