Sasha Blumenfeld ·2026年11月16日


管理密钥不再必须拥有对整个组织的完整管理员访问权限。现在,你可以将密钥设为只读、限定其只能访问一个工作区,或两者兼有,这样每个密钥就只能执行其创建时指定的任务。只读密钥可以查看 API 密钥、活动和用量,读写密钥还可以创建、更新和删除 API 密钥。如果密钥泄露或被滥用,损害范围也能得到控制。
现已向所有组织、所有套餐开放。你可以从工作区的 Keys 页面创建密钥,或从 Management API Keys创建,并参阅 management API keys guide 了解每种密钥可以调用哪些路由。

团队各自运行自己的工作区,现在他们的自动化也可以如此
随着组织在 OpenRouter 上发展壮大,他们会将工作拆分到多个工作区,通常每个团队一个。每个团队运行自己的工作区,而组织管理员负责管理大家共享的内容:额度、预算和组织设置。
在此之前,管理密钥始终对整个组织拥有完整的读写权限。想要自动化自己工作区的团队,不得不使用一个也能访问其他所有工作区的密钥。
现在每个密钥有两个设置。 Scope 设定密钥的生效范围:单个工作区,或整个组织。 Access level 设定它在该范围内能做什么:只读,或读写。工作区管理员可以为自己所在的工作区创建密钥,因此部署流水线可以轮换团队的 API 密钥,智能体可以设置防护规则,脚本可以将队友添加到工作区,而它们都无法访问其他团队的工作区。
Scope 将密钥限制在一个工作区内
工作区范围的密钥仅在其所属工作区内有效。如果请求指定了另一个工作区,或指定了属于某个工作区的资源,OpenRouter 会拒绝访问。有缺陷的智能体或泄露的密钥无法触及你组织的其余部分。
在其工作区内,该密钥可以管理 API 密钥、成员、防护规则和防护规则策略、你自己的提供商密钥、可观测性目标以及预设。它可以读取该工作区的预算、活动和分析数据。
预算限制、额度和组织设置仍由你的组织管理员负责。 团队可以自动化其工作区内的一切,但仍无法提高自己工作区的预算。设置工作区预算、创建或删除工作区、管理组织成员以及私有端点仍然需要组织密钥,其工作方式与以往相同。
只读访问让工具只能查看,不能更改任何内容
访问级别是第二个设置,它同样适用于工作区密钥和组织密钥。只读密钥可以调用其范围允许的读取路由,包括分析查询。任何会创建、更改或删除内容的请求都会返回错误。
这适合那些只需要查看的工具。成本仪表板可以拉取用量数据,监控智能体可以观察活动,审计脚本可以列出密钥、防护规则和提供商密钥。你可以接入新的报告或审计工具,而无需授予其对账户的写入权限。
为每个密钥只授予其所需的访问权限
范围与访问级别组合成四种密钥:
- 为一个团队创建并轮换 API 密钥的智能体,会获得该团队工作区的读写密钥。
- 面向单个团队的用量仪表板,会获得该团队工作区的只读密钥。
- 组织范围的审计或成本工具,会获得组织级只读密钥。
- 任何会创建工作区或设置预算限制的工具,都保留组织级读写密钥。
这两个设置在你创建密钥时即固定,因此密钥之后无法获得更多访问权限。要更改其中任一设置,请创建新密钥并删除旧密钥。
在仪表板中创建密钥

- 打开工作区,前往 密钥,然后选择 管理密钥 标签页。工作区管理员可以为自己所在的工作区创建密钥,组织管理员可以为任何工作区创建密钥。
- 点击 新建管理密钥. 对话框会显示该密钥的作用域限定在哪个工作区。
- 输入名称,选择有效期,然后选择 只读 或 读写 ,位于 访问级别.
- 下。密钥显示时请复制。之后你将无法再次看到它。
对于覆盖整个组织的密钥,组织管理员使用 管理 API 密钥 页面。
你的智能体和工具使用该密钥的方式与它们目前使用管理密钥的方式相同,即作为管理 API 上的 Bearer 令牌:
curl https://openrouter.ai/api/v1/keys \
-H "Authorization: Bearer $MANAGEMENT_KEY"
要查看你已有的管理密钥,请打开 安全设置,前往 密钥安全,打开 筛选密钥, 并选择 显示管理密钥. 每个活跃密钥都会列出其所有者、最后使用时间和到期时间。 管理 API 密钥指南 列出了每种密钥可以调用的所有路由。
AI 热点