Gemini 4 API 报错怎么查?Carbon、Neon、Hydrogen 常见错误与修复

按状态码和响应结构排查 Gemini 4 Carbon、Neon、Hydrogen 的 API 报错,覆盖模型 ID 错误、免费层限制、429、思考级别、空回复、工具调用和安全拦截。

一个打开的断路器配电箱线稿,两列开关中有一个橙色开关已经跳闸。

Gemini 4 的 API 报错大多可以归入五类:模型 ID 或路由写错;项目档位不对(Carbon 和 Neon 只开放给付费层);配额(429);参数不受支持(minimal,或在 Carbon 上用 xhigh);以及请求在技术上成功了,却因为思考用光了 max_output_tokens 而没有答案。 先根据 HTTP 状态码、错误 code 和响应结构判断属于哪一类。换一个新 API Key 只能解决一种很窄的情况:Key 泄露或被封。

本文覆盖 Gemini 4 的 Carbon、Neon 和 Hydrogen。Argon 另有专文,见 Gemini 4 Argon API 报错排查,本文不再重复那篇的故障记录模板和合成测试用例。下文 Google 方面的事实来自 Gemini API 文档,核对日期为 2026 年 11 月 19 日(文中 Google 文档链接均为英文页面)。Ofox 方面的结果来自当天我们通过 Ofox 向 google/gemini-4-hydrogen 和 google/gemini-4-argon 发出的 21 次真实请求,每个用例跑一次(总花费估计不到 0.05 美元)。Carbon 和 Neon 在 Ofox 上不可用(2026 年 11 月 19 日查看目录),所以本文所有 Carbon 和 Neon 示例都使用 Google 原生 API。

本文由 Ofox 发布。网关结果与 Google 文档不一致时,两者都会列出,网关上的差异不代表 Google 自家端点的规则。

先按症状定位

从上往下找第一行匹配的症状。每一行都链接到给出修复方法和验证步骤的章节。

看到的现象最可能的原因先检查什么章节
404 model_not_found拼写错误或自己加的后缀,或者当前路由不提供这个模型从服务商当前的模型列表复制 ID模型 ID
403 PERMISSION_DENIED,提到验证、免费层或付款项目档位或计费状态AI Studio 里的项目状态,而不是 Key付费层
402 payment_required预付费额度用完账户余额;不要重试付费层
429,带 rate_limit_exceeded / too_many_requests每分钟突发流量并发数和 token 速率429
429,带 quota_exceeded当日配额用完等配额重置;重试没用429
400,提到 thinking_level该模型不支持这个级别各模型的级别表思考级别
从 Gemini 3.x 迁移后出现 400旧的采样、缓存或工具提示配置迁移检查清单迁移
HTTP 200,文字为空,MAX_TOKENS / length / incomplete思考用光了输出额度max_output_tokens 和 thinking_level输出额度
状态为 requires_continuation单次前台请求达到了上限SDK 版本或续接循环输出额度
后台任务 failed 或卡住服务端失败,运行超过 24 小时,或设置了 store=falseinteraction 状态和 errors 列表后台任务
missing_thought_signature、malformed_function_call工具调用历史被改动,或没有声明工具历史记录是怎么重新发送的工具调用
400,code 为 safety、prohibited_content内容过滤提示词和你的安全设置安全拦截

先看错误结构,再读错误信息

Google 和 Ofox 这类网关的错误格式不同。先确认是谁返回的错误,再根据文字采取行动。

Google 的 Interactions API 返回一个 error 对象,包含机器可读的 code 和 message,见 Google 的 API 错误参考:

{
  "error": {
    "code": "invalid_request",
    "message": "The value 'invalid_tool_type_xyz' is not supported for 'type' at 'tools[0]'. ..."
  }
}

流式输出时,同样的对象会以 SSE 事件的形式到达,带 "event_type": "error"。流可能先以 HTTP 200 开始,之后才失败,所以读取流的代码必须处理 error 事件。旧版 generateContent API 使用较早的 Google RPC 风格,状态名如 INVALID_ARGUMENT 和 RESOURCE_EXHAUSTED,这也是 Google 的排障页面里两种命名同时出现的原因。

Ofox 网关在我们的测试中返回过两种结构。模型 ID 不在网关目录里时,网关用自己的错误体回复(request ID 已截短),消息格式与 Ofox Gemini 指南中模型 ID 拼错那一行一致:

{"error": {"message": "Model 'google/gemini-4-carbon' not found",
           "type": "model_not_found", "code": 404, "request_id": "e0925435-..."}}

请求到达 Google 一侧(据 Ofox Gemini 指南,Ofox 通过 Vertex AI 提供 Gemini)并在那里被拒时,上游的文字会包在网关的错误结构里返回:

{"error": {"code": null,
  "message": "Invalid value at 'generation_config.thinking_config.thinking_level' (type.googleapis.com/google.cloud.aiplatform.v1.GenerationConfig.ThinkingConfig.ThinkingLevel),",
  "param": null, "request_id": "1439e1a1-...", "type": "INVALID_ARGUMENT"}}

消息里出现 google.cloud.aiplatform 类型名,说明是上游模型服务拒绝了这个值。消息是 Model '<id>' not found,说明网关不认识这个模型 ID。

Ofox 的错误处理指南列出了各状态码,以及哪些可以重试。指南里的示例错误体是 "code": "invalid_api_key" 和 "type": "authentication_error",表格里 404 的 type 写的是 not_found_error。我们在 2026 年 11 月 19 日收到的错误体结构不同:401 是 "code": 401 和 "type": "invalid_api_key",404 是 "code": 404 和 "type": "model_not_found"。如果你的处理逻辑按这些字段分支,code 和 type 都要检查,并用从自己路由上抓到的真实错误测试一遍。

404 model not found:模型 ID 或路由不对

症状。Google:404,code 为 model_not_found。Ofox:404,type 为 model_not_found,消息为 Model '<id>' not found。

原因。Google API 上四个 Gemini 4 模型的 ID 就是 gemini-4-carbon、gemini-4-neon、gemini-4-hydrogen 和 gemini-4-argon(模型页),都没有 -preview 或 -latest 后缀。另一个常见原因是所用路由根本不提供这个模型。

我们在 2026 年 11 月 19 日通过 Ofox 发出的请求(各跑一次):

发送的模型字符串端点结果
google/gemini-4-hydrogen-preview/v1/chat/completions404 model_not_found
google/gemini-4-hydrogen-preview/gemini/v1beta/models/...:generateContent404 model_not_found
google/gemini-4-carbon/v1/chat/completions404 model_not_found
google/gemini-4-neon/v1/chat/completions404 model_not_found
gemini-4-hydrogen(不带 google/ 前缀)/v1/chat/completions200,响应的 model 字段为 google/gemini-4-hydrogen

修复。在 Google 上用不带前缀的 ID。在 Ofox 上用 google/gemini-4-hydrogen 或 google/gemini-4-argon。不带前缀的写法在我们的测试中也能解析,Ofox Gemini 指南也说前缀可以省略。要用 Carbon 或 Neon,请使用 Google 付费层项目。改拼写不会让网关目录里没有的模型冒出来。

验证。用应用实际使用的同一个端点和同一个 Key 列出模型:Google 上是 GET https://generativelanguage.googleapis.com/v1beta/models,Ofox 上是 GET https://api.ofox.ai/v1/models。Google 提醒,models.list 只检查 Key 是否存在。列表端点返回 200 并不能证明该项目已开通推理,所以还要发一次小的生成请求确认。

免费层项目调用 Carbon 和 Neon 失败

症状。同一个请求用 Hydrogen 能成功,把模型换成 Carbon 或 Neon 就失败。常见迹象有:403 PERMISSION_DENIED;AI Studio 的项目状态显示 Free tier unavailable 或 Payment needed;或者从未开通计费的项目报配额错误。

原因。Carbon 指南写明 Carbon “is not available on the Free tier”(免费层不可用)。Neon 指南写的是 Neon “available on the paid tier only”(仅付费层可用)。Hydrogen 是唯一有免费层的 Gemini 4 模型(价格页)。对于免费层项目调用 Carbon 或 Neon 的情况,Google 没有公布专门的错误字符串,所以不要按原文精确匹配。应该先按状态码判断,再去检查项目。

Google 的排障指南列出了项目层面的几种 403:

信号含义修复
403,带 FREE_TIER_VERIFICATION_REQUIRED,状态 Verification needed免费层项目需要验证用手机完成验证,或者开通计费
状态 Free tier unavailable该项目没有免费层资格关联一个有效的 Cloud Billing 账号
状态 Payment needed,或 403 提到未结清余额计费账号欠费结清欠款,访问会自动恢复
403 说 Key 已被举报泄露Google 封禁了这个 Key新建 Key,并且不要放进客户端代码
402 payment_required预付费额度用完充值或开启自动充值;不要重试

有两个细节容易踩坑。资格是按 Google Cloud 项目检查的,同一项目下换一个 Key,结果一样。升级到付费层也不会解锁免费层配额,付费用量要计费。如果免费层的 429 报告的限额是 0,可以看 Gemini 免费层限额为 0 的诊断,里面讲了怎么读配额指标。那篇写的是图像模型,但检查项目的方法相同。Hydrogen 免费层包含什么,见 Gemini 4 免费 API 档位指南。

验证。在 AI Studio 打开 Key 所属的项目,确认档位,然后发一个简短的 Carbon 或 Neon 请求。Carbon 和 Argon 的价格将在 2026 年 12 月 1 日翻倍(Carbon 指南),具体数字见 12 月调价解读。

429:区分突发限流和配额耗尽

症状。HTTP 429。Interactions API 上的 code 是 rate_limit_exceeded、too_many_requests 或 quota_exceeded。generateContent 上是 RESOURCE_EXHAUSTED。

原因。Google 的限流页面规定了三点:

  • 限额按项目计算,而不是按 API Key。
  • 每日请求配额在太平洋时间午夜重置。
  • 付费项目还有一个按 10 分钟滚动窗口计算的花费限额:Tier 1 为 10 美元,Tier 2 和 Tier 3 为 200 美元。超过后返回 429 RESOURCE_EXHAUSTED,即使你的请求速率很低。

在 Gemini 4 上,花费限额很容易被忽略。Neon 和 Hydrogen 默认使用 high 思考,思考 token 按输出 token 计费。少量篇幅长且思考强度高的请求,就可能在没有触碰任何 RPM 限制的情况下用满 Tier 1 的花费窗口。

修复。按 code 选择处理方式:

Code应该做不要做
rate_limit_exceeded、too_many_requests带随机抖动的指数退避;降低并发立即并行重试
quota_exceeded暂停任务等重置,或申请更多配额把重试预算耗在每日配额上
花费限额触发的 RESOURCE_EXHAUSTED把高成本调用分散开;调低 thinking_level 或输出长度以为是 RPM 限制

Google 的 Python SDK 本身就会对 429 和 5xx 最多重试四次,从约 1 秒开始,上限 60 秒(排障指南)。如果外面再包一层自己的重试循环,一次失败可能变成十几个甚至更多请求。重试只交给一层负责。通用的 429 重试指南讲了响应头和退避时间,AI API 错误处理(英文)提供了退避和熔断的代码。

在 Ofox 上。网关的 429(错误处理指南里的 type 是 rate_limit_error)是独立于 Google 项目配额的另一个限制。Ofox 限流文档列出的默认值是 100 RPM,按团队内所有 Key 合计(2026 年 11 月 19 日复查)。如需更高限额,可以按该页面的说明发邮件给 Ofox 申请。我们的测试没有触发 429。

验证。每次 429 都记录确切的 code。如果加了退避之后仍不断出现 quota_exceeded,问题出在配额,而不是流量形态。

思考级别报错:minimal 和 xhigh

各 Gemini 4 模型支持的思考级别并不相同。Google 的思考指南列出:

模型默认支持的级别
gemini-4-carbonmediumlow、medium、high
gemini-4-argonmediumlow、medium、high
gemini-4-neonhighlow、medium、high、xhigh
gemini-4-hydrogenhighlow、medium、high、xhigh

所有 Gemini 4 模型都不支持 minimal。Neon 和 Hydrogen 的迁移检查清单说,这两个模型收到 minimal 会报错。Google 的思考指南还把 minimal 列为 gemini-3.8-flash 不支持的级别,所以从曾经接受这个值的旧模型复制来的配置,也要做同样的修改。Google 说 Carbon 和 Argon 最高到 high,但没有公布在这两个模型上使用 xhigh 时的确切报错信息。

修复。显式映射旧设置:minimal 改为 low;在 Carbon 和 Argon 上,xhigh 改为 high。发送前在自己的代码里按模型 ID 校验级别。

网关的实际表现。我们在 Ofox 上的测试说明了为什么不该指望服务端替你拦下这个问题:

请求(Ofox,2026-11-19,各跑一次)结果
Hydrogen,Chat Completions reasoning_effort: "minimal"200,无报错;20 个推理 token
Hydrogen,原生 thinkingLevel: "minimal"200,无报错;22 个思考 token
Argon,Chat Completions reasoning_effort: "xhigh"200,无报错;157 个推理 token
Argon,原生 thinkingLevel: "xhigh"200,无报错;131 个思考 token
Hydrogen,reasoning_effort: "banana"400 INVALID_ARGUMENT(见上文)

Google 文档标为无效的值被接受了,没有报错,但这不代表它们生效了。响应里没有任何信息显示实际用了哪个级别。网关可能丢掉了这个值,也可能把它映射成了某个支持的级别。同一提示词下,Hydrogen 不设思考参数时用了 22 到 82 个思考 token,两次 minimal 分别用了 20 和 22 个,因此单次运行的 token 数无法说明发生了什么。Argon 我们完全没有跑基线。随便编的值则被上游拒绝了。请把这些结果当作某一天在某一条路由上的单次观察。不要依赖这种行为:因为网关接受就发送 minimal 的代码,改为直连 Google 时可能会出错。Ofox 的 Gemini 思考指南说明了 thinkingLevel 和 reasoning_effort 字段。按任务选择级别,见 Gemini 4 思考级别。

回答为空或被截断:共享的 1M 窗口

症状。HTTP 200,但文字为空或被截断。原生 generateContent 显示 finishReason: "MAX_TOKENS",Chat Completions 显示 finish_reason: "length",Interactions 资源显示状态 incomplete。

原因。在 Gemini 4 中,max_output_tokens 限制的是思考加可见输出的总和。Google 的长输出指南给出的正是这个症状:状态为 incomplete 且文字为空,意思是 “the model used all tokens on thinking.”(模型把全部 token 都用在了思考上)。从旧应用沿用下来的上限(例如 8,192)会让这种情况更容易出现,在默认 high 的 Neon 和 Hydrogen 上尤其如此。

我们用一道一行的算术题,通过 Ofox 在 Hydrogen 上复现了这个问题:

路由设置结果
Chat Completionsmax_tokens: 16200,content: "",finish_reason: "length",16 个 completion token 中 13 个是推理
原生 generateContentmaxOutputTokens: 16200,candidate 没有 parts,finishReason: "MAX_TOKENS",thoughtsTokenCount: 13

请求没有失败,也照常计费,只是答案没了。如果应用只检查 HTTP 状态码,就会显示一个空白的“成功”。

修复。

  • 去掉写死的低上限。Google 建议 Carbon 至少设为 32,768。Neon 和 Hydrogen 保留默认的 65,536,或者干脆不传这个字段。
  • 想少花 token,就调低 thinking_level。Google 的长输出指南说,调低 max_output_tokens 不会让模型思考得更简洁,只会让回答更早被截断。
  • 输出超过 64K token 时,设置 background: true,并把 max_output_tokens 设到 65,536 以上,最多为 1,048,576 减去输入 token 数。

共享窗口的限制。输入、思考和输出共用一个 1,048,576 token 的窗口。在 Google 上,如果输入加 max_output_tokens 超过窗口,API 会把输出上限压到剩余空间,而不是拒绝请求(思考指南)。我们在 Ofox 上发送 max_tokens: 2000000(Chat Completions)和 maxOutputTokens: 2000000(原生)的请求都被接受,没有报错,回答也正常;但响应里看不出实际生效的上限是多少。单是输入就超出窗口时,会直接报错。Ofox Gemini 指南列出的是 400 INVALID_ARGUMENT,消息为 The input token count exceeds the maximum number of tokens allowed 1048576. 这一条我们没有复现,因为百万 token 的测试输入会超出测试预算。

单次请求上限。单次前台请求(hop)在 Neon 和 Hydrogen 上的上限是 65,536 token,而在 Carbon 和 Argon 的非流式调用上是 32,768。某次请求达到上限但总额度还有剩余时,状态为 requires_continuation。低于 Python 2.34.0、JavaScript 2.32.0、Go 1.77.0、Java 1.80.0 和 .NET 1.28.0 的 SDK 不会自动续接前台 interaction。请升级 SDK,或者带上 previous_interaction_id 和 continuation_token 发送下一次请求。

验证。每次检查响应都要判断结束信号(status == "completed"、finishReason == "STOP" 或 finish_reason == "stop")并确认文字非空,不能只看 HTTP 状态码。

后台任务和长时间运行的 interaction

耗时长的 Carbon 和 Neon 任务应该放到后台执行。Google 的后台执行指南和长输出指南记录了以下失败情况:

症状原因修复
创建时返回 400background: true 同时设置了 store: false后台任务保持 store: true(默认值)
串接下一轮对话时返回 400上一个 interaction 仍处于 in_progress等到 completed 后,再把它的 ID 作为 previous_interaction_id 传入
状态 failed执行过程中出错(Google 举的例子:工具失败、限流),或者任务运行超过 24 小时重试一次;再次失败就把 interaction ID 发给支持团队
状态 failed,errors 里有安全相关的 code任务执行中内容被拦截见安全拦截一节;同样的输入重试也没用
客户端超时,任务状态未知HTTP 超时时间短于推理时间先轮询保存下来的 interaction ID,再决定是否重新提交
GET 返回 404interaction 已被删除删除前先取回结果

对于 Carbon 和 Neon 上的难题,Google 建议 HTTP 超时设为至少 15 分钟,或者使用后台执行。被取消和失败的 interaction 会按停止前已完成的工作计费。客户端超时后重新提交,同一个任务就可能付两次钱。创建任务后立即保存 interaction ID。

工具调用报错:思考签名和格式错误的调用

Google 的 API 错误页面列出了这些生成类错误码:malformed_function_call、malformed_tool_call、unexpected_tool_call、too_many_tool_calls 和 missing_thought_signature。

迁移后出现 MALFORMED_FUNCTION_CALL。Neon 和 Hydrogen 指南提醒:没有声明工具时,不要通过系统指令让模型输出纯文本 JSON 形式的工具调用,否则可能返回 MALFORMED_FUNCTION_CALL。修复方法是通过 API 的 function calling 字段声明工具,或者用结构化输出来生成 JSON。

missing_thought_signature。思考签名在多轮之间携带模型的推理状态。Google 的规则:

  • 在 Interactions API 中使用 store: true 和 previous_interaction_id 时,签名由服务端处理,你什么都不用做。
  • 在无状态模式下,每个 thought 块都要原样重新发送,包括切换模型后上一个模型的块,以及内置工具调用块和结果块上的签名。
  • 在客户端自行管理的 generateContent 历史中,之前的模型轮次和签名要原样返回,也不要把同一个签名复制到并行的 functionCall 部分上。

我们通过 Ofox 给 Hydrogen 发送了一段原生 generateContent 历史,其中有一个不带签名的 functionCall 部分。请求被接受,没有报错,模型根据工具结果给出了回答。一条路由上的一次运行,无法说明签名检查是否执行了,还是历史被以其他方式处理了,所以不要把它理解为可以丢掉签名。Google 的迁移检查清单要求原样返回签名。如需在 REST、SDK 和兼容适配层中逐字段修复,见 missing thought_signature 修复指南。在我们的测试中,Ofox 的 Chat Completions 响应把签名放在 message.reasoning_details 里(type 为 reasoning.encrypted)。如果你的框架会重新发送 assistant 轮次,请保留这个对象。

安全拦截和复述(recitation)拦截

症状。Google 的安全设置指南说,被拦截的输入或回复 “fails with an HTTP 400 error”(以 HTTP 400 错误失败),被拦截的内容不会返回。文档给出的示例:

{"error": {"code": "safety",
  "message": "Request blocked due to safety violations (harmful content). Please modify your input and retry."}}

输入拦截使用 jailbreak、prohibited_content 或 blocklist 这几个 code,消息以 Input blocked: 开头。Google 的 API 错误页面还列出了其他生成拦截类 code,包括 recitation、language、spii 和 content_blocked。在后台模式下,interaction 的状态变为 failed,code 出现在它的 errors 列表中。流式输出时则以 error 事件到达。

修复。把这类错误当作内容问题,而不是服务故障,不要自动重试。Gemini 2.5 及之后的模型,可调节的安全过滤器默认关闭(Off);有些危害类型无论怎么设置都会被拦截,所以放宽阈值并不能解除所有拦截。请改写正当的请求,不要试图绕过过滤器。BlockedReason.OTHER 表示请求可能违反条款或不受支持。对于 RECITATION,Google 建议让提示词和上下文更独特。它早先关于调整 temperature 的建议不适用于 Gemini 4,因为 Gemini 4 会忽略 temperature。

验证。把 code 和 request ID 一起记录下来,这样在监控中就能把内容拦截和 5xx 故障区分开。

迁移与弃用导致的报错

刚升级后出现的 400,大多来自在 Gemini 3.x 上能用的配置。下表是 Carbon、Neon 和 Hydrogen 已记录的破坏性变更,来自 Google 的三份迁移检查清单:

旧配置Gemini 4 的行为修复
temperature、top_p、top_k被忽略,并返回弃用警告响应头(排障指南);超出范围的值返回 400(Neon 和 Hydrogen 指南);Google 表示未来版本将返回 400三个都删掉
cached_content、caches.create不支持显式缓存删掉;提示词达到 4,096 token 以上时自动适用隐式缓存
thinking_level: "minimal"Neon 和 Hydrogen 会拒绝改用 low
max_output_tokens: 8192思考会用掉大部分上限调高到 32,768–65,536
candidate_count 大于 1Gemini 3 和 4 都不支持删掉

关于采样参数,我们通过 Ofox 向 Hydrogen 发送 temperature: 5,Chat Completions 和原生路由都接受了,没有报错(HTTP 200)。我们抓取的完整响应头里没有弃用警告头,所以从响应上看不出这个值是否传到了 Google。Google 的 Hydrogen 指南说超出范围的值会返回 400。删掉这个参数,同一份代码在任何路由上的行为才一致。

已弃用的模型 ID。截至 2026 年 11 月 19 日,Google 的弃用页面没有给任何 Gemini 4 模型列出停用日期。出意外的通常是旧 ID。gemini-3.7-flash 和 gemini-3.5-flash 已经自动路由到更新的 Flash 模型。从 2026 年 12 月 1 日起,所有 gemini-2.5-pro API 请求都会路由到 gemini-3.8-flash,并按 3.8 Flash 的价格计费。改路由本身不算错误,但它会在没有任何报错提醒的情况下改变模型行为和成本。请固定并记录 modelVersion 字段(Ofox 以 model 或 modelVersion 返回),这样才能发现悄悄发生的路由变化。如果要从 3.8 Flash 迁出,Gemini 3.8 Flash 迁移到 Hydrogen 指南提供了迁移前后的测试方案。

哪些错误该重试

退避后重试修正请求,不要重试等容量或计费恢复
429 速率限制 / too many requests、500、503、504、408、状态 failed(一次)任何 400、401、403、404、安全拦截和生成拦截类 code429 quota_exceeded、402 payment_required、花费限额触发的 RESOURCE_EXHAUSTED

这与 Google 不要重试 400、402 或 403 的建议一致,也与 Ofox 的表格一致:400、401、402、403 和 404 不可重试,429、500、502 和 503 可以重试。各家服务商的状态码对比,见 LLM API 错误码参考。

测了什么,没测什么

2026 年 11 月 19 日通过 Ofox 测试,每个用例跑一次(temperature 用例另外重复跑了两次,用来抓取完整响应头):错误 ID、目录中没有的模型、不带前缀的 ID、三个思考级别取值(minimal、xhigh 和一个无效值,共五次请求)、超大和极小的输出上限、超出范围的 temperature、不带签名的工具历史,以及无效 Key(401,type invalid_api_key,消息 Invalid or expired API key)。提示词都很简单(“Reply with the single word OK” 和一道一行的算术题)。原始请求和响应均已保存,Key 已脱敏。

没有测试:在 Google 端点上调用 Carbon 或 Neon、免费层 403、真实的 429、安全拦截、后台任务和上下文溢出。这些章节依据 Google 文档,只有 Google 或 Ofox 明确给出的消息才会引用原文。在我们的测试中,200 只代表请求没有被拒绝。网关行为可能不经通知就改变,请在你自己的路由上重新检查这些参数用例。

如果还在接入阶段,可以先看 Hydrogen API 接入指南、Carbon API 接入指南或 Neon API 指南,请求出错时再回到本文。

相关文档

常见问题

为什么 Gemini 4 请求成功了,却没有返回任何文字?
思考和可见输出共用 max_output_tokens。上限设得太低时,模型可能把全部额度都用在思考上。我们通过 Ofox 测试 Hydrogen,max_tokens 设为 16 时返回 HTTP 200,content 为空,finish_reason 为 "length"。解决办法是调高上限(Google 建议 Carbon 至少 32,768,Neon 和 Hydrogen 保留默认的 65,536),或者调低 thinking_level。
能通过 Ofox 调用 Gemini 4 Carbon 或 Neon 吗?
截至 2026 年 11 月 19 日还不能。在我们的测试中,这两个 ID 在 Ofox 上都返回 404 model_not_found。Ofox 目录里有 Gemini 4 Hydrogen 和 Gemini 4 Argon。Carbon 和 Neon 请使用 Google 的付费层。