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

# Gemini API:模型阵容、长上下文与多模态

> 完整的 Gemini 阵容 —— Pro、Flash、Flash-Lite 以及图像生成模型。超大上下文窗口、图片输入与图片生成、怎么选版本、怎么接入。

Google 的 Gemini 是 RuAPI 上最偏多模态的一条线:模型能读文本**也能读图片**,其中一部分还能**生成图片**。再加上超大上下文窗口和多个档位 —— 从轻量的 Flash-Lite 到重量级的 Pro。下面梳理整条阵容,以及怎么按任务选版本。所有模型都走 OpenAI 兼容协议 —— 接入见[快速入门](/zh/quickstart)。

## 完整的 Gemini 阵容

| 档位             | 适合                | 速度 / 价格 |
| -------------- | ----------------- | ------- |
| **Pro**        | 复杂代码、推理、解析大文档     | 更慢、更贵   |
| **Flash**      | 全能型:聊天机器人、助手、中等流量 | 快、中等价格  |
| **Flash-Lite** | 批处理、分类、大规模打标      | 最快最便宜   |
| **Image**      | 图片生成与编辑           | 专门的生成模型 |

<Tip>
  先从**黄金档 Flash** 起步。大流量下卡速度或成本,就降到 **Flash-Lite**;难任务深度不够,就升到 **Pro**。
</Tip>

## 超大上下文窗口

Gemini 一向的强项就是**超大上下文**:整份报告、长日志、大型代码库都能塞进窗口,不用切块。这对文档解析、大片段 RAG、以及分析长对话都很方便。具体上限取决于版本,跟 Google 官方一致 —— 当前数值请看 [www.ruapi.ai](https://www.ruapi.ai) 的\*\*「价格」\*\*页。

## 多模态:能看图也能生图

<Info>
  Gemini 对图片是双向的。**输入侧**(视觉)模型能连同文本一起接受图片 —— 怎么在请求里传图见[图像输入指南](/zh/vision)。**输出侧**有专门的模型生成和编辑图片:`gemini-2.5-flash-image`、`gemini-3.1-flash-image-preview`、`gemini-3-pro-image-preview`。这些 preview 模型的精确当前名称见价格页。
</Info>

这条线的文本模型是 `gemini-3.5-flash`、`gemini-3.1-pro-preview`、`gemini-2.5-pro`、`gemini-2.5-flash`、`gemini-2.5-flash-lite`。它们支持[函数调用](/zh/function-calling)和[逐字流式输出](/zh/streaming)。

## 怎么选版本(2.5 / 3 / 3.1 / 3.5 / 3.6)

* **2.5**(`gemini-2.5-pro`、`gemini-2.5-flash`、`gemini-2.5-flash-lite`)—— 成熟稳定的一代,默认之选。
* **3 / 3.1** —— 更新的模型,包含 preview 版(`gemini-3-flash-preview`、`gemini-3.1-pro-preview`、`gemini-3.1-flash-lite-preview`)和图像生成;想要最新能力就用它,但记住 preview 名称可能变。
* **3.5**(`gemini-3.5-flash`、`gemini-3.5-flash-lite`)—— 新一代 Flash:`-flash-lite` 明显更便宜更快,`-flash` 更强。
* **3.6**(`gemini-3.6-flash`)—— 最新一代 Flash,新代码的当前之选。

<Note>
  Preview 模型会随新版本发布改名。别把 ID 写死 —— 精确的当前名称和单价始终在 [www.ruapi.ai](https://www.ruapi.ai) 的\*\*「价格」\*\*页。
</Note>

## 接入 Gemini

不用装 Google 那套单独的库:端点是 **OpenAI 兼容**的,拿任意 OpenAI SDK 改 `base_url` 就行。

* **base\_url:** `https://www.ruapi.ai/v1`
* **model:** 例如 `gemini-3.6-flash`

同一个密钥在 Cursor、Cline、n8n、LangChain 里都能用。Python 和 curl 的分步代码见[快速入门](/zh/quickstart)。充值见[充值页](/zh/topup)。

## 接下来

<CardGroup cols={2}>
  <Card title="接入与第一个请求" icon="bolt" href="/zh/quickstart">
    base\_url、密钥、Python 和 curl 代码。
  </Card>

  <Card title="Claude 模型" icon="brain" href="/zh/claude-api">
    同一个密钥 —— Claude 的选型与能力。
  </Card>

  <Card title="GPT 模型" icon="robot" href="/zh/gpt-api">
    同一端点上的 OpenAI 阵容。
  </Card>
</CardGroup>