OpenRouter API 文件

快速入門：使用 Python 連接

首先安裝官方的 SDK 並將其指向我們的基礎 URL。

我們的 API 行為類似於標準的 OpenAI 介面，但路由到單個 uncensored 模型。這種方法消除了代理複雜性，同時保持您的代碼可移植。

• 透過 pip 安裝函式庫。
• 在環境中設定您的 API 金鑰。
• 定義我們端點的基礎 URL。

Copyfrom openai import OpenAI

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

將佔位符金鑰替換為您的憑證。您可以發送簡單提示或複雜的結構化資料。

驗證與金鑰

在儀表板產生金鑰，並在 Authorization 標頭中傳遞。

每個帳戶同時支援一個有效金鑰。當您建立新金鑰時，舊金鑰會立即停止運作。這簡化了安全管理，無需複雜的輪換邏輯。

Copycurl https://api.apiopenrouter.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 dependencies for a Go web server"}]
  }'

上述請求使用 Bearer 方案。請確保您的金鑰以 sk- 並不包含額外空白。

聊天完成端點

發送訊息至 /v1/chat/completions 使用標準 JSON 的 endpoint。

模型接受 user 和 assistant 角色。您可以設定溫度、top-p 與停止序列，以控制輸出風格。如果啟用串流，回應會在最後一個區塊中返回 token 使用量。

Copyimport OpenAI from "openai";

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

設定 max_tokens 用於控制輸出長度。若省略此參數，預設值為 2,048 個 token。該模型每個請求最多支援 16,000 個 token。

串流回應

在請求主體中將 stream: true 在你的請求主體中。

Token 用量詳情僅出現在串流的最後一個數據塊中。這允許即時更新 UI 同時保留準確的計費數據。串流期間的錯誤仍會報告已收費 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)

優雅地處理部分回應。當模型完成生成或達到上下文限制時，串流會正常關閉。

函式呼叫 & JSON 模式

使用 response_format: {type: "json_object"} 用於嚴格的 JSON 輸出。

在 tools 陣列並設定 tool_choice 用於強制執行函數呼叫。模型會回傳適合程式化處理的結構化資料。這與我們的無審查權重配合運作時非常可靠。

Copycurl https://api.apiopenrouter.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 dependencies for a Go web server"}]
  }'

將函式呼叫與串流傳輸結合，實現互動體驗。在將 JSON 輸出傳遞給您的應用程式邏輯之前，請先進行驗證。

Limits and Quotas

根據每金鑰限制來監控您的使用情況，以避免中斷。

每個金鑰允許每分鐘 300 次請求與 8 個併發請求。請求主體大小上限為 8 MB。若超出這些限制，API 將返回 429 狀態碼。身份驗證錯誤返回 401，信用額度不足返回 402。

Copycurl https://api.apiopenrouter.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 dependencies for a Go web server"}]
  }'

提示與補全的總上下文視窗為 100,000 tokens。錯誤不會消耗信用額度。對於輕微內容違規的拒絕也保持免費。