Skip to main content

Gemini Setup

Prerequisites​

Tip: You will need to set up billing on your Google Cloud account before proceeding. The Gemini API requires an active billing account to generate API keys and make requests.

Google AI Studio Configuration​

  1. Navigate to aistudio.google.com

  2. Sign in with your Google account

  3. Create a new project or select an existing project

  4. Click on "Get API key" in the left sidebar

  5. Click "Create API key"

    • You can create a key in an existing Google Cloud project
    • Or create a new project for the API key

  6. Copy the API Key that is generated

    • Store this securely as you'll need it for your Vodia Voice Agents script
    • The key format will be similar to: AIzaSy...

Billing Setup​

Before you can use the Gemini API, you must enable billing:

  1. Go to console.cloud.google.com

  2. Select your project

  3. Navigate to Billing in the left menu

  4. Link a billing account or create a new one

API Key Usage in Vodia​

Once you have your API key:

  1. Open your Vodia Voice Agents JavaScript file

  2. Replace the placeholder with your actual API key:

    var apiKey = "YOUR_GEMINI_API_KEY"  // Replace with your actual key

  3. Save and deploy your Voice Agents script

Model Availability​

The example scripts use gemini-2.0-flash-exp. Verify this model is available in your region and account:

Rate Limits and Quotas​

Be aware of the following limits:

  • Free tier: Limited requests per minute (check current limits in your console)
  • Paid tier: Higher limits based on your billing account
  • Audio processing: Gemini's real-time audio API has specific quotas

Monitor your usage in the Google Cloud Console under APIs & Services > Dashboard.

Your Gemini integration is now configured and ready to use by your Voice Agents JS script.