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

# Google

> Every Gemini and Gemma model Verlon supports — plus quickstart and how to reach them through the SDK you already use.

Gemini 1.5 through 3.5 (chat and reasoning), plus Gemma open-weights and the full multimodal lineup — image, video, TTS, audio, embeddings — all routable through Verlon in whichever SDK you already use. No Google-specific SDK required.

## Chat models

| Model ID                             | Type | Context |
| ------------------------------------ | ---- | ------- |
| `gemini-1.5-pro`                     | chat | 2000K   |
| `gemini-2.5-flash`                   | chat | 1000K   |
| `gemini-2.5-flash-lite`              | chat | 1000K   |
| `gemini-2.5-pro`                     | chat | 1000K   |
| `gemini-3-flash-preview`             | chat | 1000K   |
| `gemini-3.1-flash-lite`              | chat | 1000K   |
| `gemini-3.1-flash-lite-preview`      | chat | 1000K   |
| `gemini-3.1-pro-preview`             | chat | 2000K   |
| `gemini-3.1-pro-preview-customtools` | chat | 2000K   |
| `gemini-3.5-flash`                   | chat | 1049K   |
| `gemini-flash-latest`                | chat | 1000K   |
| `gemini-flash-lite-latest`           | chat | 1000K   |
| `gemini-pro-latest`                  | chat | 2000K   |
| `gemini-robotics-er-1.6-preview`     | chat | 128K    |
| `gemma-4-26b-a4b-it`                 | chat | 262K    |
| `gemma-4-31b-it`                     | chat | 262K    |

<Note>
  This table is auto-generated from the Verlon model registry on every sync — see the [live registry](/provider-compatibility/models#live-registry) for pricing, benchmarks, and deprecation dates.
</Note>

## Other modalities

* **audio** — 6 models
* **embeddings** — 3 models
* **image generation** — 8 models
* **text-to-speech** — 3 models
* **video generation** — 6 models

Non-chat Gemini models are called through the [Verlon SDK](/sdk-reference/overview) using the same model IDs — see the [SDK reference](/sdk-reference/overview) for modality-specific endpoints (`images`, `video`, `audio`, `embeddings`).

## Quickstart

<Note>
  First time? [Create a gate](/platform/gates) and grab an [API key](/getting-started/authentication) — the examples below need a `GATE_ID` and `VERLON_API_KEY`.
</Note>

The fastest path — Verlon SDK, one call:

```typescript theme={null}
import { Verlon } from '@verlon-ai/sdk';

const verlon = new Verlon({ apiKey: process.env.VERLON_API_KEY });

const response = await verlon.chat({
  gateId: process.env.GATE_ID,
  model: 'gemini-2.5-pro', // optional — overrides the gate's configured model
  data: {
    messages: [{ role: 'user', content: 'Hello!' }],
  },
});

console.log(response.content);
```

Any chat model from the table above works — swap `gemini-2.5-pro` for `gemini-3.5-flash`, `gemini-flash-latest`, or any other ID.

## SDK compatibility

The [Verlon SDK](/sdk-reference/overview) is the native path to every model on this page — the [quickstart above](#quickstart) is all it takes. Already on another SDK? Any SDK with a Verlon drop-in endpoint can reach these models too — today that's the [OpenAI SDK](/provider-compatibility/openai) and the [Anthropic SDK](/provider-compatibility/anthropic): point it at Verlon, reference a gate that routes here, and your code stays unchanged.

### Streaming

```typescript theme={null}
for await (const chunk of verlon.chatStream({
  gateId: process.env.GATE_ID,
  data: { messages: [{ role: 'user', content: 'Tell me a joke.' }] },
})) {
  process.stdout.write(chunk.content ?? '');
}
```

## What's supported

<AccordionGroup>
  <Accordion title="Streaming">
    Full support for `stream: true` in every supported SDK — identical semantics to the source SDK.
  </Accordion>

  <Accordion title="Tool / function calling">
    Fully supported. Verlon translates the tool-call shape between OpenAI / Anthropic / Gemini native formats.
  </Accordion>

  <Accordion title="Vision">
    Image inputs work with any vision-capable Gemini model — including the multimodal Gemini 2.5 Flash and Pro lines.
  </Accordion>

  <Accordion title="Standard parameters">
    `temperature`, `max_tokens`, `top_p`, `stop_sequences`, and the rest are passed through and mapped to Gemini's native fields.
  </Accordion>

  <Accordion title="Usage + cost tracking">
    Every response includes token usage plus Verlon's `cost` field with per-call dollar amount.
  </Accordion>
</AccordionGroup>

## How it works

1. **You send** a request in your chosen SDK's format
2. **Verlon receives** — validates the gate, applies routing rules
3. **Verlon translates** to Gemini's native format and dispatches to Google's API
4. **Google responds** with the raw Gemini response
5. **Verlon normalizes** back to your SDK's expected shape (OpenAI, Anthropic, or Verlon-native)
6. **You receive** a response in the format your code already handles, with an added `cost` field

Your existing code doesn't know it's talking to Gemini.

## Errors

| Status | Meaning             | What to check                                                                                        |
| ------ | ------------------- | ---------------------------------------------------------------------------------------------------- |
| `400`  | Invalid request     | Malformed body or missing `gateId`                                                                   |
| `401`  | Invalid API key     | Your `VERLON_API_KEY` value and the `Authorization: Bearer` header                                   |
| `404`  | Gate not found      | Your `GATE_ID` — the error message names the offending ID                                            |
| `429`  | Rate limit exceeded | Back off and retry; the body includes `reset_at`, and every response carries `X-RateLimit-*` headers |

The error shape always matches the SDK you're calling with. Through the Verlon SDK it surfaces as a thrown `Error`:

```typescript theme={null}
try {
  await verlon.chat({
    gateId: process.env.GATE_ID,
    data: { messages: [{ role: 'user', content: 'Hello!' }] },
  });
} catch (error) {
  // error.message carries the API's message,
  // e.g. 'Gate with ID "…" not found'
  console.error(error.message);
}
```

## Full non-chat model list

Every non-chat Google model Verlon routes to, grouped by modality. Chat models are in the table near the top of this page.

### Audio

| Model ID                                        |
| ----------------------------------------------- |
| `gemini-2.5-flash-native-audio-latest`          |
| `gemini-2.5-flash-native-audio-preview-09-2025` |
| `gemini-2.5-flash-native-audio-preview-12-2025` |
| `gemini-3.5-live-translate-preview`             |
| `lyria-3-clip-preview`                          |
| `lyria-3-pro-preview`                           |

### Embeddings

| Model ID                     |
| ---------------------------- |
| `gemini-embedding-001`       |
| `gemini-embedding-2`         |
| `gemini-embedding-2-preview` |

### Image generation

| Model ID                         |
| -------------------------------- |
| `gemini-2.5-flash-image`         |
| `gemini-3-pro-image`             |
| `gemini-3-pro-image-preview`     |
| `gemini-3.1-flash-image`         |
| `gemini-3.1-flash-image-preview` |
| `imagen-4.0-fast-generate-001`   |
| `imagen-4.0-generate-001`        |
| `imagen-4.0-ultra-generate-001`  |

### Text-to-speech

| Model ID                       |
| ------------------------------ |
| `gemini-2.5-flash-preview-tts` |
| `gemini-2.5-pro-preview-tts`   |
| `gemini-3.1-flash-tts-preview` |

### Video generation

| Model ID                        |
| ------------------------------- |
| `veo-2.0-generate-001`          |
| `veo-3.0-fast-generate-001`     |
| `veo-3.0-generate-001`          |
| `veo-3.1-fast-generate-preview` |
| `veo-3.1-generate-preview`      |
| `veo-3.1-lite-generate-preview` |

## Related

* [OpenAI](/provider-compatibility/openai) · [Anthropic](/provider-compatibility/anthropic) · [Mistral](/provider-compatibility/mistral)
* [Verlon SDK reference](/sdk-reference/overview) — one SDK across every provider and modality
* [Gates](/platform/gates) — set up routing rules and model configuration
* [Bring your own key](/platform/byok) — use your own Google account for provider costs
* [Google's Gemini API docs ↗](https://ai.google.dev/gemini-api/docs)