> ## 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 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

<Tabs>
  <Tab title="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
      }
    }'
    ```
  </Tab>

  <Tab title="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())
    ```
  </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-pro",
      "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-pro",
        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-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="")
    ```
  </Tab>
</Tabs>

## 參數

### 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 相容工具定義。           |