API 文件

基礎 URL 與驗證

API 端點位於 https://api.openrouteraiapi.com/v1。將您的 API 金鑰傳入 Authorization header 作為 bearer token。此 header 是將流量從您目前的供應商重新導向至我們 uncensored 模型所需的唯一變更。

驗證很嚴格。如果金鑰遺失或無效，伺服器會立即返回 401 錯誤。您可以透過儀表板上的 Google 或電子郵件立即生成金鑰。妥善保管金鑰，因為它授予您對預付信用的存取權。

聊天完成端點

傳送 POST 請求至 /v1/chat/completions 使用訊息陣列。模型標識符為 uncensored. 單一模型處理您的所有文字生成需求，無需複雜的路由邏輯。

這是一個使用 cURL 的標準請求，用於驗證連線和回應格式。

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

回應包含生成文字於 choices[0].message.content 欄位。您可以將此直接解析至您的應用程式工作流程中。

Python SDK 集成

使用官方 OpenAI Python 客戶端輕鬆連接。設定 base_url 和 api_key 變數以指向我們的基礎設施。此方法在切換供應商時可將程式碼變更降至最低。

Copyfrom openai import OpenAI

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

客戶端自動處理序列化和重試。您收到一個包含文本和 token 使用統計數據的完成物件。此方法非常適合後端服務和腳本。

Node.js SDK 用法

使用您的自訂基礎 URL 初始化 OpenAI Node.js 用戶端。這允許 JavaScript 應用程式使用熟悉的方法與 uncensored 模型互動。SDK 會有效管理 HTTP 請求。

Copyimport OpenAI from "openai";

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

呼叫 chat.completions.create() 搭配您的訊息。回應物件提供對生成內容和使用數據的存取。此整合非常適合網頁伺服器和本機函式。

串流回應

在請求主體中將 stream: true 在你的請求中。伺服器返回伺服器發送的事件（SSE）以進行即時 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)

每個區塊包含部分內容。最終區塊包含完整的令牌使用統計數據。在您的客戶端中處理這些事件，以增量更新 UI。

限制、錯誤與上下文視窗

上下文視窗支援輸入與輸出合計 100,000 個 token。每次請求最多可輸出 16,000 個 token，若未設定則為 2,048 個 token。 max_tokens 未設定。速率限制允許每個金鑰每分鐘 300 次請求。

錯誤為標準 HTTP 代碼。401 表示金鑰無效。402 表示您的預付信用額度已耗盡。429 表示您已超過速率限制。失敗的請求不會消耗信用額度。錯誤是免費的。