权限与模型范围
为什么某些模型不可用
返回 MODEL_NOT_ALLOWED 说明你的套餐或这把 Key 无权访问该模型。由三层决定:
- 你的订阅套餐:每个模型要求一个访问档(
FREE/PAID/TRUSTED/ENTERPRISE), 套餐授予你若干档位。关键在于,套餐给 Playground 和 API Key 的档位是不同的:Starter 的 Playground 能用全部公开模型,而它签发的 API Key 只能调免费模型。见 订阅套餐。 - Key 自身的可用模型列表:创建 Key 时选定。不在列表内的模型即使套餐允许也会被拒。
- 按用户覆盖:管理员可针对某个账号单独 允许(ALLOW) 或 拒绝(DENY) 某个模型, 用于白名单或灰度。
钱包中仍有注册赠金时,付费模型会被临时解锁供你试用;赠金用尽后恢复限制。
权限在数据面强制执行
Key 的可用模型范围会下发到网关,因此在请求体里改 model 无法绕过——调用在到达 provider
之前就被拒绝,且不产生任何费用。
端点必须与模型匹配
每个模型只属于一个 API Surface。用错端点调用(例如把 embeddings 模型发给
/v1/chat/completions)会在调用 provider 前返回 model_api_surface_mismatch。见
模型总览。
内测模型
INTERNAL_BETA 模型对普通用户隐藏,仅白名单账号可用,也不会出现在公开模型目录中。