OpenRouter 的核心價值是「一套 API,多家模型」。你的應用程式可以維持類似 OpenAI Chat Completions 的呼叫方式,只改 model slug 就切到不同模型,也能讓路由器在某個 provider 忙碌或失敗時改走備援。
這能減少多套 SDK 與帳單整合,代價是多一層路由與資料政策。選了某個模型名稱,不代表每次都由同一家 provider 處理;若公司在意資料保存、地區、價格與參數支援,必須把 provider 規則寫清楚。
建立 API Key 與第一個請求
建立帳號、購買或取得 credits 後,到 Keys 建立 key。每把 key 可命名並設定 credit limit,建議按 App、環境與團隊拆分:開發、測試、production 不共用。key 放環境變數,不能寫進前端或公開 repo;懷疑外洩時立刻刪除並重建。
OpenRouter 支援自己的 SDK,也能以 OpenAI SDK 改 base URL 連線。第一次先用一個便宜模型送固定訊息,確認回傳的 usage、model 與錯誤處理,再加入 streaming、tools 或 fallback。跨模型參數不一定完全一致,正式切換前要用 require_parameters 或自己的測試確認必要功能有被支援。
想看完整程式串接觀念,可搭配 AI API 串接指南;要比較模型能力,先固定同一組案例與評分,不要只在模型列表裡追最新名稱。
免費模型能不能直接做產品?
OpenRouter quickstart 提供 openrouter/free 路由,也有 model slug 加 :free 的免費 endpoint。它適合學習、原型和不敏感的低頻測試,但免費容量、provider 與可用性可能變動,輸出品質也會跟實際被路由的模型不同。
正式產品若承諾穩定延遲、固定模型行為或資料條款,不要把免費路由當唯一依賴。先選明確模型與 provider,設定 fallback 順序、最大價格、超時與失敗回應;若 fallback 會換到另一個模型,也要告知使用者並記錄實際供應端。
費用方面,OpenRouter 表示一般模型價格依底層 provider 傳遞,並提供統一 credits 與用量分析;BYOK 另有請求費規則。模型、供應商與方案會變,採用前回到模型頁與 FAQ 核對,並替 key 設每日或每月上限。
資料隱私要看兩層
第一層是 OpenRouter。官方目前說 prompt 與 response 內容預設不儲存,除非使用者開啟 Private Input & Output Logging,或選擇允許平台使用輸入輸出並取得折扣;token、延遲等 metadata 仍會保存供報表使用。
第二層是實際 provider。每家供應商有自己的 logging、retention 與是否拿 prompt 訓練政策。帳號設定可以拒絕會用資料訓練的 provider;單次請求也能設定 data_collection: "deny"、provider allowlist 或 zdr: true。ZDR 只在有符合條件的 endpoint 時成功,規則太嚴可能回傳沒有可用 provider。
公司導入前,先列出允許模型、允許 provider、資料類型、地區與保存要求。高敏感資料即使設定 ZDR,也要走法務與資安審核;「文件寫不保存」不能替代公司合約與資料流盤點。
路由怎麼設才不會失控?
預設路由會在可用 provider 間平衡,追求 uptime。需要固定行為時,用 order 指定順序、only 限定 provider、allow_fallbacks 決定能否備援、max_price 控成本,並用 require_parameters 避免被送到不支援必要參數的端點。
團隊可用 Guardrails 限制 model/provider allowlist、budget、ZDR 與敏感資訊;多層規則套用時,官方採更嚴格者優先。詳細的成本與供應商取捨,可延伸看 OpenRouter 模型路由與成本分析 和 AI 成本優化。
常見問題
OpenRouter 是免費的嗎?
有免費模型與 openrouter/free 路由,但容量、模型與可用性可能變動。付費模型從 credits 扣款;BYOK、手續費與模型價格請以最新 FAQ 與模型頁為準。
OpenRouter 和直接用 OpenAI/Anthropic API 差在哪?
直接 API 的供應商、帳務與資料路徑較單純;OpenRouter 提供統一介面、多模型比較、provider routing 與 fallback。若只用一家模型且合規要求嚴格,直接 API 可能更好管理。
OpenRouter 會保存我的 prompt 嗎?
官方目前說內容預設不儲存,除非你另行開啟 logging 或同意平台使用輸入輸出;metadata 仍會保留。實際 provider 另有自己的保存政策,必須一起檢查。
設定 ZDR 就一定不留資料嗎?
ZDR 會限制到標示為 Zero Data Retention 的 endpoint;若沒有符合 provider,請求可能失敗。企業仍要確認供應商條款、OpenRouter 設定、資料地區與自身合規要求。