API 快速入門與整合

基礎 URL 與驗證

Heretic 專案提供單一託管的文字生成端點。請使用 https://api.hereticproject.com/v1 作為您的基礎 URL。驗證機制依賴透過 Authorization 標頭。在儀表板上使用 Google 或電子郵件登入來建立您的金鑰。系統為每個帳戶發出一個有效金鑰；產生新金鑰會立即使舊金鑰失效。

您只需為消耗的 token 付費。錯誤和拒絕不會扣除您的預付額度。新帳戶會獲得 $0.50 的試用額度，有效期為 7 天。您可以使用 USDT (TRC20) 或 USDC (Base) 充值，金額介於 $20 至 $500 之間。

/v1/chat/completions 端點

發送訊息至標準聊天補全端點。模型 ID 為 uncensored. 它接受具有如 system, user或 assistant. 模型不會拒絕合法的成人、虛構或爭議性主題。它是一個開放權重的模型，針對直接回答進行了調整。

請求回傳包含產生文字的 JSON 物件。上下文視窗支援提示詞與補全合計 100,000 個 token。每次請求的輸出上限為 16,000 個 token，除非您指定較低的 max_tokens 值。

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Python SDK 集成

使用具有自訂 base URL 的官方 OpenAI Python 程式庫。設定 api_key 您的 API 字串。設定 base_url 指向 Heretic Project 伺服器。這允許您使用熟悉的方法，例如 chat.completions.create() 無需大幅修改現有的程式碼結構。

透過 pip 安裝函式庫。將您的憑證直接傳遞給客戶端初始化。函式庫會自動處理序列化。此方法同時適用於同步和非同步工作流程。確保您以優雅的方式處理潛在的網路錯誤。

Copyfrom openai import OpenAI

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

Node.js SDK 的運作方式與 Python 版本相同。使用您的 API 金鑰與正確的基礎 URL 初始化客戶端。您可以使用相同的方法簽章發送完成請求。這確保了您技術堆疊各部分的一致性。

非同步處理回應。如果您使用串流方法，SDK 會串流資料。否則，它會返回完整的 JSON 回應。這種靈活性支援批次處理和即時介面。請將 API 金鑰安全地保存在環境變數中。

Copyimport OpenAI from "openai";

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

串流回應 (SSE)

在請求主體中將 stream: true 在你的請求中。伺服器發送伺服器發送的事件（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)

限制、錯誤與上下文

請遵守速率限制以避免服務中斷。每支金鑰每分鐘允許 300 次請求。併發性限制為 8 個同時請求。請求主體不得超過 8 MB。超過這些限制將返回 429 狀態碼。稍作等待後再重試。

驗證失敗會返回 401 錯誤。如果金鑰無效或過期，就會發生這種情況。402 錯誤表示預付信用額度不足。退款錯誤透過支援頁面處理。信用額度永不過期。模型拒絕涉及未成年人的內容。接受所有其他合法內容。