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

# Gemini 2.5 Flash Lite

> Gemini 2.5 Flash Lite：兼顾速度与效率的语言模型。包含 MixRoute 调用示例与参数。

Gemini 2.5 Flash Lite 是 Google 推出的兼顾速度与效率的语言模型。

可通过 MixRoute 的 Gemini 原生端点调用 `gemini-2.5-flash-lite`，同时支持 OpenAI 兼容端点。

## 核心能力

* Gemini 原生 API - 使用 generateContent 与 content parts
* 系统指令 - 支持 systemInstruction
* 生成控制 - 使用 generationConfig
* OpenAI 兼容 - 也可通过 Chat Completions 调用

## 快速示例

### Gemini 原生 API

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.mixroute.ai/v1/models/gemini-2.5-flash-lite:generateContent" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
      "contents": [
        {
          "role": "user",
          "parts": [
            {
              "text": "Explain quantum entanglement in simple terms."
            }
          ]
        }
      ],
      "generationConfig": {
        "temperature": 1,
        "topP": 1
      }
    }'
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import requests

    response = requests.post(
        "https://api.mixroute.ai/v1/models/gemini-2.5-flash-lite:generateContent",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        json={'contents': [{'role': 'user',
                            'parts': [{'text': 'Explain quantum entanglement in simple terms.'}]}],
              'generationConfig': {'temperature': 1, 'topP': 1}},
    )

    print(response.json())
    ```
  </Tab>
</Tabs>

### OpenAI 兼容 API

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.mixroute.ai/v1/chat/completions" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
      "model": "gemini-2.5-flash-lite",
      "messages": [
        {
          "role": "user",
          "content": "Explain quantum entanglement in simple terms."
        }
      ],
      "max_tokens": 256
    }'
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.mixroute.ai/v1")

    response = client.chat.completions.create(
        model="gemini-2.5-flash-lite",
        messages=[{"role": "user", "content": "Explain quantum entanglement in simple terms."}],
        max_tokens=256,
    )

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

  <Tab title="Streaming">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.mixroute.ai/v1")

    stream = client.chat.completions.create(
        model="gemini-2.5-flash-lite",
        messages=[{"role": "user", "content": "Write a short poem about the sea."}],
        max_tokens=256,
        stream=True,
    )

    for chunk in stream:
        print(chunk.choices[0].delta.content or "", end="")
    ```
  </Tab>
</Tabs>

## 参数

### Gemini 原生 API

| 参数                  | 类型     | 必填 | 说明                      |
| ------------------- | ------ | -- | ----------------------- |
| `contents`          | array  | 是  | 由 role 与 parts 组成的对话内容。 |
| `systemInstruction` | object | 否  | 包含内容片段的系统指令。            |
| `generationConfig`  | object | 否  | temperature、topP 等生成参数。 |
| `safetySettings`    | array  | 否  | 内容安全设置。                 |

### OpenAI 兼容 API

| 参数            | 类型              | 必填 | 说明                           |
| ------------- | --------------- | -- | ---------------------------- |
| `model`       | string          | 是  | 固定为 `gemini-2.5-flash-lite`。 |
| `messages`    | array           | 是  | 包含 role 与 content 的对话消息。     |
| `max_tokens`  | integer         | 否  | 最大生成 token 数。                |
| `stream`      | boolean         | 否  | 启用 SSE 流式输出，默认 false。        |
| `temperature` | number          | 否  | 模型支持时用于控制采样随机性。              |
| `top_p`       | number          | 否  | 模型支持时使用的核采样阈值。               |
| `stop`        | string \| array | 否  | 触发停止生成的序列。                   |
| `tools`       | array           | 否  | OpenAI 兼容工具定义。               |