权限与模型范围
为什么某些模型不可用
当调用返回 MODEL_NOT_ALLOWED 时,说明当前账号或 API Key 没有该模型的访问权限。权限由两层决定:
- 会员等级:每个模型有一个访问等级(FREE / PAID / TRUSTED / ENTERPRISE),你的账号等级决定能访问哪一档。
- 按用户覆盖:管理员可以针对某个账号单独 允许(ALLOW) 或 拒绝(DENY) 某个模型,用于白名单或灰度。
会员等级与模型权限
- FREE:免费试用模型(如
gemini-flash) - PAID / TRUSTED / ENTERPRISE:逐级开放更多/更高价模型
API Key 的 allowed models
API Key 的可用模型范围会同步到底层网关(LiteLLM)。也就是说,即使你在请求里写了某个 model,如果该 Key 无权访问,调用仍会被拒绝。这保证了权限在数据面被强制执行。
内测模型
部分模型(如 Vision / 联网搜索相关)目前为 内测(INTERNAL_BETA),默认对普通用户隐藏,仅管理员或白名单用户可用,见 联网搜索 / Vision。