API Key 与权限
接口说明
在 API 密钥 页面为不同应用创建密钥,按需设置模型分组、累计消费上限、有效期和模型价格保护。所有密钥共享账户余额。不选分组可调用全部可用模型;选择分组后,模型列表与调用权限都限定在该分组内。
分组内的模型随管理员配置实时变化。调用组外模型返回 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),并附模型、价格项、当前价与上限;不执行请求、不扣费。排队任务提交和执行前均会检查,计费方式变更也会拒绝,需重新设置保护规则。