作者注:最近有人在讨论 Gemini 4 Oxygen。本文只按两份目录判断 Gemini 4 能不能调用:谷歌 AI Studio 公开模型列表和 API易 已上架的型号 ID。文中列出三个能写进 model 字段的名字,以及它们各自的价格、分组和请求路径。
最近关于 Gemini 4 Oxygen 的说法传得很广,不少开发者想知道这个名字今天能不能直接填进接口。判断方法很简单:谷歌公开模型列表里有、API易 型号总表里也有的 ID,才算可用。按这个标准,今天能调用的 Gemini 4 共有三个:gemini-4-carbon、gemini-4-argon、gemini-4-hydrogen。
这不是又一篇传闻汇总。本文不讨论 Oxygen 是否存在,只核对两份目录。截至 2026-11-16,谷歌 AI Studio 的 Gemini 4 模型列表只有三张卡。API易 同日 09:39(UTC+8)的总表也只有这三个 ID。
核心价值:读完本文,你会知道 Gemini 4 的三个 ID 分别对应什么定位、价格多少、有没有半价分组、请求走哪条路径,也能根据任务类型直接选一个。

Gemini 4 核心信息速览
先看结论。下表汇总了 Gemini 4 当前可用状态的关键信息,所有内容均来自谷歌官方页面和 API易 文档,数据日期为 2026-11-16。
| 信息项 | 详情 |
|---|---|
| 发布方 | Google(Gemini 模型系列) |
| 谷歌公开列表中的 Gemini 4 | gemini-4-carbon、gemini-4-argon、gemini-4-hydrogen,共 3 个 |
| 官方博客时间线 | Argon 面向所有人 2026-10-13;Carbon 可用 2026-11-10;Hydrogen 发布 2026-11-12 |
| API易 总表中的 Gemini 4 | 同样是这 3 个 ID |
| 不要填进 model 的名字 | gemini-4-oxygen:谷歌列表和 API易 总表都没有 |
| 数据日期 | 2026-11-16 09:39(UTC+8) |
Gemini 4 为什么只认目录
接口调用只认字符串。如果 model 字段里的名字不在平台型号列表里,请求不会自动降级到相近的模型,而是直接报错。所以判断 Gemini 4 能不能用,要看目录里有没有这个 ID,社交媒体上的讨论热度不能作为依据。
关于 Oxygen 的情况,第三方站点 OmniaKey 在 2026-11-16 表示,它核对过的谷歌页面都没有确认 Oxygen。需要注意,这是第三方说法,并不是谷歌公告。本文对 Oxygen 不写参数、不写价格、不写上下文,只提醒一点:它现在不应出现在你的 model 字段里。
Gemini 4 三个 ID 的官方定位
谷歌 AI Studio 模型列表给三张卡各写了一句定位。下表按原意整理,这些是官方描述,不是跑分结论。
| 模型 ID | 官方定位(谷歌模型列表) | 上下文 | 最大输出(谷歌卡) |
|---|---|---|---|
| gemini-4-carbon | 最强推理,面向复杂软件、知识工作、科学推理、网络安全防御 | 1M | 64K / 1M |
| gemini-4-argon | 比 Carbon 更快,每轮消耗的 token 更少 | 1M | 64K / 1M |
| gemini-4-hydrogen | 日常编码和 agent,强调速度和效率 | 1M | 长输出可达 1M |
官方博客对三者的说法与列表一致。Hydrogen 的发布帖(2026-11-12)称它面向 agent 工作流,覆盖各档用户。Carbon 的可用公告发于 2026-11-10。Argon 面向所有人的帖子发于 2026-10-13。这些都是官方对产品定位的自述,不代表具体任务上的表现排序。
三者不是简单的强弱排列。Carbon 的重点是推理深度,Argon 的重点是更快、每轮 token 更省,Hydrogen 的重点是日常编码和 agent 场景下的速度与效率。选型应该按任务需要来定,不要按“谁更强”来挑。

Gemini 4 在 API易 的标价与分组
下表是 API易 的价格与分组,单位为美元 / 每 1M tokens。Carbon 和 Argon 来自各自的型号页,Hydrogen 来自 2026-11-16 总表,因为它的型号页目前是 404。
| 模型 ID | 输入 | 输出 | 缓存读 | 分组 | 数据来源 |
|---|---|---|---|---|---|
| gemini-4-carbon | $2 | $10 | $0.1 | Default、SVIP | 型号页 |
| gemini-4-argon | $2 | $10 | $0.1 | 型号页:Default、SVIP、Gemini_Reverse 0.5×;总表:Default、SVIP | 型号页 + 总表 |
| gemini-4-hydrogen | $1.5 | $7.5 | $0.075 | Default、SVIP | 总表(型号页 404) |

📊 数据说明:上图和价格表均整理自 API易 apiyi.com 在 2026-11-16 的型号页与总表,实际计费以控制台显示为准。
gemini-4-oxygen 暂未上架,我们会尽快上架这个模型;型号与价格以平台型号列表为准。
Gemini 4 Carbon 与 Argon:同价,差在定位和分组
Carbon 和 Argon 在 API易 的标价完全相同,输入 $2、输出 $10、缓存读 $0.1。两者真正的差别有两处:一是官方定位,Carbon 侧重推理深度,Argon 侧重更快、每轮 token 更少;二是分组,只有 Argon 的型号页多列了一行 Gemini_Reverse 0.5×。
这一行有一个需要留意的地方。2026-11-16 的总表里,Argon 的分组列只写了 Default 和 SVIP,没有 Gemini_Reverse。型号页和总表的说法不一致,本文两处都如实列出。你的令牌到底能不能用这个分组,以控制台中令牌可选的分组为准。另外,Carbon 和 Hydrogen 的分组只有 Default 和 SVIP,0.5× 分组不适用于它们。
Gemini 4 Hydrogen:总表有价,型号页 404
Hydrogen 是三者中标价最低的:输入 $1.5、输出 $7.5、缓存读 $0.075,分组同样只有 Default 和 SVIP。它的单型号页目前返回 404,所以 API易 侧的上下文窗口和最大输出暂时没有文档数字,本文不做推测。谷歌卡的写法是 1M 上下文、长输出可达 1M,供你参考。
Gemini 4 最大输出:两个数字都保留
谷歌和 API易 对同一参数的写法有出入,把它们放在一起对照,可以避免误读。
| 项目 | 谷歌 AI Studio 模型卡 | API易 型号页 |
|---|---|---|
| Carbon 上下文 / 最大输出 | 1M / 64K / 1M | 1,048,576 / 65,536 |
| Argon 上下文 / 最大输出 | 1M / 64K / 1M | 1,048,576 / 65,536 |
| Hydrogen 上下文 / 最大输出 | 1M / 长输出可达 1M | 型号页 404,暂无数字 |
| Carbon 日期 | 博客可用公告 2026-11-10 | 厂商发布日 2026-11-10,上线 2026-11-11 |
| Argon 日期 | 博客面向所有人 2026-10-13 | 厂商发布日 2026-09-30,上线 2026-10-14 |
65,536 就是 64K 的精确写法,“64K / 1M”则是谷歌卡上的原始表述,两者都保留。Argon 的两个日期口径不同:一个是博客宣布面向所有人的时间,一个是 API易 型号页记录的厂商发布日,两个日期可以同时成立。Carbon 型号页还写明只输出文本,知识截止为 2026-03。页内另附有一段长文测试,属于文档原文内容,不是本文作者测试的结果。
Gemini 4 快速上手:三个 ID 怎么选
选型可以按任务类型来分,不需要先找出“最强的那个”:
- 日常大量任务:用
gemini-4-hydrogen。官方定位是日常编码和 agent,强调速度与效率,在 API易 也是三者中单价最低的。 - 需要更强推理:用
gemini-4-carbon。复杂软件、知识工作、科学推理、网络安全防御这几类场景,正是官方给它的定位。 - 想用 Argon 的半价分组:先到控制台查看令牌的分组选项里是否真的有 Gemini_Reverse。没有就按 Default 或 SVIP 计费,标价与 Carbon 相同。
Gemini 4 请求路径
接入时把 base_url 设为 https://api.apiyi.com/v1,然后在两条路径中选一条:
- OpenAI 兼容路径:
/v1/chat/completions,在请求体的 model 字段填入gemini-4-hydrogen、gemini-4-carbon或gemini-4-argon,messages 写法和调用其他 OpenAI 兼容模型一样。 - Gemini 原生路径:
/v1beta/models/{model}:generateContent,把{model}替换成上述三个 ID 之一,请求体按 Gemini 原生格式组织。
Carbon 的型号页明确列出了 chat 与 gemini 两种端点,没有 responses 端点。所以调用 Carbon 时不要走 Responses 接口。Argon 和 Hydrogen 的端点支持情况,建议以型号页和控制台显示为准。
| 模型 ID | 推荐任务 | 分组提示 | 请求路径 |
|---|---|---|---|
| gemini-4-hydrogen | 日常编码、agent、批量任务 | Default、SVIP | chat/completions 或 generateContent,以控制台为准 |
| gemini-4-carbon | 复杂推理、知识工作 | Default、SVIP | chat/completions 或 generateContent,无 responses |
| gemini-4-argon | 要求更快、每轮 token 更少 | 先查令牌是否有 Gemini_Reverse 0.5× | chat/completions 或 generateContent,以型号页为准 |
上手步骤:在 API易 apiyi.com 注册并创建令牌,在令牌设置里确认分组,然后把 base_url 和 model 填好,发一条简短请求验证连通性。如果是从其他模型迁移过来,通常只需要改 model 字段。
🚀 官方推荐:可以先用新用户的免费测试额度,在 API易 apiyi.com 用同一段 prompt 分别跑 Hydrogen 和 Carbon,对比输出长度和计费明细,再决定主力模型。一个 API Key 即可在三个 Gemini 4 ID 之间切换。
Gemini 4 上架状态的影响分析
对开发者的影响
- 配置要以目录为准:生产配置里的 model 名应该从平台型号列表复制,不要从新闻或社交帖里抄。写错名字会直接报错,不会自动替换成相近的模型。
- 成本测算多了一个变量:Carbon 和 Argon 同价,Hydrogen 单价更低。Argon 的 0.5× 分组只出现在型号页、总表未列,测算时应以令牌实际可选分组为准。
- 最大输出要按平台数字设置:在 API易 调用 Carbon 或 Argon 时,max_tokens 的上限应参照型号页的 65,536,不要直接套用 1M。
对模型选型的影响
Gemini 4 目前三个 ID 的分工比较清楚:推理深度、速度与 token 效率、日常 agent 与效率各占一个。三者都有 1M 上下文(谷歌卡),所以选型的关键在于任务类型和单价,上下文长度不是区分点。对多数团队来说,比较常见的做法是:用 Hydrogen 处理大量日常请求,把需要深度推理的任务交给 Carbon。
常见问题 FAQ
Q1: Gemini 4 现在有哪些可调用的模型?
截至 2026-11-16,谷歌 AI Studio 公开列表和 API易 总表都是三个:gemini-4-carbon、gemini-4-argon、gemini-4-hydrogen。目录之外的名字不应写进 model 字段。
Q2: gemini-4-oxygen 能填进接口吗?
不能。谷歌模型列表和 API易 总表里都没有这个 ID。第三方 OmniaKey 也表示,它核对过的谷歌页面没有确认 Oxygen,但这不是谷歌公告。
Q3: Gemini 4 Carbon 和 Argon 价格一样,该选哪个?
两者标价都是输入 $2、输出 $10、缓存读 $0.1。需要推理深度时选 Carbon,更在意速度和每轮 token 消耗时选 Argon。如果想用 Argon 型号页列出的 Gemini_Reverse 0.5× 分组,请先在 API易 apiyi.com 控制台确认令牌里是否有这个选项。
Q4: Gemini 4 Hydrogen 的上下文在 API易 是多少?
Hydrogen 的型号页目前是 404,API易 侧暂无上下文和最大输出的文档数字。谷歌卡写的是 1M 上下文、长输出可达 1M。计费请参照总表:输入 $1.5、输出 $7.5、缓存读 $0.075。更新信息可以留意 API易 apiyi.com 的型号列表。
Q5: Gemini 4 Carbon 能走 Responses 接口吗?
不能。Carbon 型号页只列了 chat 与 gemini 两种端点,请使用 `/v1/chat/completions` 或 `/v1beta/models/{model}:generateContent`。
Q6: 0.5× 分组能用在 Gemini 4 Carbon 或 Hydrogen 上吗?
不能。Gemini_Reverse 0.5× 只出现在 Argon 的型号页上。Carbon 和 Hydrogen 的分组只有 Default、SVIP。
Gemini 4 核心要点 Key Takeaways
- 可用名单只有三个:carbon、argon、hydrogen,目录里有才算可用
- Oxygen 不要填:谷歌列表和 API易 总表都没有这个 ID
- Carbon 与 Argon 同价:$2 / $10 / $0.1,差别在官方定位和分组
- 0.5× 只在 Argon 型号页:总表分组列未列,以控制台令牌为准
- Hydrogen 单价最低:$1.5 / $7.5 / $0.075,型号页暂为 404
- 最大输出看平台:谷歌卡写 64K / 1M,API易 型号页写 65,536
- 上手方式:在 API易 apiyi.com 创建令牌,base_url 填
https://api.apiyi.com/v1
总结
Gemini 4 当前状态的核心要点:
- 以目录为准:今天能调用的是 gemini-4-carbon、gemini-4-argon、gemini-4-hydrogen 三个 ID,gemini-4-oxygen 不在任何一份目录里。
- 按任务选型:日常大量任务用 Hydrogen,需要更强推理用 Carbon,Argon 适合更在意速度和每轮 token 消耗的场景。
- 按令牌核对分组:Argon 的 Gemini_Reverse 0.5× 只出现在型号页,开始测算成本前先看控制台。
建议先用小流量把三个 ID 各跑一遍,再把主力模型写进生产配置。推荐通过 API易 apiyi.com 用一个 API Key 完成对比,新用户可以先用免费测试额度验证。
📚 参考资料
-
谷歌 AI Studio 模型列表:Gemini 4 三张模型卡的官方定位、上下文与最大输出
- 链接:
aistudio.google.com/docs/models - 说明: 判断哪些 ID 已公开的首要依据
- 链接:
-
谷歌博客 · Gemini 4 Hydrogen / Carbon / Argon 发布与可用公告:三篇官方帖的定位描述
- 链接:
blog.google/innovation-and-ai/models-and-research/gemini-models/ - 说明: Hydrogen 2026-11-12、Carbon 2026-11-10、Argon 2026-10-13
- 链接:
-
API易 型号总表与单型号页:价格、分组、端点与日期
- 链接:
docs.apiyi.com/models.md(单型号页位于同目录/models/gemini-4-carbon.md、/models/gemini-4-argon.md) - 说明: 数据日期 2026-11-16 09:39(UTC+8),Hydrogen 型号页暂为 404
- 链接:
作者: APIYI 技术团队
技术交流: 欢迎在 API易 网站首页联系我们,更多型号与接入说明可访问 docs.apiyi.com 文档中心