當代理(agent)只用單一模型應付所有工作,成本與效果往往難以同時兼顧。OpenRouter 提供另一條路:以一個 API key 接通數百個來自不同供應商的模型,並在單一 API 端點上自動處理備援與成本最佳化。The Rundown 最新指南示範如何設定 OpenRouter key、比較模型,並用較便宜的模型測試想法。[1][2]
適用對象與前置準備
指南列出三類適合的使用者:想讓代理製作出更好產品圖與廣告稿的市場推廣人員;想為例行編程任務試用更便宜模型的開發者;以及對現有代理滿意、但想為特定工作改用另一個模型的人。[1]
開始前需要:一個 OpenRouter 帳戶;一個能發出 API 請求的代理,以及一個私下儲存 API key 的位置;一個小型測試任務(若測試產品圖,需準備產品照片)。
設定步驟
指南建議由「想代理做得更好的一項工作」出發——製作產品圖、審閱程式碼,或更便宜地處理例行任務——然後在模型目錄中篩選:
- 在 OpenRouter 模型目錄中按該任務篩選,將價格由低至高排序,再開啟模型頁面查看其能力、價格與使用限制,找到合適的就複製模型名稱
- 到「API Keys」選擇建立新 key,並以使用該 key 的專案或代理命名,方便日後辨認相關費用
- 建立 key 前先設定消費上限與到期日。指南的示範只測試一天,故把 key 設為一日後到期
- 請代理協助完成 OpenRouter 設定,並告知 key 應私下存放的位置;不要把 key 放在共享對話或可能被公開的專案檔案中
指南特別提醒一項容易犯的錯:確認所選模型能生成圖像。他們曾誤選一個視覺模型(用於讀取圖像),結果要返回目錄重新選擇。
指南亦強調設定消費上限的價值:他們檢查早前的圖像用量時,發現花費比想像中多,而消費上限提供了停止的位置。
實測:用便宜模型做廣告草稿
設定完成後,指南把模型名稱與一項小任務交給代理。示範用的提示要求代理透過 OpenRouter 使用指定模型,以附上的產品照片作參考,為產品製作三款廣告草稿,每款採用不同版面,並保持產品可辨識。
實測結果顯示,較便宜的草稿模型提供了可發展的方向,但帽子的外觀不如較貴的 GPT Image 2.5 版本接近真實產品。指南的結論是:這類草稿適合用來選擇方向,但未達到可直接發布的產品廣告水平。
測試後應檢查 key 在 OpenRouter 的用量。指南的示範當時顯示為零,但提醒不要假設每次執行都免費,應自行查閱所選模型的價格與限制。
官方整合方式
OpenRouter 官方文件提供三種整合方式,按所需控制程度區分:[2]
- API:直接向
/api/v1/chat/completions端點發送標準 HTTP 請求,適用於任何語言或框架,控制最完整 - Client SDK:官方 SDK 在 REST API 之上提供完整型別安全與自動生成的型別,減少樣板程式碼
- Agent SDK:提供建立代理所需的高階原語,自動處理多輪對話循環、工具執行與狀態管理
此外,若已有以 OpenAI SDK 編寫的程式碼,可直接把 base URL 指向 OpenRouter,作為無需改動結構的替代方案。
配合 AI 助手使用
若使用 Claude Code、Cursor 或 Codex 等 AI 編程工具,官方建議連接 OpenRouter 的 MCP server。[3] 該伺服器由 OpenRouter 託管,毋須安裝,助手可取得即時資料(有哪些模型、價格、帳戶餘額、使用排名)並搜尋官方文件,令建議基於最新資料而非過時的訓練知識。設定只需在 MCP 客戶端加入一個網址並完成 OAuth 登入。
參考資料
[1] The Rundown — Give Your Coding Agent Access to Better AI Models with OpenRouter