> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pipellm.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 概述

> Gemini API 认证、端点和支持的模型

## Base URL

```
https://api.pipellm.ai
```

## 认证

| Header | 值 |
| - | - |
| `x-goog-api-key` | `$PIPELLM_API_KEY` |

## 端点

| 类型 | 端点 |
| - | - |
| 非流式 | `POST /v1beta/models/{model}:generateContent` |
| 流式 | `POST /v1beta/models/{model}:streamGenerateContent` |

## 模型

不要从本页硬编码模型目录。用 [`GET /v1/models`](/zh/api-reference/list-models) 列出 ID，选用 `type_target` 为 `gemini` 的条目。图像模型（如 Nano Banana）走同一条 `generateContent` 路径，见 [图像](/zh/guides/images)。

## 思考与 Thought Signature

Gemini 思考模型会在部分响应 part 上返回加密的 `thoughtSignature`。对 Gemini 3 模型，
函数调用 part 上的签名必须在同一回合的后续请求中原样带回到同一个 part，否则模型返回
`400`；对 Gemini 2.5 模型，回传是可选的。这是模型的原生行为，详见 Google 官方的
[Thought signatures](https://ai.google.dev/gemini-api/docs/generate-content/thought-signatures) 文档。

* 使用官方 Google Gen AI SDK 并把完整的模型响应追加到历史时，签名会被自动处理。
  使用 REST 或自行重建历史时，请保持每个 part 与收到时完全一致。
* 签名由签发它的上游校验。PipeLLM 可能通过不同的上游渠道处理同一模型的连续请求。
  我们在 Responses converter 路由上观察到：发生渠道切换后，一次 Gemini 3 签名回放被以
  `400 Thought signature is not valid` 拒绝；同渠道的回放（包括一次原生路由回放）
  均成功。请在 Gemini 3 工具循环中处理该错误。
* 各 converter 路由对签名的保留程度不同，见
  [协议转换总览](/zh/converter/overview#当前限制)。

### 思考配置

Gemini 3 使用 `generationConfig.thinkingConfig.thinkingLevel`；Gemini 2.5 使用 `thinkingBudget`。各型号接受的等级不同，不能将某个 Gemini 3 型号的所有选项视为整个系列通用。原生请求按目标模型的配置发送；转换接口的等级映射和限制见各格式页面。

## 下一步

<Columns cols={3}>
  <Card title="Generate Content" icon="code" href="/zh/api-reference/gemini/generate-content">
    查看端点说明和 SDK 示例
  </Card>

  <Card title="LangChain（Gemini）" icon="link" href="/zh/integrations/langchain-gemini">
    框架集成文档
  </Card>

  <Card title="Nano Banana" icon="image" href="/zh/use-cases/nano-banana">
    图像生成
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.