> ## 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 3 Pro Image

> Gemini 3 Pro Image: image generation model. Request examples and parameters for MixRoute.

Gemini 3 Pro Image is an image generation model from Google.

Call `gemini-3-pro-image` through MixRoute's native Gemini endpoint; an OpenAI-compatible endpoint is also supported.

## Key capabilities

* Text-to-image - Produces image output from text
* Native Gemini API - Uses generateContent
* Image output - Requests IMAGE in responseModalities
* Content parts - Supports Gemini multimodal input structure

## Output specifications

| Property        | Value                                           |
| --------------- | ----------------------------------------------- |
| Endpoint        | `/v1/models/gemini-3-pro-image:generateContent` |
| Output modality | `IMAGE`                                         |
| Response        | Image data in Gemini content parts              |

## Quick example

### Gemini native API

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.mixroute.ai/v1/models/gemini-3-pro-image:generateContent" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
      "contents": [
        {
          "parts": [
            {
              "text": "A minimal red circle centered on a white background"
            }
          ]
        }
      ],
      "generationConfig": {
        "responseModalities": [
          "TEXT",
          "IMAGE"
        ]
      }
    }'
    ```
  </Tab>

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

    response = requests.post(
        "https://api.mixroute.ai/v1/models/gemini-3-pro-image:generateContent",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        json={'contents': [{'parts': [{'text': 'A minimal red circle centered on a white '
                                               'background'}]}],
              'generationConfig': {'responseModalities': ['TEXT', 'IMAGE']}},
    )

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

### OpenAI-compatible 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-3-pro-image",
      "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-3-pro-image",
        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-3-pro-image",
        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>

## Parameters

| Parameter                             | Type   | Required | Description                                   |
| ------------------------------------- | ------ | -------- | --------------------------------------------- |
| `contents`                            | array  | Yes      | Prompt and optional multimodal content parts. |
| `generationConfig.responseModalities` | array  | Yes      | Include IMAGE to request image output.        |
| `generationConfig`                    | object | No       | Additional generation settings.               |