OpenRouter：透過統一 API 呼叫多種 AI 模型

OpenRouter 為開發者提供共用的模型目錄與 API 接入層，可從同一介面選擇不同 AI 模型和服務提供者。官網目前列出文字、圖片、影片與音訊模型，並提供 API、客戶端 SDK 和 Agent SDK 等整合方式。模型能力、價格、上下文限制、服務地區和提供者政策各不相同。整合前請查看模型目錄、官方文件和價格頁面。

主要能力

• **統一 API 與目錄：**透過單一 API 查詢及呼叫可用模型。可在目錄查看模型說明與現行價格，也可透過 API 取得模型清單。
• **相容 OpenAI SDK：**官方文件提供 OpenAI SDK 接入方式。遷移時仍須設定 OpenRouter API 位址、金鑰和模型識別碼，並確認目標模型支援所需參數。
• **客戶端與 Agent SDK：**文件提供 JavaScript/TypeScript 與 Python 客戶端 SDK，以及用於工具呼叫、對話迴圈和狀態管理的 Agent SDK。實際介面以版本文件為準。
• **模型與提供者路由：**路由和回退選項可用於處理模型或提供者可用性。行為取決於請求設定、端點和方案，不代表每次都會自動選最低價格或保證不中斷。
• **依模型計費：**推理費用依所選模型的公開價格計算。不同方案的服務費、模型存取、預算工具和其他功能可能不同。價格和方案會調整，請以即時頁面為準。
• **資料政策設定：**OpenRouter 文件說明不同模型提供者各自有資料處理政策，並提供帳戶或單次請求的篩選設定。傳送敏感內容前，請檢查所選提供者規則和帳戶隱私選項。

開始使用

1. 建立帳戶並查看現行方案、模型目錄、計費說明和資料政策。
2. 在控制台建立 API 金鑰，存放於環境變數或密鑰管理器；不要提交到原始碼庫、嵌入客戶端應用或寫入日誌。
3. 選擇模型並閱讀輸入、輸出、工具呼叫及多模態要求。使用 OpenAI SDK 時，依官方說明設定 baseURL、API 金鑰和模型名稱。
4. 先以非敏感資料測試請求格式、計費紀錄、錯誤處理和可選回退，再接入正式資料。
5. 設定預算或金鑰限額，並定期檢查用量、計費和提供者政策。

適用情境與限制

OpenRouter 適合希望透過單一 API 管理多種模型選項的開發者，也可用於比較模型、建立聊天或 Agent 流程，以及呼叫相容的圖片或音訊模型。工具呼叫、結構化輸出和多模態功能取決於具體模型與端點。統一介面可減少部分整合差異，但不會消除各模型的參數、價格、限制和行為差異，也不保證固定延遲、準確性或可用性。

請求會依所選模型和提供者路由。OpenRouter 本身的資料設定與模型提供者政策是不同環節。傳送程式碼、客戶資料或個人資訊前，請檢查資料保留、訓練使用、區域處理和日誌選項。AI 輸出應由應用程式端進行安全檢查與事實核對。費用會隨模型和服務條件變動，成本估算與測試應納入錯誤及回退處理。

常見問題

OpenRouter 是什麼？

它是多模型 API 平台，提供模型目錄、統一 API 與 SDK 等開發工具。可用模型與端點以目前目錄為準。

可以使用 OpenAI SDK 嗎？

官方文件提供相容接入方式，通常需設定 OpenRouter 的 baseURL、API 金鑰與模型名稱，並確認模型支援所需參數。

使用費用如何計算？

模型推理費用依目錄中的模型價格計算；方案可能另有服務費或功能。請查看即時價格及帳戶計費資料。

請求資料如何處理？

OpenRouter 與各模型提供者分別有資料政策。請檢查帳戶中的日誌、資料使用和提供者篩選設定，以及所選提供者的保留規則。