基礎 URL 與驗證
我們的 API 完全相容於 OpenAI，這表示您可以使用任何標準 SDK 並進行最小程度的變更。所有請求的基礎 URL 為 https://api.openrouterapi.top/v1。驗證透過 Authorization 標頭中的 Bearer token 處理。您可以在儀表板上透過 Google 或電子郵件帳號註冊來即時產生此金鑰。請妥善保管您的金鑰，因為它可直接存取您的預付額度。
第一個請求
使用簡單的 curl 指令測試端點。將 YOUR_API_KEY 替換為您的實際金鑰。模型 ID 設為 uncensored 以繞過標準內容審查。此請求會發送提示詞並等待完整回應。
curl https://api.openrouterapi.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'如果金鑰無效，您會收到 401 錯誤。如果您的預付額度已耗盡，您會收到 402 錯誤。這些錯誤不會消耗您的 token 餘額，但會計入您的速率限制配額。
Python SDK 整合
使用官方的 openai Python 套件非常簡單。使用您的基礎 URL 和金鑰初始化客戶端。SDK 會自動處理 JSON 序列化。此範例展示基本的聊天完成請求。
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterapi.top/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)請確保您已安裝最新版本的 SDK。客戶端物件管理連線池，因此您可以重複使用它來發送多個請求，無需重新初始化。
Node SDK 整合
對於 JavaScript 環境，Node SDK 運作方式相同。在初始化期間傳遞自訂基礎 URL。這種方法允許您將無審查產生功能無縫整合到現有的網頁應用程式或後端服務中。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterapi.top/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);Node SDK 支援基於 promise 和 async/await 模式。錯誤處理與其他相容於 OpenAI 的服務一致。
串流回應
在請求中設定 stream: true 以啟用串流。API 會傳回 Server-Sent Events (SSE)。每個區塊包含部分文字。最後一個區塊包含用於計費的 token 使用統計數據。
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)預付額度根據最終輸出中產生的實際 token 收費。串流不會改變計費模式；您只需為成功交付的 token 付費。
速率限制與上下文視窗
每支 API 金鑰限制為每分鐘 300 個請求和 8 個並行請求。最大請求主體大小為 8 MB。上下文視窗支援最多 100,000 個 token（輸入加輸出）。每個請求的最大輸出為 32,000 個 token，如果 max_tokens 未設定則為 2,048 個 token。401 或 402 等錯誤不會消耗額度，但它們會計入您的速率限制。特定內容類型的拒絕也是免費的。
