API 文件

基礎 URL 與驗證

透過指向我們的專用端點並傳遞您的唯一 API 金鑰來連接您的應用程式。所有請求的基礎 URL 為 https://api.apertusapp.com/v1. 您在 取得 API 金鑰 頁面。將此金鑰包含在 Authorization 每次請求的標頭。

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

每個帳戶生成一個有效金鑰。若您生成新金鑰，舊金鑰將立即失效。這確保了對存取的嚴格控制，且無訂閱層級或閒置費用。

首次請求

向聊天補全端點發送第一個提示詞以接收原始、無過濾的文本。使用模型 ID uncensored 存取我們針對合法成人和爭議性主題調整的特定開源權重模型。

Copyfrom openai import OpenAI

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

API 接受標準參數，例如 temperature 和 top_p. 錯誤和拒絕不消耗 Token，因此您只需為實際到達模型的內容付費。與收取路由費用的高價聚合器相比，這種方法能保持成本可預測。

Node SDK 整合

使用官方 Node SDK 高效處理 JSON 模式和函式呼叫。設定 response_format 以 {"type": "json_object"} 用於結構化輸出或定義工具以實現類似代理程式的行為。

Copyimport OpenAI from "openai";

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

該模型支援工具呼叫與 tool_choice 選項。您也可以設定一個 seed 用於確定性結果。這種靈活性允許您在不移出 OpenAI 相容生態系統的情況下構建複雜應用程式。

串流回應

使用伺服器發送事件 (SSE) 即時串流 token，以實現低延遲的使用者體驗。每個區塊包含生成的文本，最終區塊包含總 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 會自動處理 SSE 協定，在您端所需的程式碼最少。

上下文視窗與容量

該模型支援 100,000 個 token 的上下文視窗，包含輸入與輸出。您可以指定每個請求最多 16,000 個 token，或者如果您省略 max_tokens.

這種大窗口允許進行廣泛的文檔分析或長對話歷史。但是，請保持請求主體在 8 MB 以下。該模型不是 GPT 或 Llama；它是一個針對你特定用例進行優化的獨特無審查 AI 模型。

錯誤處理與限制

優雅地處理標準 HTTP 錯誤以維持穩健的應用程式流程。一個 401 表示 API 金鑰無效或缺失的錯誤。一個 402 表示您的預付信用額度已耗盡。一個 429 表示您已超過每分鐘 300 次請求或 8 個併發請求的限制。

信用永不過期，因此您可以在間歇期暫停使用並稍後恢復。像重複扣款這樣的錯誤可以通過支援頁面修復。預付信用額度僅根據實際 token 消耗收費，確保每個字節的定價透明。