分组、模型名与自动路由
客户真正需要理解的边界:Key 绑哪个分组、该用什么模型名、推荐用哪种请求格式
这一页只回答三个问题:
- 我该买哪个分组?
- 我代码里该写什么模型名?
- 我该用哪种请求格式?
一把 Key 只属于一个分组
Fuel 不是“一个 Key 通吃所有模型”。
你创建 Key 时,会把这把 Key 绑定到一个分组。之后:
GET /v1/models返回的模型列表,会跟着这把 Key 的分组变化- 能不能调用某个模型,先看这把 Key 所在分组
- 计费倍率,也先看这把 Key 所在分组
如果你同时需要 GPT 和 Claude,推荐直接创建两把 Key,而不是让一把 Key 承担所有用途。
当前面向客户开放的 5 个分组
| 分组 | 推荐请求方式 | 代表模型 | 倍率 | 适合场景 |
|---|---|---|---|---|
GPT混合池子 | 文本优先 responses;图片走 images/generations | gpt5.5、gpt5.4、gpt5.4-mini、gpt5.3-codex、gpt-image-2 | 0.2 | 追求性价比、日常大量调用 |
GPT纯血Pro | 文本优先 responses;图片走 images/generations | gpt5.5、gpt5.4、gpt5.4-mini、gpt5.3-codex、gpt-image-2 | 0.4 | 更看重稳定性与质量的一般 GPT 任务 |
Claude按次计费 | responses 或 messages | claude-opus-4.7、claude-sonnet-4.6 | 1 | 需要 Claude,但不限定 Claude Code 客户端 |
Gemini/Grok按次计费 | 文本走 responses 或 chat/completions | gemini-3.1-pro-preview、gemini-3-flash-preview、grok-4.20-0309-reasoning-super、grok-4.20-0309-non-reasoning | 1 | 主要跑 Gemini / Grok |
ClaudeMax满血版 | 仅限 Claude Code 客户端的 messages | claude-opus-4.7、claude-sonnet-4.6 | 2.2 | Claude Code 重度用户 |
实际可用模型,请始终以控制台或
GET /v1/models返回结果为准。
页面里的模型名是当前常见值,不代表未来永远不变。图片模型边界:只有
GPT混合池子与GPT纯血Pro支持gpt-image-*和POST /v1/images/generations。其他分组不支持图片模型。ClaudeMax 满血版限制:该分组只允许 Claude Code 客户端调用(按客户端 UA 识别)。普通 OpenAI / Anthropic SDK 调它会被拒绝。如果你不是 Claude Code 用户,请改用
Claude按次计费。
统一模型名:按 Fuel 返回的名字调用
Fuel 对外只暴露统一映射后的模型名。
这意味着:
- 你在代码里写的是 Fuel 的模型名
- 平台内部如何映射到不同上游,是平台自己的事
- 你不需要为了不同供应商改模型名
正确示例
gpt5.5gpt5.4gpt5.3-codexclaude-opus-4.7gemini-3.1-pro-preview
不建议的做法
- 使用供应商原始别名
- 依赖某个历史兼容名称
- 看到上游报错后,自己猜测另一个模型名去重试
最稳的做法只有一个:先调 GET /v1/models,按返回名调用。
我该用哪种请求格式
最简单的记法:
- 你用 OpenAI SDK:优先
POST /v1/responses - 你用旧聊天客户端:看
POST /v1/chat/completions - 你用 Claude Code / Anthropic SDK:看
POST /v1/messages - 你做图片生成:只有
GPT混合池子/GPT纯血Pro用POST /v1/images/generations
如果你不确定,就先看:
自动路由:上游切换不需要你改代码
Fuel 会在分组内部做自动路由和故障切换。
从客户视角看,你只需要保证:
- Base URL 不变
- API Key 不变
- 模型名使用 Fuel 的统一模型名
如果某个上游临时不可用,平台会尽量在同分组内切到别的可用上游。
这正是统一模型名的价值:切路由时你不用改代码。
怎么选最省心
- 你主要跑 GPT:优先
GPT混合池子或GPT纯血Pro - 你要跑
gpt-image-*图片模型:也只能选GPT混合池子或GPT纯血Pro - 你要跑 Claude(任意客户端都行):选
Claude按次计费 - 你要跑 Gemini / Grok:选
Gemini/Grok按次计费 - 你是 Claude Code 客户端用户:选
ClaudeMax满血版(注意此分组只允许 Claude Code)
如果你拿不准,最简单的验证方式是:
- 先建目标分组的 Key
- 调一次
GET /v1/models - 看你要的模型是否在返回列表里
这比任何口头判断都更准。