Skip to main content
Gemini 当前资源较紧张,调用可能遇到 429、502 或等待超时。成功调用记录说明下方请求格式可用,不代表当前每次请求都能成功;遇到错误时请检查错误正文,避免连续重复提交。

模型与权限

以上四款型号已在便利店模型列表中核对可见;模型列表用于确认型号与权限,不代替逐模型的参数验证。 使用 Gemini 分组的便利店 API Key。先通过 Models 查询当前 Key 的可见模型;gemini4 是系列简称,调用时使用表中的完整 ID。

Gemini 4 文本接口

以下请求体和流式说明的成功调用记录覆盖 Gemini 4 Argon、Carbon、Hydrogen。模型 ID 放在 URL 路径中;以 Hydrogen 为例: Argon、Carbon 使用同样的路径结构,将路径中的模型 ID 分别替换为 gemini-4-argon、gemini-4-carbon。请求头使用 Content-Type: application/json 和 x-goog-api-key: <便利店 API Key>。

文本请求

下面是上述三款 Gemini 4 模型均有真实成功记录的完整请求 JSON;普通和流式文本使用相同的请求体。
普通响应从 candidates[].content.parts[] 中读取非思考部分的 text;此请求的成功结果为 API_OK,完成原因为 finishReason: STOP。同时检查返回的 modelVersion 是否与请求模型一致,不能把其他模型的回答算作请求模型的成功。

流式读取

流式使用上表的 streamGenerateContent?alt=sse 地址。响应为 text/event-stream,按 SSE 的 data: 事件逐帧解析,将非思考部分的文本增量拼接起来,并确认最终出现 finishReason: STOP。 HTTP 200、连接关闭或收到部分文字都不能单独证明正常完成;还需检查错误事件、完成原因及返回模型。资源不足时,流式请求也可能在返回第一帧之前失败。

当前接入范围

2026-11-18,Argon、Carbon、Hydrogen 的上述普通文本和流式请求均有成功记录;后续补测也出现了资源限流、上游拒绝及超时。本页先提供已成功调用的基础文本协议,不把资源错误当成模型能力结论。 本页不承诺所有官方参数或全部多模态能力均可通过当前线路使用。价格以模型广场与实际用量明细为准。

错误处理

客户端关闭自动重试并不保证服务端没有重试。不要以客户端提交次数直接推算上游尝试次数;费用查看本站用量记录。

官方协议参考

字段与接口结构参考 Google GenerateContent REST 接口及内容生成接口说明。本页使用 GenerateContent,不能混入 Interactions API 的请求字段。官方能力说明与便利店当前线路的实际可用范围分别判断。