|

11 月新模型扎堆怎么接?一个入口换型号,账单按通道分开看

11 月新模型扎堆怎么接?一个入口换型号,账单按通道分开看

作者注:2026 年 11 月新模型密集发布。本文说明怎样用一个入口换型号、按端点接入,并把每条通道的账单分开核算。

11 月刚过去三周,Google 已经连发三款 Gemini 4 型号:11 月 10 日发布 Carbon,11 月 12 日发布 Hydrogen,11 月 18 日发布 Neon。图像、编码等方向也陆续有新型号出现在新闻里。对想试新模型的开发者来说,麻烦不在于写不出调用代码,而在于每家各有一套 SDK、一套鉴权和一套计费口径。本文给出一套更省事的做法:一个入口换型号,账单按通道分开看。

这不是一份”新模型全家桶”的宣传清单。新闻里出现的型号和平台上已经能调用的型号,本文会分开写。比如新闻里的 MAI Image 2.7 目前还没有进入 API易 的货架,文中不会把它当作可调用模型。

核心价值:读完本文,你会知道先去哪里对型号列表,怎样决定换哪一个模型 ID,每类模型该走哪个端点,以及如何避免用一家模型的单价去估算整张账单。下文涉及的型号与价格,均以 API易 apiyi.com 在 2026-11-20 的型号列表和定价接口为准。

november-new-models-one-endpoint-switch-model-billing-by-channel-image-0


11 月新模型接入核心要点

新模型密集上线时,最容易出错的环节集中在三处:把新闻型号当成已上架型号,用错端点,以及用一个单价估算全部成本。下表把这三处和对应做法放在一起。

要点 说明 价值
先对型号列表 以平台总表和定价接口为准,新闻型号与可调型号分开记 避免拿着发布会上的型号名直接调用,结果报错
换型号=换模型 ID+核对端点 同一个 base_url 下改 model 参数,再确认走 chat、messages、responses 还是 gemini 不必为每家厂商各写一套 SDK
账单按通道分开看 每个模型、每个端点单独记录输入、输出和缓存读 token 单价相差数倍的模型不会被平均到一起,成本可追溯
介绍价有截止日 部分新型号有限时介绍价,到期后官方标准价会变化 提前预估下个月预算,不被涨价打乱计划

新模型接入重点详解:新闻型号 ≠ 货架型号

接入的第一步是查货架,不是写代码。API易 的模型总表地址是 docs.apiyi.com/models.md,本文参考的版本更新于 2026-11-19 10:59(UTC+8)。另有一个机器可读的定价接口 https://api.apiyi.com/api/pricing,版本标识为 shell-api-modelmak-v1。两者更新节奏可能不同步,比如 gemini-4-neon 在这一版总表里还没有出现,但定价接口里已经有完整的价格字段。因此判断”能不能调”时,建议总表和定价接口两处都查,任意一处有记录,再用一次小请求确认。

反过来的情况同样要留意。MAI Image 2.7 是近期新闻里的图像型号,但 API易 当前的总表和定价接口里只有 MAI-Image-2.6 和 MAI-Image-2.6-Flash,没有 2.7。也就是说,MAI Image 2.7 暂未上架,我们会尽快上架这个模型,届时型号与价格以平台型号列表为准。另外,Kling、Muse、gemini-4-flash-lite 目前在总表和定价接口里都查不到,规划方案时不要把它们算进来。

november-new-models-one-endpoint-switch-model-billing-by-channel-image-1

11 月新型号与货架状态对照

下表把 11 月新闻中提到的型号和 2026-11-20 的货架状态逐一对应。表中只写资料中能核实的信息,没有核实到的不做推测。

型号 新闻信息 API易 货架状态(2026-11-20) 模型 ID
Gemini 4 Carbon 2026-11-10 发布,面向长程难任务 总表与定价接口可查 gemini-4-carbon
Gemini 4 Hydrogen 2026-11-12 发布,速度快的日常档 总表与定价接口可查 gemini-4-hydrogen
Gemini 4 Neon 2026-11-18 发布,能力居中 定价接口已有,本版总表未列出 gemini-4-neon
Gemini 4 Argon — 总表可查 gemini-4-argon
MAI Image 2.7 新闻中的图像型号 暂未上架,会尽快上架 以平台列表为准
MAI Image 2.6 / 2.6 Flash — 可查,按次计费 MAI-Image-2.6 / MAI-Image-2.6-Flash

Gemini 4 三档的定位可以简单理解为:Carbon 偏重长链路、难度高的任务,Hydrogen 追求速度、适合高频日常调用,Neon 介于两者之间。选型时先按任务难度挑档位,再看价格,这样比直接挑最便宜的更稳。


11 月新模型快速上手:一个入口换型号

极简示例:改两个参数就能换型号

API易 提供 OpenAI 兼容接口,接入新模型时,大部分改动只有两处:base_url 和 model。以 OpenAI 官方 Python SDK 为例,最小步骤如下:

  1. 安装 SDK:pip install openai
  2. 创建客户端:client = openai.OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1")
  3. 发起对话:client.chat.completions.create(model="gemini-4-hydrogen", messages=[{"role": "user", "content": "Hello!"}])
  4. 读取结果:response.choices[0].message.content

想从 Hydrogen 换到 Carbon,只需把 model="gemini-4-hydrogen" 改成 model="gemini-4-carbon",客户端、鉴权和消息结构都不用动。这就是”一个入口换型号”的含义:换模型通常是换模型 ID 并核对端点,不需要每家各写一套 SDK。

查看完整接入思路(含端点切换与通道记账)

完整项目里,建议把”模型 ID → 端点”的映射放进配置,而不是散落在代码里:

1. 定义配置项 `MODEL_ROUTES`,每条记录包含 `model`、`endpoint`、`price_key` 三个字段,例如 `gemini-4-neon` 对应 `chat`,`claude-fable-5-2` 对应 `messages`,`gpt-6.2-astra` 对应 `responses`。
2. 封装 `call_model(model, prompt)` 函数:按 `endpoint` 分别调用 `client.chat.completions.create`、`client.responses.create`,或用 Anthropic SDK 以 Messages 格式请求(base_url 同上)。
3. 每次请求返回后,从响应的 `usage` 字段读取输入、输出、缓存 token,按 `model+endpoint` 作为通道键写入本地账本。
4. 每天定时请求一次定价接口,按 `model_ratio`、`completion_ratio`、`cache_ratio` 换算单价,再乘以账本中的 token 数,得到每条通道的预估费用。
5. 调用失败时记录 `model` 与错误信息。如果提示模型不存在,先回头核对型号列表,不要盲目重试。

这样新模型上架后,只需在 `MODEL_ROUTES` 里加一行配置,业务代码不用改。

🚀 快速开始建议:先在 API易 apiyi.com 注册并领取新用户免费测试额度,用 Hydrogen 这类日常档跑通链路,再换 Neon、Carbon 对比效果。整个过程只需要一个 API Key。

新模型端点对照:别把所有型号都塞进 chat

“一个入口”不等于”一个端点”。已能调用的文本型号,各自支持的端点不同,换型号时这一步必须核对:

模型系列 模型 ID 示例 可用端点 说明
Gemini 4 系列 gemini-4-carbon / gemini-4-neon / gemini-4-hydrogen chat 或 gemini chat 即 OpenAI 兼容的 /v1/chat/completions;gemini 为 Gemini 原生格式,具体路径以平台文档为准
Claude Fable 5.2 claude-fable-5-2 / claude-fable-5-2-thinking chat 或 messages messages 为 Anthropic 风格的 /v1/messages
GPT-6.2 Astra gpt-6.2-astra 推荐 responses 推荐走 /v1/responses
MAI Image 2.6 MAI-Image-2.6 / MAI-Image-2.6-Flash 图像生成 按次计费,调用方式以平台文档为准

实际使用中,如果团队已有大量基于 chat 格式的代码,Gemini 和 Claude 可以先沿用 chat 端点,迁移成本最低。需要用到厂商原生能力时,再切换到 gemini 或 messages 端点。GPT-6.2 Astra 则建议直接按 responses 端点接入,不要因为习惯而硬套 chat。


11 月新模型账单:按通道分开看

先学会读定价接口

API易 的定价接口用倍率表示价格,换算规则如下:

  • 输入单价 = model_ratio × 2(单位:美元/百万 token,model_ratio 为 1 时等于 $2 / 1M)
  • 输出单价 = 输入单价 × completion_ratio
  • 缓存读单价 = 输入单价 × cache_ratio

以 gemini-4-neon 为例,定价接口给出 model_ratio 1.5、completion_ratio 5、cache_ratio 0.05,换算后输入为 $3 / 1M,输出为 $15 / 1M,缓存读为 $0.15 / 1M,与 Google 的标价一致。掌握这个换算方法后,新模型一上架,你就能自己从 https://api.apiyi.com/api/pricing 算出单价,不必等文章更新。

各通道价格对照(2026-11-20 核对)

november-new-models-one-endpoint-switch-model-billing-by-channel-image-2

📊 数据来源说明:上图与下表的价格取自 API易 apiyi.com 模型总表和定价接口,核对日期为 2026-11-20,后续调整以平台实时列表为准。

通道(模型 ID) 输入 缓存读 输出 备注
gemini-4-hydrogen $1.5 / 1M $0.075 / 1M $7.5 / 1M 日常快档
gemini-4-carbon $2 / 1M $0.1 / 1M $10 / 1M 对应 Google 截至 2026-11-30 的介绍价
gemini-4-argon $2 / 1M $0.1 / 1M $10 / 1M 取自总表
gemini-4-neon $3 / 1M $0.15 / 1M $15 / 1M 取自定价接口
claude-fable-5-2 / -thinking $8 / 1M $0.2 / 1M $40 / 1M 两个 ID 价格相同
gpt-6.2-astra(首档) $8 / 1M $0.4 / 1M $40 / 1M 超过 272000 token 见下文
MAI-Image-2.6 按次 $0.12 — — 图像
MAI-Image-2.6-Flash 按次 $0.06 — — 图像

表里有两处需要单独说明。

第一处是 GPT-6.2 Astra 的长上下文阶梯。总表写的是超过 272000 token 时输入变为 $16 / 1M;定价接口则进一步给出,超过 272000 token 时输出按 $60 / 1M、缓存读按 $0.8 / 1M 计算。如果你的业务会塞入超长上下文,务必按阶梯分开估算,不要用首档价格套全部请求。

第二处是 Gemini 4 Carbon 的介绍价。目前的价格对应 Google 截至 2026-11-30 的介绍价,Google 从 12 月 1 日起的标准价为输入 $4 / 1M、输出 $20 / 1M。平台后续价格以 API易 型号列表为准,做 12 月预算时建议预留这部分差额。

为什么不能用一家单价概括全部

从上表可以看出,同样是百万 token 输出,Hydrogen 是 $7.5,Claude Fable 5.2 和 GPT-6.2 Astra 首档是 $40,相差五倍多。如果团队同时跑三四个模型,只看一个”平均单价”或某一家的单价,很容易严重低估或高估成本。更稳妥的做法是以”模型 ID+端点”作为通道键,每条通道单独记录输入、输出、缓存读 token,分别乘以各自单价,最后再汇总。

还要注意,统一入口解决的是接入成本,不等于每个模型都一定更便宜。上表中多个 Gemini 4 型号的价格与 Google 标价一致。是否划算,应当按通道逐一和你的实际用量对比,而不是一概而论。

💰 成本建议:做选型对比时,可以在 API易 apiyi.com 用同一批测试样本分别调用 Hydrogen、Neon 和 Carbon,再按通道记下 token 消耗,算出每条通道的真实单次成本,然后决定主力模型。


常见问题 FAQ

Q1:什么叫“一个入口换型号”?

就是所有模型共用同一个 base_url 和同一个 API Key。切换模型时改 `model` 参数中的模型 ID,并核对该模型支持的端点即可,不需要为每家厂商单独注册、单独接 SDK。

Q2:新闻里刚发布的模型,能直接调用吗?

不一定。发布不等于上架。以 2026-11-20 为例,MAI Image 2.7 只出现在新闻里,API易 货架上只有 `MAI-Image-2.6` 和 `MAI-Image-2.6-Flash`,2.7 暂未上架,会尽快上架。调用前先查总表和定价接口,确认模型 ID 存在再接入。

Q3:Gemini 4 的 Carbon、Hydrogen、Neon 该怎么选?

按任务难度选档位:长链路、高难度任务用 Carbon;高频、追求速度的日常调用用 Hydrogen;介于两者之间的用 Neon。三款分别于 11 月 10 日、12 日、18 日发布,价格也各不相同,建议用同一批样本对比后再定主力。

Q4:总表里查不到 gemini-4-neon,是不是还不能用?

不能只看总表。2026-11-19 的总表版本里没有 `gemini-4-neon`,但定价接口已经给出了完整倍率,换算后为输入 `$3 / 1M`、输出 `$15 / 1M`、缓存读 `$0.15 / 1M`。两处信息存在时间差,以定价接口和实际小额测试结果为准。

Q5:如何通过 API 快速调用这些 11 月新模型?

建议按以下步骤操作:

1. 在 API易 apiyi.com 注册账号,获取 API Key 和新用户免费测试额度
2. 查模型总表与定价接口,确认目标模型 ID
3. 把 base_url 设为平台的 OpenAI 兼容地址,按上文端点对照表选择 chat、messages、responses 或 gemini
4. 先发一次短请求,确认可用后再接入业务

Q6:同一个 Claude Fable 5.2,走 chat 和走 messages 价格不一样吗?

参考资料里 `claude-fable-5-2` 与 `claude-fable-5-2-thinking` 的价格相同,均为输入 `$8 / 1M`、缓存读 `$0.2 / 1M`、输出 `$40 / 1M`,资料中没有按端点区分价格。不过记账时仍建议把端点作为通道键的一部分,便于排查问题和后续核对。

Q7:统一入口一定比直连官方便宜吗?

不能这么下结论。统一入口的主要价值是少接几套接口、统一鉴权和计费入口。价格要按通道逐一看,比如 `gemini-4-neon` 的价格与 Google 标价一致。是否更省,取决于你使用的模型组合和用量,需要自己按通道核算。

Q8:有哪些已知的限制需要提前规划?

主要有三点。第一,部分新型号尚未上架,例如 MAI Image 2.7、Kling、Muse、`gemini-4-flash-lite` 目前都查不到。第二,介绍价有截止日,Gemini 4 Carbon 对应的 Google 介绍价截至 11 月 30 日。第三,GPT-6.2 Astra 超过 272000 token 后按阶梯计价。遇到这些情况,先按平台列表调整方案,再回头改代码。


11 月新模型接入核心要点 Key Takeaways

  • 先查货架再写代码:以模型总表和定价接口为准,新闻型号与可调型号分开记录
  • 换型号只改两处:同一 base_url 下修改模型 ID,再核对端点类型
  • 端点要对号入座:Gemini 走 chat 或 gemini,Claude 走 chat 或 messages,GPT-6.2 Astra 推荐 responses
  • 会读倍率就会算价:model_ratio × 2 即输入单价,再乘以输出、缓存倍率
  • 账单按通道拆开:以“模型 ID+端点”为键单独记账,不用一家单价套全部
  • 留意截止日与阶梯:Carbon 介绍价、Astra 的 272000 token 阶梯都会影响预算
  • 上手路径:在 API易 用一个 Key 领取免费额度,先跑日常档,再横向对比

总结:11 月新模型扎堆,一个入口换型号,账单按通道分开看

11 月新模型扎堆时,接入的关键不是追每一条新闻,而是建立一套固定流程:

  1. 对型号列表:总表和定价接口两处都查。新闻里的 MAI Image 2.7 暂未上架,不要写进上线计划。
  2. 换模型 ID、核对端点:一个 base_url 搞定多家模型,按端点对照表选择 chat、messages、responses 或 gemini。
  3. 按通道看账单:每个模型、每个端点单独核算 token 和费用,同时留意介绍价截止日和长上下文阶梯。

流程一旦固定,下次再有新模型发布,你只需在配置里加一行模型 ID,查一次定价接口,就能完成接入与成本评估。推荐在 API易 apiyi.com 用新用户免费额度先跑通一条通道,再逐步把 Gemini 4、Claude Fable 5.2、GPT-6.2 Astra 加入对比。


📚 参考资料

  1. Google 官方博客 – Gemini 4 Neon 发布公告:Gemini 4 系列型号介绍

    • 链接: blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon
    • 说明:了解 Carbon、Hydrogen、Neon 的定位与发布时间
  2. API易 模型总表与定价接口:型号与价格核对来源

    • 链接:见正文“新闻型号 ≠ 货架型号”一节
    • 说明:总表与定价接口版本可能不同步,建议两处对照查看

作者: APIYI 技术团队
技术交流:欢迎在 API易 网站首页联系我们,更多接入文档可访问 docs.apiyi.com 文档中心

延伸阅读

类似文章