# 鉴权与密钥 (/docs/authentication)

**所有 API 调用使用 Bearer Token 鉴权，密钥挂在组织（org）上，成员共享组织密钥池。**

## 请求头 [#请求头]

```txt
Authorization: Bearer lgr_live_xxxxxxxx
X-Org-Id: <可选，仅平台密钥需要>
```

## 密钥模型 [#密钥模型]

| 属性 | 说明 |
|---|---|
| `key_prefix` | 密钥只存前 12 位用于展示与检索，完整密钥创建时唯一可见 |
| `scopes` | 逗号分隔的能力域：`search` `read` `watch` `compute` `draft` |
| `expires_at` | 可选 ISO 8601 日期，到期自动失效 |
| `rpm` / `daily_cap` | 每分钟请求数上限 / 单日点数上限 |

## 创建与管理 [#创建与管理]

密钥的创建、吊销、用量查看都在控制台完成（**API 密钥** 页）。管理操作不开放公开 API —— 密钥生灭必须走人工可审计的面板。

## 限速与错误 [#限速与错误]

| 状态码 | 含义 | 对策 |
|---|---|---|
| `401` | 密钥无效或已吊销 | 控制台确认密钥状态 |
| `403` | scope 不足 | 该密钥未授予对应能力域 |
| `429` | 触发 RPM / daily_cap | 响应带 `Retry-After`，按秒等待 |

<Callout type="warning" title="安全约定">

密钥即身份。不要放在前端代码、Git 仓库或日志里；泄露后在控制台**立即吊销**并新建 —— 吊销是即时生效的。

</Callout>