MagicCore 文档
Fuel(OpenAI 兼容 API)IP-SaaS(住宅/数据中心代理)图像工作台(Image Studio)视频工厂(Video Factory)

分组、模型名与自动路由

客户真正需要理解的边界:Key 绑哪个分组、该用什么模型名、推荐用哪种请求格式

这一页只回答三个问题:

  1. 我该买哪个分组?
  2. 我代码里该写什么模型名?
  3. 我该用哪种请求格式?

一把 Key 只属于一个分组

Fuel 不是“一个 Key 通吃所有模型”。

你创建 Key 时,会把这把 Key 绑定到一个分组。之后:

  • GET /v1/models 返回的模型列表,会跟着这把 Key 的分组变化
  • 能不能调用某个模型,先看这把 Key 所在分组
  • 计费倍率,也先看这把 Key 所在分组

如果你同时需要 GPT 和 Claude,推荐直接创建两把 Key,而不是让一把 Key 承担所有用途。

当前面向客户开放的 5 个分组

分组推荐请求方式代表模型倍率适合场景
GPT混合池子文本优先 responses;图片走 images/generationsgpt5.5gpt5.4gpt5.4-minigpt5.3-codexgpt-image-20.2追求性价比、日常大量调用
GPT纯血Pro文本优先 responses;图片走 images/generationsgpt5.5gpt5.4gpt5.4-minigpt5.3-codexgpt-image-20.4更看重稳定性与质量的一般 GPT 任务
Claude按次计费responsesmessagesclaude-opus-4.7claude-sonnet-4.61需要 Claude,但不限定 Claude Code 客户端
Gemini/Grok按次计费文本走 responseschat/completionsgemini-3.1-pro-previewgemini-3-flash-previewgrok-4.20-0309-reasoning-supergrok-4.20-0309-non-reasoning1主要跑 Gemini / Grok
ClaudeMax满血版仅限 Claude Code 客户端的 messagesclaude-opus-4.7claude-sonnet-4.62.2Claude 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.5
  • gpt5.4
  • gpt5.3-codex
  • claude-opus-4.7
  • gemini-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纯血ProPOST /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

如果你拿不准,最简单的验证方式是:

  1. 先建目标分组的 Key
  2. 调一次 GET /v1/models
  3. 看你要的模型是否在返回列表里

这比任何口头判断都更准。

On this page