FeaturesBring Your Own LLM

Google (AI Studio)

Configure jambonz to use Google's Gemini models via AI Studio.

Google AI Studio is the simplest way to use Gemini — sign in with a Google account, get an API key, done. The free tier has generous monthly limits, making this the easiest entry point for prototyping.

If you need enterprise data controls, GCP IAM, or Vertex regional residency, use Vertex AI — Gemini instead. Same models, different infrastructure path.

Get credentials

  1. Sign in at https://aistudio.google.com with your Google account.
  2. Click Get API key in the sidebar (direct link: https://aistudio.google.com/apikey).
  3. Click Create API key, optionally tie it to a Google Cloud project, copy the key.

AI Studio API keys do not expire by default but can be revoked from the same page. Each key is tied to a Google Cloud project for billing purposes.

Configure in jambonz

In the portal: Account → LLM Services → + Add LLM Service → Google Gemini.

API Key
stringRequired

The key from AI Studio.

Click Test to verify.

Use in an agent verb

1session.agent({
2  llm: {
3    vendor: 'google',
4    model: 'gemini-2.5-flash',
5    llmOptions: {
6      systemPrompt: 'You are a helpful voice assistant.',
7    },
8  },
9  stt: { vendor: 'deepgram', language: 'en-US' },
10  tts: { vendor: 'cartesia', voice: 'sonic-english' },
11  turnDetection: 'krisp',
12  bargeIn: { enable: true },
13  actionHook: '/agent-complete',
14}).send();

Available Models

See Google’s Gemini model catalog for the full list and current pricing. Common picks for voice agents:

ModelWhen to use
gemini-2.5-flashDefault for voice — fast, cheap, tool-capable, 1M-token context
gemini-2.5-proHigher reasoning quality
gemini-2.0-flash-liteCheapest option; no vision support

Quirks & errors

google is the AI Studio path, not Vertex. If your organization requires GCP IAM, regional data residency, or pre-paid commitments, you want vertex-gemini instead. The model catalog overlaps but the auth and infra differ.

Free-tier rate limits. AI Studio’s free tier caps requests-per-minute pretty aggressively. For production traffic, upgrade to a paid tier in your Google Cloud billing account or switch to Vertex AI for higher quotas.

400 API_KEY_INVALID — the key has typos or was revoked. Regenerate at aistudio.google.com/apikey.

429 RESOURCE_EXHAUSTED — you’ve hit a per-minute or per-day quota. Switch to a paid tier or distribute traffic across multiple keys.