OpenAI-Compatible API 文件

基礎 URL 與驗證

每個請求都以設定 base_url 以 https://api.nsfwgemma.com/v1 並將您的 API 金鑰傳遞至 Authorization 標題。您透過 Google 或電子郵件註冊後即可立即取得金鑰，無需提供手機號碼。請妥善保管此金鑰，因為它是存取服務所需的唯一憑證。

POST /v1/chat/completions：參數與範例

使用標準的聊天補全格式向端點發送第一條訊息。模型 ID 始終為 "uncensored"，您可以透過 temperature 和 top_p 等參數控制輸出風格。此端點處理所有文本生成，無需複雜的本機設定。

Copycurl https://api.nsfwgemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top ten system prompts for the model"}]
  }'

確保您的資料載體包含 model field set to "uncensored" and a messages 包含您的提示的陣列。系統回傳包含生成文字的結構化 JSON 回應。

GET /v1/models：列出可用模型

查詢 models 端點以驗證可用實例並確認連線。此 GET 請求回傳當前模型配置的元資料，不會消耗任何信用額度。在傳送昂貴的生成請求之前，請使用此方法偵測連線問題。

Copyfrom openai import OpenAI

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

回應確認了模型 ID 與 Token 限制，確保您的客戶端已正確配置以用於無審查的大型語言模型。

帶有 SSE 的串流回應

在請求主體中將 stream: true 透過伺服器發送事件（Server-Sent Events）即時接收 token。這可降低長篇創意寫作或角色扮演情境的感知延遲。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)

解析每個增量物件以增量渲染文本，為互動式 NSFW 聊天機器人應用程式提供更流暢的使用者體驗。

錯誤處理與 Token 使用

妥善處理常見的 HTTP 錯誤：401 表示金鑰無效或已過期，402 表示您需要充值信用額度，429 表示已達到速率限制上限。錯誤不會消耗您的預付信用額度，因此您可以無損地重試。請務必檢查 usage field in successful responses to track consumption.

速率限制與併發

每個 API 金鑰支援每分鐘 300 次請求，最多允許 8 個併發有效請求。最大請求主體大小為 8 MB，適合大多數標準上下文視窗。超過這些限制將觸發 429 錯誤，直到視窗重置為止。

上下文視窗總共允許 100,000 個 token，包含提示與補全。每次請求的最大輸出為 16,000 個 token，若未指定則為 2,048 個 token。 max_tokens. 根據應用程式的流量模式調整您的併發性。

支援的參數：Temperature、Top P 等

使用以下參數控制隨機性與確定性 temperature, top_p, stop, seed，以及懲罰參數。使用 response_format 設定為 {"type": "json_object"} 用於結構化資料輸出。函式呼叫透過 tools 參數用於進階整合。

這些參數允許微調無審查模型的行為，確保其符合您特定的 NSFW 內容需求且不會出現意外拒絕。

Node.js

Copyimport OpenAI from "openai";

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