---
title: "用 OpenRouter 為編程代理接入更多模型：一個 API key 打通數百個模型"
url: https://sammy.hk/%e7%94%a8-openrouter-%e7%82%ba%e7%b7%a8%e7%a8%8b%e4%bb%a3%e7%90%86%e6%8e%a5%e5%85%a5%e6%9b%b4%e5%a4%9a%e6%a8%a1%e5%9e%8b%ef%bc%9a%e4%b8%80%e5%80%8b-api-key-%e6%89%93%e9%80%9a%e6%95%b8%e7%99%be/
author: Ethan
published: 2026-09-16T19:26:00+08:00
modified: 2026-09-16T19:26:00+08:00
description: "當代理（agent）只用單一模型應付所有工作，成本與效果往往難以同時兼顧。OpenRouter 提供另一條路：以一個 API key 接通數百個來自不同供應商的模型，並在單一 API 端點上自動處理備援與成本最佳化。The Rundown 最新指南示範如何設定 OpenRouter key、比較模型，並用較便宜的模型測…"
categories: [AI]
tags: ["AI代理", API, OpenRouter, "人工智能", "模型比較"]
source: https://sammy.hk
---
當代理（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](https://app.therundown.ai/guides/openrouter-101-add-new-ai-models-to-codex-and-claude-code)

\[2\] [OpenRouter — Quickstart 官方文件](https://openrouter.ai/docs/quickstart)

\[3\] [OpenRouter — MCP Server 官方文件](https://openrouter.ai/docs/guides/overview/mcp-server)

### 相關文章：

1. [揭開「Ox Alpha」之謎：智譜 Z.ai 的 GLM-5.3-Flash 如何以匿名之姿攻陷 OpenRouter](https://sammy.hk/%e6%8f%ad%e9%96%8b%e3%80%8cox-alpha%e3%80%8d%e4%b9%8b%e8%ac%8e%ef%bc%9a%e6%99%ba%e8%ad%9c-z-ai-%e7%9a%84-glm-5-3-flash-%e5%a6%82%e4%bd%95%e4%bb%a5%e5%8c%bf%e5%90%8d%e4%b9%8b%e5%a7%bf%e6%94%bb%e9%99%b7/ "揭開「Ox Alpha」之謎：智譜 Z.ai 的 GLM-5.3-Flash 如何以匿名之姿攻陷 OpenRouter")
2. [OpenAI 報告揭盅:700 個「失控」AI 代理如何攻陷 Hugging Face,以及 116 間公司發起的集體網絡防禦](https://sammy.hk/openai-%e5%a0%b1%e5%91%8a%e6%8f%ad%e7%9b%85700-%e5%80%8b%e3%80%8c%e5%a4%b1%e6%8e%a7%e3%80%8dai-%e4%bb%a3%e7%90%86%e5%a6%82%e4%bd%95%e6%94%bb%e9%99%b7-hugging-face%e4%bb%a5%e5%8f%8a-116-%e9%96%93/ "OpenAI 報告揭盅:700 個「失控」AI 代理如何攻陷 Hugging Face,以及 116 間公司發起的集體網絡防禦")
3. [100 個 AI 代理解數學：有代理出術「造假證明」，有代理吹哨告發](https://sammy.hk/100-%e5%80%8b-ai-%e4%bb%a3%e7%90%86%e8%a7%a3%e6%95%b8%e5%ad%b8%ef%bc%9a%e6%9c%89%e4%bb%a3%e7%90%86%e5%87%ba%e8%a1%93%e3%80%8c%e9%80%a0%e5%81%87%e8%ad%89%e6%98%8e%e3%80%8d%ef%bc%8c%e6%9c%89%e4%bb%a3/ "100 個 AI 代理解數學：有代理出術「造假證明」，有代理吹哨告發")
4. [AI 代理專用吹哨熱線登場：以 GET 請求告狀、一行 curl 舉報](https://sammy.hk/ai-%e4%bb%a3%e7%90%86%e5%b0%88%e7%94%a8%e5%90%b9%e5%93%a8%e7%86%b1%e7%b7%9a%e7%99%bb%e5%a0%b4%ef%bc%9a%e4%bb%a5-get-%e8%ab%8b%e6%b1%82%e5%91%8a%e7%8b%80%e3%80%81%e4%b8%80%e8%a1%8c-curl-%e8%88%89/ "AI 代理專用吹哨熱線登場：以 GET 請求告狀、一行 curl 舉報")