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

# Sub2API 支持的 Google Gemini 模型说明

> 了解可通过 Sub2API 访问的 Google Gemini 模型系列，支持 OpenAI 兼容格式调用。

Sub2API 支持 Google Gemini 模型系列，你可以使用熟悉的 OpenAI 兼容 API 格式调用 Gemini，无需学习新的请求格式。Gemini 模型在代码生成、长文本理解以及多语言能力方面表现优异。

## 支持的模型系列

Google Gemini 系列包括多个定位不同的模型，覆盖从快速响应到复杂推理的各种需求。

### Gemini 2.0 系列

Gemini 2.0 是 Google 最新一代大语言模型，采用更新的训练架构和更大的参数规模。Sub2API 支持其中的多个子模型。

### Gemini 1.5 系列

Gemini 1.5 系列引入突破性的上下文窗口技术，支持处理海量文本输入，包括超长文档和视频分析。

## 模型一览

| 模型名称                  | 适用场景      | 上下文窗口 | 备注     |
| --------------------- | --------- | ----- | ------ |
| TODO: 请在控制台查看最新可用模型列表 | 快速响应、实时对话 | -     | 速度优先   |
| TODO: 请在控制台查看最新可用模型列表 | 通用任务、平衡选择 | -     | 综合能力最强 |
| TODO: 请在控制台查看最新可用模型列表 | 极致质量、复杂推理 | -     | 能力最强   |

## 各系列定位差异

<CardGroup cols={3}>
  <Card title="Flash" icon="bolt">
    Gemini Flash 系列注重速度和效率，适合实时对话、快速总结和轻量级任务，Token 成本较低。
  </Card>

  <Card title="Pro" icon="star">
    Gemini Pro 系列是综合能力最强的主力模型，在代码、推理和多语言任务上表现均衡，适合大多数业务场景。
  </Card>

  <Card title="Ultra" icon="crown">
    Gemini Ultra 系列是 Google 能力最强的模型，在复杂的数学、科学推理和创意写作任务上表现最佳。
  </Card>
</CardGroup>

## API 调用方式

你可以通过 OpenAI 兼容的 Chat Completions 端点调用 Gemini 模型，只需在 `model` 参数中指定 Gemini 的模型标识符：

<CodeGroup>
  ```bash curl theme={null}
  curl https://sub2api.ruilinlu.com/v1/chat/completions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -d '{
      "model": "gemini-2.0-flash",
      "messages": [
        {"role": "user", "content": "请解释一下量子计算的基本原理"}
      ]
    }'
  ```

  ```python Python theme={null}
  from openai import OpenAI

  client = OpenAI(
      base_url="https://sub2api.ruilinlu.com/v1",
      api_key="YOUR_API_KEY"
  )

  response = client.chat.completions.create(
      model="gemini-2.0-pro",
      messages=[
          {"role": "user", "content": "请用 Python 写一个快速排序算法"}
      ]
  )

  print(response.choices[0].message.content)
  ```
</CodeGroup>

<Note>
  必须准确使用控制台中显示的模型标识符字符串。Gemini 模型在不同版本之间可能有细微的名称差异，请核对后使用。
</Note>

## Gemini 独有特性

* **超长上下文**：Gemini 1.5 系列支持百万级 Token 的上下文窗口，可处理整本书籍或长视频
* **多语言优势**：在非英语语言（包括中文）的理解和生成上表现优异
* **代码能力**：在代码生成、解释和调试方面被广泛认可
* **多模态**：原生支持文本、图像、音频和视频输入

## 原生 Gemini API

除了 OpenAI 兼容格式，Sub2API 也支持通过 [Gemini API](/api/gemini) 形式调用，提供更接近原生的体验。如需了解详细用法，请查看相关 API 文档。

```python Python theme={null}
from openai import OpenAI

client = OpenAI(
    base_url="https://sub2api.ruilinlu.com/v1",
    api_key="YOUR_API_KEY"
)

# Gemini 模型适合处理中文内容
response = client.chat.completions.create(
    model="gemini-2.0-pro",
    messages=[
        {"role": "user", "content": "请将以下内容翻译成地道的中文..."}
    ]
)

print(response.choices[0].message.content)
```