跳转到主要内容
密钥是每个请求携带的身份。在它的生命周期内，你创建它、 也许在一次事故中暂停它、并最终退役它。本页在控制台中走完 整个生命周期——这是管理 api 密钥最快的方式，无需触碰代码 或重新部署任何东西。 关于一个密钥携带的全套约束（模型允许列表、IP 允许列表、 花费上限、策略附加项），参见 令牌对象 和 绑定策略到密钥。本页讲的是 生命周期：创建 → 禁用 → 吊销。
所有这三项操作都在控制台的 Keys 界面 （/console/token）中。创建、编辑、禁用或删除一个密钥需要 Developer 角色或以上；任何角色（Viewer 及以上）都可以 读取列表。

​
1. 创建一个密钥

一个新密钥生来就是限定范围的。与其铸造一份宽泛的凭据并 共享它，不如给每个智能体或服务它自己的、带有恰好所需限制的 密钥——这正是让一个被攻陷智能体的影响半径保持微小的关键 （参见 最小权限检查清单）。 在控制台中，打开 Keys → New key 并设置：
一个人类可读的名称，以及一个自由格式的 environment 标签 （prod、staging、dev，或任何你喜欢的），你之后可以 据此过滤日志。参见 环境。
模型允许列表、IP 允许列表、一个 USD 花费上限，以及一个 到期——每一项都是可选的，每一项都缩小密钥能做的事。参见 模型限制、 IP 允许列表 和 配额上限与到期。
一个防护栏（guardrail_id）和一个防火墙策略 （firewall_policy_id），用于治理该密钥的内容和工具调用。 参见 绑定策略。
明文密钥（sk-orca-…）在创建时恰好显示一次。 那时就复制它。此后控制台只会显示掩码形式。你之后可以重新 揭示一个普通密钥的明文（Developer+），但一个网关限定密钥 的明文需要 Admin——所以第一次就把它保存到安全的地方。
像使用任何 OrcaRouter 密钥一样，用这个新密钥进行推理： 
curl https://api.orcarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-4o-mini", "messages": [{"role":"user","content":"ping"}]}'
只有 /v1/* 中继调用使用 sk-orca-… 密钥。本页上的控制台操作 运行在你的会话 / 访问令牌上，而非中继密钥。

​
2. 禁用一个密钥（可逆的暂停）

当一个密钥行为异常时——一个失控循环、一份你仍在调查的泄露 凭据、一个你正在下线维护的服务——你不必删除它。禁用会把 密钥的状态翻转为关闭，于是它发出的每个请求都被拒绝，而密钥 本身、它的限制、它的策略附加项以及它的使用历史全部保持完好。 在 Keys 列表中，把密钥的状态切换为 Disabled。之后要重新 启用它，再切换回来即可。一个密钥可以处于以下状态之一：
状态含义
Enabled活跃；请求被授权。
Disabled被你暂停；请求被拒绝直至重新启用。
Expired超过其 expired_time；自动到达。
Exhausted触及其配额 / 花费上限；自动到达。
禁用是你的事故响应暂停按钮。如果你怀疑某个密钥被攻陷，但想 在深入调查时保留它的配置和日志，先禁用并调查——然后要么重新 启用、要么吊销。参见 泄露密钥响应。
Expired 和 Exhausted 是自行到达的——一个超过其 到期 或超出其 花费上限 的密钥会停止授权， 无需你采取任何动作。

​
3. 吊销一个密钥（永久）

当一个密钥完成使命时——智能体被退役、凭据被确认泄露、项目 已交付——通过删除它来吊销它。这是永久的：该凭据再也无法 授权任何请求，而且一个被删除的密钥不可恢复。任何替换都请 签发一个全新密钥。 在 Keys 列表中，对该密钥选择 Delete（Developer+）。要一次 清理多个，选中它们并作为一批删除。
禁用可逆；删除不可逆。 如果有任何可能你还会再次需要这个 密钥——或它的配置与历史——那就改为禁用它。只有当你确定该 凭据应当不复存在时才删除。对于一次已确认的泄露，立即删除可 永久切断该凭据；禁用则为你争取时间先行调查。

​
4. 重新揭示与轮换

一个密钥的明文在创建之后于控制台中处处被掩码。一个 Developer+ 可以按需重新揭示一个普通密钥的明文；重新揭示 一个网关限定密钥（is_firewall_gateway）需要 Admin。 轮换是安全交接模式：创建替换密钥、把你的流量迁移到它上面、 然后禁用（并随后删除）旧的那个——这样就永远不会出现没有 可用密钥的窗口。完整的逐步流程见于 密钥轮换。

​
5. 谁能做什么

每个生命周期操作都对照你的活跃工作区进行角色门控：
操作最低角色
查看密钥列表Viewer
创建 / 编辑 / 禁用 / 删除一个密钥Developer
重新揭示一个普通密钥的明文Developer
启用 is_firewall_gateway，或读取网关密钥的明文Admin
工作区限定意味着在一个工作区中创建的密钥从另一个工作区永远 不可见也不可用。关于密钥、策略和工作区如何嵌套，参见 范围与密钥。

​
6. 下一步

令牌对象

密钥携带的每个字段，以及每一个约束什么。

绑定策略到密钥

附加一个防护栏和一个防火墙策略，使密钥的流量受到治理。

密钥轮换

从旧密钥到新密钥的零停机交接。

泄露密钥响应

你怀疑一个密钥暴露的那一刻该做什么。
这个生命周期刻意保持简单：创建得狭窄、用禁用来暂停、用删除来 吊销。每个密钥越狭窄、你越能更快地暂停或退役它，任何单个 智能体被攻陷时的影响半径就越小。