API 文件

身份驗證與基礎 URL

驗證每個請求，在 Authorization 標頭。所有端點的基礎網址為 https://api.notfilter.cc/v1. 此結構可確保與現有 OpenAI SDK 相容，無需進行複雜的設定變更。

Copycurl https://api.notfilter.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the capital of france"}]
  }'

您的金鑰可存取無審查模型。請妥善保管，若遭洩漏請重新生成。系統會在處理令牌前驗證憑證，因此無效金鑰會立即返回錯誤。

聊天完成端點

透過 /v1/chat/completions 端點。這是您與模型互動的主要介面。設定如 temperature 和 top_p 調整回應行為。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.notfilter.cc/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 期望標準的訊息格式。輸入文字會轉換為 token，經過處理後返回一致的回應。錯誤透過標準 HTTP 狀態碼處理。

串流回應

透過設定 stream: true。API 會隨著生成進度回傳資料區塊。這可降低長回應的感知延遲。

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)

每個區塊包含部分內容。最終區塊包含令牌使用統計數據。解析這些事件以向您的使用者漸進式顯示文字。

函式呼叫與工具

定義工具以允許模型呼叫外部函式。在請求主體中指定工具定義。當需要呼叫函式時，模型會回傳結構化的參數。

Copyimport OpenAI from "openai";

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

使用回傳的參數執行函數，並將結果回傳給模型。這使得複雜工作流程無需手動解析即可實現。工具選擇可以強制或自動。

JSON 模式

透過設定 response_format 以 {"type": "json_object"}. 這可確保回應是有效的 JSON。適用於應用程式中的資料解析。

模型遵循您提供的 schema。JSON 結構錯誤雖少但有可能發生。為了安全起見，請在應用程式層級驗證輸出。

速率限制與上下文視窗

每個 API 金鑰支援每分鐘 300 次請求及 8 個並行請求。提示與補全合計的上下文視窗為 100,000 個 token。最大輸出為 16,000 個 token。

A 401 表示金鑰無效的錯誤。一個 402 表示您沒有預付信用額度。一個 429 表示已超出速率限制。錯誤請求是免費的，因此您不會為失敗的請求付費。信用額度永不過期。