整合指南

快速上手：您的第一個請求

該 API 是一個與 openai 兼容的 API，其結構與 Chat Completions 鏡像。您發送文本，接收文本。沒有額外的嵌入或音頻端點干擾您的工作流程。只需將您的客戶端指向我們的基礎 URL 即可開始。

• 基礎 URL：HTTPS://api.filtrosemia.com/v1
• 模型 ID："uncensored"

替換 SDK 配置中的現有基礎 URL。該端點處理從角色扮演到翻譯的所有內容，且沒有通常的過濾器。

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

驗證與標頭

將您的 API 金鑰傳入標準的 Authorization 標頭。我們為每個帳戶使用單一有效金鑰以簡化流程。若您需要新金鑰，請從您的儀表板產生。

• 標頭： Authorization: Bearer YOUR_API_KEY
• 無需管理 OAuth 流程或刷新權杖。

保持您的金鑰安全。它授予您預付信用額度的直接存取權。錯誤如 401 Unauthorized 意味著密鑰缺失或無效。

Copyfrom openai import OpenAI

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

聊天完成端點

發送訊息至 POST /v1/chat/completions. 模型支援標準參數如 temperature, top_p，以及 stop 序列。這是一個針對成人和創意內容調整的無審查模型。

• 支援 json_object 回應格式。
• 接受函式呼叫的工具定義。

請求會依您的速率限制依序處理。請確保您的負載保持在 8 MB 以下。

Copyimport OpenAI from "openai";

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

使用 Server-Sent Events 進行實時 token 交付。這降低了長輸出的感知延遲。最終塊包含完整的 token 使用量統計數據。

• 設定 stream: true 在您的請求中。
• 在您的客戶端中解析 SSE 串流。

串流運作方式與標準 OpenAI SDK 行為完全一致。您只需處理隨之到達的資料區塊（chunks）。

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)

上下文視窗和限制

該模型支援 100,000 token 的上下文視窗。這允許處理具有長歷史記錄的重載工作。每次請求的最大輸出為 16,000 個 token。

• 預設最大輸出：2,048 個 token。
• 速率限制：每分鐘 300 次請求。

超出限制會觸發 429 Too Many Requests 調整併發數量以保持在限制範圍內。每個金鑰允許 8 個併發請求。

錯誤處理與 Token

優雅地處理標準 HTTP 錯誤。 402 Payment Required 意味著您的預付信用額度已耗盡。 429 表示速率限制。 401 表示身份驗證問題。

• 錯誤免費。您只為成功的 token 使用付費。
• 因內容政策而拒絕的請求也是免費的。

檢查響應主體以獲取詳細的錯誤消息。使用這些信息調整您的重試邏輯或積分充值頻率。