繁中 ▾
面向開發者的無審查 AI APIdoesgrokhaveanapi.com

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,因為模型會同時遵循指令和格式。

  1. 在系統訊息中描述您需要的欄位。
  2. 請保持範例簡短,包含兩到三個鍵。
  3. 在儲存結果之前,請在程式碼中驗證結果。

速率限制與錯誤處理

每個金鑰每分鐘可發送 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、更新端點。這就是整個流程。

立即開始