# API Key 与权限

<a id="gateway-access"></a>

<a id="api-key-与权限"></a>

## 接口说明

在 [API 密钥](/api-keys) 页面为不同应用创建密钥，按需设置模型分组、累计消费上限、有效期和模型价格保护。所有密钥共享账户余额。不选分组可调用全部可用模型；选择分组后，模型列表与调用权限都限定在该分组内。

分组内的模型随管理员配置实时变化。调用组外模型返回 HTTP 403，OpenAI 兼容接口错误码为 `model_not_allowed`，不会扣费；空分组或已删除的分组没有可用模型，可在密钥编辑中重新选择或取消分组限制。

OpenAI 接口使用 `Authorization: Bearer YOUR_API_KEY`；Messages 也接受 `x-api-key`，Gemini 也接受 `x-goog-api-key`。密钥列表支持显示和复制完整值，脱敏预览不能用于调用。可用模型及协议以携带该密钥请求 `GET /v1/models` 的结果为准。

模型价格保护：图片按每张价格，视频按分辨率和时长计算的单次总价，按次文本按调用价格检查；按 token 文本可分别限制输入、输出和各类缓存单价（积分 / 百万 token），全部长上下文阶梯均须满足上限。未设置的模型或留空项不限价，0 仅接受免费调用，等于上限允许调用。超价返回 HTTP 400，错误码 `price_limit_exceeded`（Gemini 位于 `error.reason`），并附模型、价格项、当前价与上限；不执行请求、不扣费。排队任务提交和执行前均会检查，计费方式变更也会拒绝，需重新设置保护规则。