5 分鐘內完成第一個請求

基礎 URL 與驗證

我們的 API 複製 OpenAI v1 介面，讓您可以在不更動應用程式邏輯的情況下交換端點。請使用 https://api.groknsfw.top/v1 作為基礎 URL。驗證需要透過 Authorization 標頭傳遞有效的 API 金鑰作為 Bearer token。您可以透過 Google 登入或電子郵件在儀表板上即時產生金鑰。每個帳戶同時支援一個有效金鑰；發行新金鑰將立即使舊金鑰失效。此單金鑰模型簡化了大多數開發與 QA 環境的存取控制。

第一個請求

發送標準聊天完成請求以測試連線。模型識別碼為 uncensored，其處理內容拒絕的方式與標準模型不同。以下提供使用 curl 命令列工具的基礎範例，以驗證您的金鑰與基礎 URL 是否正確。

Copycurl https://api.groknsfw.top/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."}]
  }'

如果您收到包含 choices 與 usage 的 JSON 回應，表示您的整合已啟用。請檢查 usage 物件以查看 token 消耗量，從而準確追蹤計費。

Python SDK 整合

使用官方的 openai Python 套件與我們的端點互動。在發出呼叫前，請設定 base_url 與 api_key 屬性。此方法適用於任何支援 OpenAI 格式的程式庫，使從其他供應商遷移變得輕鬆。

Copyfrom openai import OpenAI

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

此程式碼片段示範同步請求。對於高吞吐量的 NSFW 內容產生，建議使用非同步用戶端來同時處理多個請求，而不阻塞主執行緒。

Node.js SDK 設定

對於 JavaScript 或 TypeScript 應用程式，請將 OpenAI SDK 設定指向我們的基礎 URL。這可確保您現有的用戶端程式碼無需修改即可運作。Node.js 生態系統受惠於此相容性，可快速建立 NSFW 聊天介面的原型。

Copyimport OpenAI from "openai";

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

請確保您使用的是支援自訂基礎 URL 的最新版本 SDK。設定物件應嚴格包含 apiKey 與 baseURL 屬性，以避免端點不匹配。

串流回應 (SSE)

在請求中設定 stream: true 以啟用即時 token 產生。API 會傳回伺服器推送事件 (SSE) 串流，在產生 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)

請解析 SSE 事件以提取 delta 內容。串流中的最後一個區塊包含總 usage 統計資料，您應將其用於準確的計費對帳。串流不會影響 token 計數或計費。

限制、錯誤與上下文

您的請求受每分鐘 300 次及每個金鑰 8 個並行請求的限制。最大請求主體大小為 8 MB，上下文視窗最多支援 100,000 個 token。錯誤以標準 HTTP 格式返回：401 表示金鑰無效，402 表示額度不足，429 表示速率限制。額度錯誤免費，但速率限制要求您降低請求頻率。每個請求的最大輸出為 32,000 個 token；若省略 max_tokens，預設值為 2,048 個 token。