Mafdet AI 帮助中心English

权限与模型范围

为什么某些模型不可用

返回 MODEL_NOT_ALLOWED 说明你的套餐或这把 Key 无权访问该模型。由三层决定:

  1. 你的订阅套餐:每个模型要求一个访问档(FREE / PAID / TRUSTED / ENTERPRISE), 套餐授予你若干档位。关键在于,套餐给 Playground 和 API Key 的档位是不同的:Starter 的 Playground 能用全部公开模型,而它签发的 API Key 只能调免费模型。见 订阅套餐
  2. Key 自身的可用模型列表:创建 Key 时选定。不在列表内的模型即使套餐允许也会被拒。
  3. 按用户覆盖:管理员可针对某个账号单独 允许(ALLOW)拒绝(DENY) 某个模型, 用于白名单或灰度。

钱包中仍有注册赠金时,付费模型会被临时解锁供你试用;赠金用尽后恢复限制。

权限在数据面强制执行

Key 的可用模型范围会下发到网关,因此在请求体里改 model 无法绕过——调用在到达 provider 之前就被拒绝,且不产生任何费用。

端点必须与模型匹配

每个模型只属于一个 API Surface。用错端点调用(例如把 embeddings 模型发给 /v1/chat/completions)会在调用 provider 前返回 model_api_surface_mismatch。见 模型总览

内测模型

INTERNAL_BETA 模型对普通用户隐藏,仅白名单账号可用,也不会出现在公开模型目录中。

下一步