**摘要:**OpenRouter 在 2026 年 11 月 16 日由 Sasha Blumenfeld 宣布,管理金鑰不再等同整個組織的完整管理員權限。每把金鑰現在建立時可設定兩件事:作用範圍(單一 workspace 或整個組織)與存取層級(唯讀或讀寫),讓金鑰只做它被建立時要做的的事。所有組織、所有方案即日可用,不需要升級付費方案。
兩個設定決定一把金鑰能做什麼
Scope 決定金鑰在哪裡生效:限縮到某個 workspace 時,只要請求指向另一個 workspace 或屬於它的資源,OpenRouter 一律拒絕。存取層級則決定它能做什麼:唯讀金鑰可以呼叫範圍內的讀取路由,包括 analytics 查詢;任何建立、修改、刪除的請求都會回傳錯誤。
Workspace 範圍內的金鑰可以管理 API keys、成員、guardrails 與 guardrail policies、自己的 provider keys、observability 目的地和 presets,也能讀取該 workspace 的預算、活動紀錄與分析資料。但預算上限、credits 和組織設定仍然留在 Organization Admin 手上——一個團隊可以在自己的 workspace 裡自動化所有事,還是無法調高自己 workspace 的預算。設定 workspace 預算、建立或刪除 workspace、管理組織成員和 private endpoints,依舊需要組織層級的金鑰,用法跟過去一樣。
四種金鑰,對應四種工作
Scope 和存取層級組合出四類金鑰,官方各給了一個例子:
- 為某個團隊建立和輪替 API keys 的 agent:該 workspace 的讀寫金鑰。
- 只看用量的 dashboard:該 workspace 的唯讀金鑰。
- 跨組織的稽核或成本工具:唯讀的組織金鑰。
- 需要建立 workspace 或設定預算的工作:讀寫的組織金鑰。
兩個設定在建立當下就固定,之後不能更改;要調整就得建立新金鑰、刪除舊的。金鑰的用法不變,仍是管理 API 上的 Bearer token:
curl https://openrouter.ai/api/v1/keys \
-H "Authorization: Bearer $MANAGEMENT_KEY"
建立入口在 workspace 的 Keys 頁面的 Management keys 分頁;Workspace Admin 只能替自己的 workspace 建金鑰,Organization Admin 可以替任何 workspace 建。要盤點手上已有的管理金鑰,走 Security settings 的 Key safety,用 Filter keys 選 Show management keys,每把有效的金鑰會列出擁有者、最後使用時間和到期日。
取捨:設定固定,換設定就是換金鑰
最直接的代價是輪替成本。Scope 和存取層級不可更改,意思是權限需求一變,管線裡就要走一遍「建新金鑰、更新變數、刪舊金鑰」的流程。對部署腳本來說這是多一步維護,但對安全而言,金鑰無法事後升權,反而消除了「先給全部權限之後再收窄」常見的遺忘風險。另外,官方文件只說明如何列出有效金鑰,並未提到洩漏偵測、異常告警或自動撤銷機制;一把外流的唯讀金鑰還能讀到哪些分析資料,來源也沒有逐項說明,這是評估殘餘風險時要自己補的假設。
**我們的看法:**手上有多把管理金鑰、或曾經把一把完整管理員金鑰交給 agent 或 CI 的團隊,應該這週就動手遷移:盤點現有金鑰、按工作重建範圍內的替代品、刪掉原始那把,成本是一個下午,而且立即降低「一把金鑰外流就波及所有團隊」的風險。這是我們在先前談 OpenRouter Workspaces 的環境隔離與權限時就期待補上的一塊,如今自動化工具終於能被限制在同一個邊界內。單一 workspace、只留一把金鑰偶爾手動用的個人開發者,可以安全忽略這次更新。會改變這個判斷的情況只有一種:盤點後發現每把金鑰本來就只有單一用途,那麼遷移收益就只剩下唯讀化稽核工具這一部分。
