OpenRouter AI 金鑰：快速入門指南

基礎 URL 與驗證

您的 API 金鑰用於驗證對我們端點的所有請求。使用基礎 URL https://api.openrouteraikeys.com/v1 並將您的金鑰傳遞至 Authorization 標頭。此設定與任何 OpenAI 相容的 SDK 搭配使用，因為我們複製了他們標準的驗證模式。您無需修改用戶端程式庫，只需調整基礎 URL 設定即可。

• 標頭： Authorization: Bearer YOUR_API_KEY
• 基礎 URL： https://api.openrouteraikeys.com/v1

首次請求

發送標準聊天完成請求以測試連接性和回應格式。模型 ID 為 uncensored 並接受標準的訊息陣列。此端點僅返回文字，因此不要在回應載荷中期望圖片或音訊資料。

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

Python SDK 集成

使用您的金鑰和自訂基礎 URL 初始化客戶端。這允許您使用熟悉的 chat.completions.create 無需包裝額外邏輯的 method。庫自動為您處理序列化和重試邏輯。

Copyfrom openai import OpenAI

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

Node SDK 整合

配置 OPENAI_API_KEY 和 OPENAI_BASE_URL 環境變數或直接傳遞給客戶端建構子。這確保所有後續呼叫都路由至我們的無審查端點。您可以繼續使用已安裝的相同 SDK 版本。

Copyimport OpenAI from "openai";

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

串流回應

在請求主體中將 stream: true 在你的請求中。API 在模型生成文字時返回伺服器發送的事件 (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)

限制、錯誤與上下文

上下文視窗支援提示詞與補全總計 100,000 個 token。每個金鑰每分鐘限 300 次請求。401 錯誤表示 API 金鑰無效或缺失。402 錯誤表示預付餘額不足。429 錯誤表示您已超過速率限制。因內容政策而拒絕的請求不計費，但計算錯誤可能會消耗 token。