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

分组、模型名与自动路由

客户真正需要理解的产品边界:Key 绑哪个分组、该用什么模型名、平台如何自动切路由

这一页只回答三个问题:

  1. 我该买哪个分组?
  2. 我代码里该写什么模型名?
  3. 上游挂了以后,我要不要改代码?

一把 Key 只属于一个分组

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

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

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

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

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

分组协议与推荐客户端代表模型倍率适合场景
GPT混合池子OpenAI 兼容客户端gpt5.5gpt5.4gpt5.4-minigpt5.3-codexgpt-image-20.2追求性价比、日常大量调用
GPT纯血ProOpenAI 兼容客户端gpt5.5gpt5.4gpt5.4-minigpt5.3-codexgpt-image-20.5更看重稳定性与质量的一般 GPT 任务
按次计费OpenAI 兼容客户端claude-opus-4.6claude-opus-4.7gemini-3.1-pro-previewgemini-3-flash-previewgrok-4.20-0309-reasoning1需要 Claude / Gemini / Grok 混合使用
ClaudeMax满血版Claude Code / Anthropic 客户端优先claude-haiku-4.5claude-opus-4.5claude-opus-4.6claude-opus-4.7claude-sonnet-4.62.6主要给 Claude Code 和 /v1/messages 用户

实际可用模型,请始终以控制台或 GET /v1/models 返回结果为准。
页面里的模型名是当前常见值,不代表未来永远不变。

统一模型名:按 Fuel 返回的名字调用

Fuel 对外只暴露统一映射后的模型名

这意味着:

  • 你在代码里写的是 Fuel 的模型名
  • 平台内部如何映射到不同上游,是平台自己的事
  • 你不需要为了不同供应商改模型名

正确示例

  • gpt5.5
  • gpt5.4
  • gpt5.3-codex
  • claude-opus-4.7
  • gemini-3.1-pro-preview

不建议的做法

  • 使用供应商原始别名
  • 依赖某个历史兼容名称
  • 看到上游报错后,自己猜测另一个模型名去重试

最稳的做法只有一个:先调 GET /v1/models,按返回名调用。

自动路由:上游切换不需要你改代码

Fuel 会在分组内部做自动路由和故障切换。

从客户视角看,你只需要保证:

  • Base URL 不变
  • API Key 不变
  • 模型名使用 Fuel 的统一模型名

如果某个上游临时不可用,平台会尽量在同分组内切到别的可用上游。
这正是统一模型名的价值:切路由时你不用改代码。

怎么选最省心

  • 你主要跑 GPT:优先 GPT混合池子GPT纯血Pro
  • 你要混合跑 Claude / Gemini / Grok:选 按次计费
  • 你是 Claude Code 用户,或者你的客户端就是 Anthropic 协议:选 ClaudeMax满血版

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

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

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

On this page