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

# Gemini 2.5 Pro

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

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

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

## 核心能力

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

## 快速示例

### Gemini 原生 API

**cURL**

```bash theme={null}
curl "https://api.mixroute.ai/v1/models/gemini-2.5-pro: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
  }
}'
```

**Python**

```python theme={null}
import requests

response = requests.post(
    "https://api.mixroute.ai/v1/models/gemini-2.5-pro: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())
```

### OpenAI 兼容 API

**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-pro",
  "messages": [
    {
      "role": "user",
      "content": "Explain quantum entanglement in simple terms."
    }
  ],
  "max_tokens": 256
}'
```

**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-pro",
    messages=[{"role": "user", "content": "Explain quantum entanglement in simple terms."}],
    max_tokens=256,
)

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

**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-pro",
    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="")
```

## 参数

### Gemini 原生 API

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

### OpenAI 兼容 API

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


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