> ## Documentation Index
> Fetch the complete documentation index at: https://thethirdpenco-feat-tool-lifecycle-events.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# google()

> Create a Google Gemini language model

Factory function to create a Google Gemini model instance.

## Signature

```python theme={null}
def google(model_id: str) -> LanguageModel
```

## Parameters

<ParamField path="model_id" type="str" required>
  The Google Gemini model identifier.
</ParamField>

## Returns

A `LanguageModel` instance configured for Google.

## Environment

Requires `GOOGLE_API_KEY` environment variable.

```bash theme={null}
export GOOGLE_API_KEY="..."
```

## Available Models

| Model ID                | Description                             |
| ----------------------- | --------------------------------------- |
| `gemini-3-pro`          | Gemini 3 Pro - most capable             |
| `gemini-3-flash`        | Gemini 3 Flash - fast and powerful      |
| `gemini-2.5-pro`        | Gemini 2.5 Pro - advanced reasoning     |
| `gemini-2.5-flash`      | Gemini 2.5 Flash - balanced performance |
| `gemini-2.5-flash-lite` | Gemini 2.5 Flash-Lite - lightweight     |
| `gemma-3-27b-it`        | Gemma 3 (27B) - open weights            |

## Example

```python theme={null}
from ai_query import generate_text
from ai_query.providers import google

result = await generate_text(
    model=google("gemini-2.5-flash"),
    prompt="Hello, world!"
)
```

## Provider Options

```python theme={null}
result = await generate_text(
    model=google("gemini-2.5-flash"),
    prompt="Be creative.",
    provider_options={
        "google": {
            "temperature": 0.8,
            "max_output_tokens": 2000,
            "top_p": 0.9,
            "top_k": 40,
            "safety_settings": {
                "HARM_CATEGORY_VIOLENCE": "BLOCK_ONLY_HIGH"
            }
        }
    }
)
```
