API 快速入門:將您的客戶端連接到我們的無審查模型
此快速入門指南將展示如何將 OpenAI-compatible 客戶端指向我們的無審查文本模型。您只需一個基礎 URL、一個 model id 以及您的金鑰。
身份驗證與基礎 URL
每個請求都會發送到 https://doesgrokhaveanapi.com/v1 並將您的金鑰保留在 Authorization 標頭作為載入權杖。從「取得 API 金鑰」頁面複製金鑰;您在註冊後會看到該金鑰,且您可以隨時更換它。
簡潔明瞭:當您將現有的用戶端遷移時,只有基礎 URL 和金鑰這兩個值會改變。
curl https://api.doesgrokhaveanapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the current API endpoint for the model?"}]
}'
Chat Completions 端點
傳送 POST /v1/chat/completions 帶有訊息列表。回傳的格式與 OpenAI 聊天完成回傳相同,因此現有的解析器可以繼續運作。
- 使用角色
user您的提示詞以及system說明。 - 從以下來源取得答案
choices[0].message.content. - Token 計數回傳於
usage,這就是您的信用額度扣費的依據。
from openai import OpenAI
client = OpenAI(base_url="https://api.doesgrokhaveanapi.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)
支援模型:'uncensored'
將 model 欄位設定為 uncensored。這是服務中唯一的模型 id,因此無需選擇其他選項。 GET /v1/models 回傳,這是確認金鑰是否運作的一種快速方法。
該模型是一個在我們自有伺服器上運行的開放權重模型。它不會拒絕合法的成人、虛構或具爭議性的請求。唯一的硬性限制是涉及未成年人的性內容。
串流與函式呼叫
新增 stream: true 接收伺服器發送的事件權杖。最後一個區塊包含使用數據,因此您可以在不進行第二次呼叫的情況下記錄每次請求的成本。
函式呼叫透過標準 tools 和 tool_choice 欄位。使用 JSON 架構定義每個函式,並讀取 tool_calls 回傳的陣列中。
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)
參數:Temperature、Top P 和 Stop
支援的採樣參數為 temperature, top_p, stop, seed, presence_penalty 和 frequency_penalty。對於程式碼和提取任務,請使用較低的溫度;對於小說創作,請使用較高的溫度。
如果您未設定 max_tokens,預設輸出限制為 2,048 個 token。每次請求的硬性上限為 16,000 個 token。
JSON 模式與回應格式
設定 response_format 以 { 'type': 'json_object' } 當您需要機器可讀的輸出時。在提示詞中要求 JSON,因為模型會同時遵循指令和格式。
- 在系統訊息中描述您需要的欄位。
- 請保持範例簡短,包含兩到三個鍵。
- 在儲存結果之前,請在程式碼中驗證結果。
速率限制與錯誤處理
每個金鑰每分鐘可發送 300 個請求,同時可發送 8 個請求。主體超過 8 MB 的請求將被拒絕。401 表示金鑰錯誤,402 表示信用額度已耗盡,429 表示已達到速率限制:請等待並使用退避機制重試。
錯誤與拒絕不會計費。請留意長對話的上下文窗口為 100,000 個 token:提示與補全的 token 總數需在此範圍內。
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.doesgrokhaveanapi.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);常見問題
我應該使用哪個 base URL?
使用 https://doesgrokhaveanapi.com/v1 作為基礎 URL。任何 OpenAI 相容的 SDK 在更改基礎 URL 和金鑰後皆可接受,且您的程式碼其他部分無需更動。
我應該發送哪個 model id?
發送無審查內容。這是服務中唯一的模型。在執行較大任務之前,請呼叫 GET /v1/models 以確認 id 並確認您的金鑰已啟用。
為什麼我的請求會返回 402?
402 回應表示帳戶中的預付信用額度已耗盡。使用 USDT (TRC20) 或 USDC (Base) 充值,最低 $20,即可繼續發送請求。失敗的請求不會扣費。
您的 API 金鑰僅一步之遙
註冊、複製您的 Token、更新端點。這就是整個流程。