Google()

Gemini models direct from Google, with your own API key. Costs go direct to the vendor at their rates — no markup, nothing on your Axon balance.

export default defineProfile({
    providers: [Google()],
})

Serves google/*, Gemini only.

Credentials

Set the environment variable, or pass key on the declaration:

GOOGLE_GENERATIVE_AI_API_KEY=...

providers: [Google({ key: process.env.MY_OWN_VAR })]

You can also store this key in your Axon account vault through the cloud client:

await cloud.user.vault.connections.get("google").connect({ key: apiKey })

A fresh host signed into the same account can use the connection. Profiles without an explicit providers list discover active account connections automatically; an explicit list continues to restrict which providers that machine uses.

Explicit keys and environment variables take precedence over the account vault. A custom url requires an explicit credential. Provider SDKs ship with Axon.

Options

Google(options?: ProviderOptions)

Model ids

Bare Gemini slugs:

export default defineAgent({ model: "google:gemini-3.5-flash" })

Gemini only

The google vendor also publishes Gemma weights and the Lyria audio models. Those are not served by the Generative Language API under these ids, so no direct route is offered for them — reach them through OpenRouter() or a local runtime instead.

The variable name

GOOGLE_GENERATIVE_AI_API_KEY, not GOOGLE_API_KEY. It is the name Google's own SDK reads, kept as-is so a working setup elsewhere on your machine works here unchanged.