# 创建与管理 API Key 在控制台左侧独立的 [API Keys](https://hostanagent.com/console/#/api-keys) 页面签发和管理服务端应用 Key，入口位于“接入”旁边。“接入”页的“管理 API Keys”也会打开这里。Key 属于当前账号的内部应用，使用当前账号的钱包；它不是新的用户账号或独立余额。 ## 为文本接入创建受限 Key 1. 先发布目标 Agent，记下 Agent ID。 2. 创建 Key 时选择该 Agent 范围，以及 `runtime:read` 和 `runtime:write`。只读历史只需前者；执行真实工具时另外选 `tools:execute`。 3. 选择有效期。页面默认 90 天；接口允许 1–365 天。保存后**立即复制唯一一次显示的明文**到产品后端的受保护配置。 4. 在产品后端验证身份、读取 `/v1/runtime/bootstrap`，再向有权限的 Agent 发起请求。不要将 Key 放入浏览器、Widget 属性、日志或公开示例。 各 scope 相互独立：`runtime:write` 不自动授予读取，`configuration:write` 也不自动授予 `configuration:read`。限定 Agent 的 Key 不能借配置 scope 读取全局配置或管理其他 Agent。个人钱包、账单、充值与管理员能力不向应用 Key 开放。[权限表](/docs/reference/authentication/)。 ## 轮换、撤销与丢失 轮换会创建继承原范围的新 Key，旧 Key 暂时保持有效，便于先更新产品服务，再单独撤销旧 Key。撤销所选 Key 后，它立即失效，其他 Key 不受影响。最近使用时间是近似活动信息。 明文无法再次读取。签发响应丢失且未保存明文时，在列表中撤销该 Key，再用新的请求号创建；不要使用原请求号期待返回明文。一次性展示窗口关闭后也需这样处理。每账号最多 100 个有效 Key。用户重置密码或关闭账号会撤销全部 Key。[产品后端接入](/docs/integration/backend-auth/)。