API 文件：Quickstart Guide

基礎 URL 與驗證

Heretic AI API 完全與 OpenAI 相容。您可以透過將客戶端指向我們的 base URL 來與之互動： https://api.hereticai.cc/v1. 認證依賴於每個帳戶單一的 API 金鑰，該金鑰在透過 Google 或電子郵件註冊時即時生成。將此金鑰傳遞至 Authorization 作為 Bearer token 標頭。模型標識符僅為 uncensored. 單一模型處理您的所有請求，無路由複雜性。401 錯誤表示金鑰無效，而 402 錯誤表示您需要更多預付加密貨幣餘額。

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

聊天完成端點

使用 POST /v1/chat/completions 端點。API 預期收到一個包含您對話歷史或提示詞的標準 messages 陣列。它會將生成的文字回傳至 choices 陣列。這是一個純工具 API：文字輸入，文字輸出。您只需為消耗的 token 付費。預付信用額度永不過期，拒絕回應或錯誤不會消耗 token。這種方式消除了訂閱綁定和不可預測的免費層級。

Copyfrom openai import OpenAI

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

串流回應 (SSE)

在請求主體中將 stream: true 在你的請求中。API 為每個生成的 Token 返回伺服器發送的事件 (SSE)。這允許你漸進地顯示輸出，這對於延遲敏感型應用程式至關重要。Token 使用統計數據出現在串流的最後一個區塊中。此功能與自動處理 SSE 的標準 OpenAI SDK 無縫配合。它提供即時回饋，無需等待完整完成。

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 支援帶有 tools 和 tool_choice 參數。在請求中定義您的工具架構，模型將在適當時返回結構化的函式呼叫。這使得 LLM 能夠決定下一步採取何種動作的複雜工作流程成為可能。您可以強制使用特定工具，也可以讓模型自由選擇。這種能力對於構建與外部系統或資料庫互動的代理應用程式至關重要。

JSON 模式

確保透過設定實現確定性輸出 response_format 以 {"type": "json_object"}. 模型將將其回應限制為有效的 JSON，這對於程式化解析至關重要。這減少了事後修正正規表示式的需求。它保證輸出可以直接被您的程式碼消費。這對於結構化資料擷取或組態生成任務特別有用。

參數與限制

使用類似 temperature, top_p，以及 seed. 上下文視窗為 100,000 token（包含提示與補全）。每次請求的最大輸出為 16,000 token，或為 2,048（如果 max_tokens 未設定。速率限制為每分鐘 300 次請求，每個金鑰併發請求上限為 8 個。請求主體必須保持在 8 MB 以下。這些限制確保開發人員能夠穩定進行高容量使用。

Node.js

Copyimport OpenAI from "openai";

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