API 參考

基礎 URL 與驗證

使用專屬基礎 URL 進行所有請求。您的 API 金鑰透過 Authorization 標頭。

• 基礎 URL： https://api.hereticuncensored.com/v1
• 模型 ID： uncensored

從儀表板檢索您的金鑰。它在建立時立即有效。

Copycurl https://api.hereticuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five features of the new release."}]
  }'

首次請求

發送簡單的聊天完成請求以驗證連線能力。該模型在合法成人用途下會針對標準內容篩選機制作出回應。

• 設定 model 以 uncensored.
• 包含您的 messages 陣列。

檢查響應中的 choices 包含您生成的文字。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hereticuncensored.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 SDK 整合

使用您的基礎 URL 和金鑰初始化客戶端。這確保了與標準 OpenAI 函式庫的相容性。

• 安裝官方 openai 套件。
• 通過 baseURL 和 apiKey 初始化期間。

呼叫 chat.completions.create() 搭配您的提示。回應結構與標準 API 格式相同。

Copyimport OpenAI from "openai";

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

串流回應

透過設定 stream 以 true. 這可降低長輸出時的感知延遲。

• 監聽 delta 區塊。
• 合併片段以重建完整回應。

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)

速率限制與上下文

API 支援 100,000-token 上下文視窗。您可以每分鐘每個金鑰發送最多 300 次請求。

• 最大併發請求數：8
• 最大輸出 token：16,000（預設 2,048）

超出限制會觸發 429 錯誤。管理併發性以維持高負載工作負載的穩定吞吐量。

錯誤處理與代碼

優雅地處理錯誤以維持應用程序穩定性。常見代碼包括 401（無效）和 402（信用額度不足）。

• 429 表示速率限制耗盡。
• 400 表示格式錯誤的請求主體。

已消耗的 Token 不發行退款。請定期檢查餘額以避免服務中斷。