What is the uncensored ia model context window?

該模型支援 100,000 token 的上下文視窗。這包含 prompt 與 completion。沒有單獨的輸出上限：回應可以使用視窗中剩餘的所有空間。

How do I handle streaming responses in Python?

Set the stream parameter to true in your request. Iterate over the response object to process each chunk. Use the official SDK for automatic SSE parsing.

What happens if I hit the rate limit?

API 回傳 429 狀態碼。您可以稍作延遲後重試。每個金鑰每分鐘允許 300 次請求。如有需要，可產生更多金鑰以提高並發性。

API 文件：OpenAI Compatible Endpoints

1. Quickstart: Connect Your First Request

基礎 URL 為 https://api.apertusia.com/v1。請在 Authorization 標頭中傳遞您的 API 金鑰。模型識別碼為 uncensored。此設定適用於任何與 OpenAI 相容的客戶端。

使用此 cURL 指令立即測試連線。將 YOUR_API_KEY 替換為您的實際金鑰。

curl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

身份驗證錯誤會回傳 401。資金不足會回傳 402。速率限制會回傳 429。

2. 支援的參數：Temperature、Top P 和 Seed

使用 temperature 控制隨機性，以 top_p 控制多樣性，並以 seed 確保可重現性。這些參數遵循標準的 OpenAI 慣例。將 temperature 設為 0.7 以獲得平衡的輸出，或設為 1.0 以提高創造力。使用 top_p 將採樣限制在最高的機率質量範圍內。seed 參數可確保除錯時輸出完全相同。

用於本機測試的 Python 程式碼範例：

from openai import OpenAI

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

3. 使用伺服器推送事件（SSE）的串流回應

透過設定 stream: true 啟用串流。API 會透過伺服器發送事件（Server-Sent Events）回傳資料片段。每個片段包含部分文字與 token 使用量資訊。這可降低長回應的感知延遲。處理 SSE 事件以即時更新您的 UI。

使用官方 SDK 的 Node.js 範例：

import OpenAI from "openai";

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

4. 函式呼叫與 JSON 模式設定

使用 response_format 並設定為 {"type": "json_object"} 以獲得嚴格的 JSON 輸出。這可確保程式化管線使用結構化資料。在請求主體中提供 tools 陣列以啟用函式呼叫功能。模型將以預期格式回傳工具呼叫。使用 tool_choice 強制特定行為。

5. 速率限制與請求大小限制

每個 API 金鑰支援每分鐘 300 次請求。每個金鑰的併發請求上限為 8 次。請求主體的最大大小為 8 MB。上下文視窗總共可容納 100,000 個 token。每次請求的最大輸出可達完整的 100,000-token 視窗。請保持 max_tokens 未設定，或將其設為較高數值，以避免截斷。錯誤不會消耗信用額度。不發給退款，但帳單錯誤可透過客服進行修正。

6. 身份驗證與錯誤處理

透過儀表板產生您的金鑰。使用 Google 登入或電子郵件。金鑰會立即顯示。將其包含在 Authorization: Bearer 標頭中。無效的金鑰會回傳 401。429 錯誤表示已耗盡速率限制。402 錯誤表示您的預付信用額度已耗盡。使用 USDT 或 USDC 充值。信用額度永不過期。

串流

stream = 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)

Apertus ia API Documentation