模型与权限
以上四款型号已在便利店模型列表中核对可见;模型列表用于确认型号与权限,不代替逐模型的参数验证。
使用 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 的上述普通文本和流式请求均有成功记录;后续补测也出现了资源限流、上游拒绝及超时。本页先提供已成功调用的基础文本协议,不把资源错误当成模型能力结论。 本页不承诺所有官方参数或全部多模态能力均可通过当前线路使用。价格以模型广场与实际用量明细为准。错误处理
客户端关闭自动重试并不保证服务端没有重试。不要以客户端提交次数直接推算上游尝试次数;费用查看本站用量记录。