Base URL
认证
端点
模型
不要从本页硬编码模型目录。用GET /v1/models 列出 ID，选用 type_target 为 gemini 的条目。图像模型（如 Nano Banana）走同一条 generateContent 路径，见 图像。
思考与 Thought Signature
Gemini 思考模型会在部分响应 part 上返回加密的thoughtSignature。对 Gemini 3 模型，
函数调用 part 上的签名必须在同一回合的后续请求中原样带回到同一个 part，否则模型返回
400；对 Gemini 2.5 模型，回传是可选的。这是模型的原生行为，详见 Google 官方的
Thought signatures 文档。
- 使用官方 Google Gen AI SDK 并把完整的模型响应追加到历史时，签名会被自动处理。 使用 REST 或自行重建历史时，请保持每个 part 与收到时完全一致。
- 签名由签发它的上游校验。PipeLLM 可能通过不同的上游渠道处理同一模型的连续请求。
我们在 Responses converter 路由上观察到：发生渠道切换后，一次 Gemini 3 签名回放被以
400 Thought signature is not valid拒绝；同渠道的回放（包括一次原生路由回放） 均成功。请在 Gemini 3 工具循环中处理该错误。 - 各 converter 路由对签名的保留程度不同，见 协议转换总览。
思考配置
Gemini 3 使用generationConfig.thinkingConfig.thinkingLevel；Gemini 2.5 使用 thinkingBudget。各型号接受的等级不同，不能将某个 Gemini 3 型号的所有选项视为整个系列通用。原生请求按目标模型的配置发送；转换接口的等级映射和限制见各格式页面。
下一步
Generate Content
查看端点说明和 SDK 示例
LangChain（Gemini）
框架集成文档
Nano Banana
图像生成