API 快速入門

基礎 URL 與驗證

首先將您的客戶端指向我們的基礎 URL，並在標頭中傳遞您的金鑰。我們使用標準的 Authorization 機制，因此任何 OpenAI SDK 或兼容的客戶端均可立即運作。您無需管理複雜的 OAuth 流程或等待審核。只需使用 Google 或電子郵件註冊，複製金鑰即可準備就緒。端點為 https://api.aiohnezensur.com/v1 並接受 Authorization: Bearer YOUR_API_KEY 每次請求的標頭。

發送您的第一個請求

進行簡單的聊天完成呼叫以測試 uncensored 模型。此請求發送提示並接收文本回應，且沒有通常的公司防護機制。您可以使用任何支援 OpenAI 協議的工具，但直接的 curl 呼叫能清楚顯示底層運作情況。請取代 YOUR_API_KEY 搭配儀表板中的實際金鑰。

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

回應包含生成文字與 Token 用量統計。如果您收到回應，表示您的整合運作正常。您現在可以繼續建立更複雜的互動，或切換至程式化客戶端。

Python SDK 集成

使用官方 OpenAI Python 套件無縫地與我們的 API 互動。將 base URL 設為我們的端點，並將您的金鑰作為 API token 提供。這使您能夠利用現有程式碼庫，而無需重寫 HTTP 邏輯。模型 ID 為 uncensored, 觸發我們特定的大型語言模型，針對無限制輸出進行調整。

Copyfrom openai import OpenAI

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

此程式碼片段展示了基本的訊息交換。您可以調整 messages 陣列以包含系統提示或對話歷史。SDK 會為您處理序列化與錯誤解析。

Node SDK 整合

使用 Node SDK 將 API 整合到您的 JavaScript 或 TypeScript 應用程式中。設定 Base URL 和 API 金鑰，就像 Python 範例一樣。此方法非常適合伺服器端渲染或後端微服務。SDK 抽象化了網路層，讓您可以專注於提示邏輯。

Copyimport OpenAI from "openai";

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

運行此代碼以查看模型對您輸入的響應。您可以通過更改提示詞內容快速迭代。響應結構符合標準 OpenAI 格式，確保與您技術棧中的其他工具兼容。

串流回應

啟用串流以在產生時接收權杖，降低感知延遲。這對於即時顯示文字的介面至關重要。設定 stream 參數至 true 在您的請求中。API 傳送一系列伺服器發送事件 (SSE)，而非單一 JSON 物件。每個區塊包含回應的部分增量。

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)

在客戶端連接這些差異以重建完整訊息。這種方法對用戶來說感覺是即時的，即使是對於長輸出也是如此。最後一個區塊包含總 token 使用量，允許您準確計費。

速率限制與限制條件

了解技術限制以防止生產環境中的請求失敗。每支金鑰每分鐘允許 300 次請求，且可同時進行 8 個請求。請求主體不得超過 8 MB。如果您超過這些限制，API 將返回 429 狀態碼。您應在客戶端實現指數退避以優雅地處理這些尖峰。上下文視窗總共為 100,000 個 token，每次請求的最大輸出為 16,000 個 token。錯誤與拒絕不會消耗信用額度，因此您可以安全地重試。身份驗證錯誤返回 401，資金不足返回 402。