用 OpenRouter 為編程代理接入更多模型:一個 API key 打通數百個模型

當代理(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

[2] OpenRouter — Quickstart 官方文件

[3] OpenRouter — MCP Server 官方文件

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

*