Heretic LLM：API 文件

基礎 URL 與驗證

要開始使用 Heretic LLM API，請將你的 OpenAI 相容客戶端指向基礎 URL：https://api.hereticllm.com/v1。API 使用標準 Bearer token 驗證。你可以在「取得 API 金鑰」頁面僅使用電子郵件和密碼註冊來生成 API 金鑰。金鑰在註冊後立即顯示，且可隨時重新生成，這將使舊金鑰失效。

設定 OPENAI_API_KEY 環境變數，或在客戶端設定中直接傳遞金鑰。請將基礎 URL 更新為 Heretic 端點。此設定讓您可以零程式碼變更地使用官方 OpenAI SDK，只需更換基礎 URL 和金鑰即可。

首次請求

向聊天完成端點發送首次請求。模型識別碼為 uncensored。此開放權重模型經過調整，可針對合法成人用途無內容拒絕地回答，非常適合無審查的程式碼編寫、創意寫作或研究。上下文視窗支援最多 100,000 token，包含提示詞與生成結果的總和。

以下是測試端點的基礎 cURL 範例。請將 YOUR_API_KEY 替換為你的實際金鑰。

回應將是包含生成文字的標準 OpenAI 格式物件。

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

Python SDK 整合

使用官方 openai 套件將 API 整合至你的 Python 應用程式。該函式庫自動處理 JSON 序列化和串流。使用你的 API 金鑰和正確的基礎 URL 初始化客戶端。然後，以模型 ID uncensored 呼叫 chat.completions.create。

此方法對同步和非同步工作流程均無縫運作。模型對標準提示詞、函式呼叫和串流參數的回應方式與其他 OpenAI 相容端點相同。你可以傳遞系統提示詞以引導模型行為，或使用使用者訊息進行直接互動。

Copyfrom openai import OpenAI

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

對於 JavaScript 和 TypeScript 專案，請使用 openai npm 套件。使用 Heretic 基礎 URL 和你的 API 金鑰設定客戶端。API 支援標準請求結構，包括工具定義和函式呼叫。

請確保正確處理回應，特別是在使用 async/await 模式時。模型回傳的文字回應可直接在你的應用程式邏輯中處理。此整合非常適合建構需要無審查 LLM 能力的聊天介面、自動化代理程式或數據處理管線。

Copyimport OpenAI from "openai";

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

串流回應

在 API 請求中啟用串流輸出以啟用即時回應。將 stream 參數設為 true。API 將回傳伺服器推送事件 (SSE) 串流，包含生成中的文字區塊。這可降低感知延遲，並為聊天應用程式提供更流暢的使用者體驗。

串流中的每個區塊包含回應的一部分。增量處理這些區塊以即時更新你的 UI。串流功能完全相容 OpenAI SDK，因此你可以使用標準 stream 迭代器或事件監聽器來高效處理資料。

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 對每個金鑰實施每分鐘 300 次請求的限制，以及 8 MB 的請求主體大小。如果你超過速率限制，將收到 429 錯誤。驗證錯誤回傳 401 狀態，表示 API 金鑰無效或缺失。如果你的預付額度耗盡，API 回傳 402 錯誤，需要儲值。

額度永不過期，你可以使用加密貨幣 (USDT 或 USDC) 從 $10 開始儲值，較大存款享有額外額度。模型支援 100,000 token 上下文視窗。確保你的提示詞和生成結果在此限制內。更多定價和限制詳情，請造訪定價頁面。