模型与分组
Enodot 通过“分组”把用户 API Key 和后端能力连接起来。
分组决定什么
一个 API Key 通常绑定一个分组。分组会影响:
- 该 Key 能使用的协议。
- 可用模型范围。
- 计费倍率。
- 是否订阅模式。
- 日、周、月额度。
- 是否允许图片生成。
- 是否允许 Claude Code / Codex 类客户端。
- 是否使用 Mixed 聚合路由。
- 失败时是否使用兜底分组。
协议与渠道的区别
Enodot 区分“协议”和“渠道”:
| 类型 | 示例 | 说明 |
|---|---|---|
| 协议 | OpenAI、Anthropic、Gemini | 用户请求使用的 API 格式。 |
| 渠道 | OpenAI、Anthropic、Gemini、Kiro、Windsurf、Antigravity | 网关内部可调度的能力来源。 |
例如,一个 Mixed 分组可以对外同时支持 OpenAI Responses 和 Anthropic Messages;其中 Anthropic Messages 的实际来源可以是 Anthropic 分组,也可以是 Kiro 或 Windsurf 渠道。
模型名称
请求中的 model 字段使用控制台展示的模型名。管理员可能会配置模型映射,把对外模型名映射到实际渠道模型。
调用前建议先查看:
- 控制台“Available Channels”。
/v1/models。- 管理员发布的套餐说明。
模型映射
模型映射适合做兼容迁移。例如:
- 对外保持旧模型名,内部迁移到新模型。
- 不同协议使用统一模型命名。
- 将某些客户端固定发送的模型名映射到可用模型。
如果请求模型不在当前分组可用范围内,可能返回 model_not_found、model_not_entitled 或渠道自定义错误。