作者注: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 的型号列表和定价接口为准。

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 目前在总表和定价接口里都查不到,规划方案时不要把它们算进来。

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 为例,最小步骤如下:
- 安装 SDK:
pip install openai - 创建客户端:
client = openai.OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1") - 发起对话:
client.chat.completions.create(model="gemini-4-hydrogen", messages=[{"role": "user", "content": "Hello!"}]) - 读取结果:
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 核对)

📊 数据来源说明:上图与下表的价格取自 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 月新模型扎堆时,接入的关键不是追每一条新闻,而是建立一套固定流程:
- 对型号列表:总表和定价接口两处都查。新闻里的 MAI Image 2.7 暂未上架,不要写进上线计划。
- 换模型 ID、核对端点:一个 base_url 搞定多家模型,按端点对照表选择 chat、messages、responses 或 gemini。
- 按通道看账单:每个模型、每个端点单独核算 token 和费用,同时留意介绍价截止日和长上下文阶梯。
流程一旦固定,下次再有新模型发布,你只需在配置里加一行模型 ID,查一次定价接口,就能完成接入与成本评估。推荐在 API易 apiyi.com 用新用户免费额度先跑通一条通道,再逐步把 Gemini 4、Claude Fable 5.2、GPT-6.2 Astra 加入对比。
📚 参考资料
-
Google 官方博客 – Gemini 4 Neon 发布公告:Gemini 4 系列型号介绍
- 链接:
blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon - 说明:了解 Carbon、Hydrogen、Neon 的定位与发布时间
- 链接:
-
API易 模型总表与定价接口:型号与价格核对来源
- 链接:见正文“新闻型号 ≠ 货架型号”一节
- 说明:总表与定价接口版本可能不同步,建议两处对照查看
作者: APIYI 技术团队
技术交流:欢迎在 API易 网站首页联系我们,更多接入文档可访问 docs.apiyi.com 文档中心
