⚠️
This page is not yet translated, showing English version

Gemini (Google) Setup Guide

This guide will help you configure your Google Gemini API Key in Chatbox to use Gemini 1.5 Pro, Gemini 2.0 Flash, and other models.

Gemini Model Features

Gemini is Google's multimodal AI model with these features:

  • Powerful multimodal: Native support for text, images, video, audio
  • Ultra-long context: Gemini 1.5 Pro supports up to 1 million Tokens
  • Fast speed: Flash series has extremely fast response times
  • Free quota: Generous free API call quota available

Getting an API Key

Step 1: Visit Google AI Studio

  1. Visit Google AI Studio
  2. Sign in with your Google account
  3. Accept the terms of service

Step 2: Create an API Key

  1. Click "Get API key" in the left menu
  2. Click "Create API key"
  3. Select or create a Google Cloud project
  4. Copy the generated API Key

Google AI Studio provides free quota, suitable for personal and development testing use.

Paid Usage (Optional)

For higher usage, you can enable the Gemini API in Google Cloud Console and set up a billing account.

Configure in Chatbox

Step 1: Open Settings

  1. Open the Chatbox app
  2. Click the "Settings" entry in the bottom left
  3. Select "AI Provider" or "Model Settings"
💡
On mobile, tap the menu icon (☰) in the top left to open the sidebar first, then tap "Settings".

Step 2: Add Google Gemini

  1. Click "Add Provider"
  2. Select "Google Gemini"
  3. Paste your key in the "API Key" field
  4. Keep API Host as default

Step 3: Select a Model

After saving, you can choose from these models:

ModelFeaturesUse Cases
gemini-2.0-flashLatest Flash model, extremely fastDaily chat, quick responses
gemini-2.0-flash-thinkingFlash with reasoning supportTasks requiring reasoning
gemini-1.5-proMillion-token context, powerfulLong documents, complex analysis
gemini-1.5-flashFast and cheapSimple tasks, high volume

Pricing

Google AI Studio typically provides a free tier, and paid usage is token-based. Exact limits and prices can change by model, tier, and region.

Common Issues

API Key Not Working

Possible causes:

  • Key has been deleted or disabled
  • Free quota limit exceeded
  • Region not supported

Solutions:

  1. Check key status in AI Studio
  2. Check if free quota is exceeded
  3. Generate a new key

"Quota Exceeded" Error

Cause: Free call limit exceeded

Solutions:

  • Wait for quota reset (usually daily)
  • Use Flash models with higher free quota
  • Set up paid account for higher quota

Network Connection Issues

Solutions:

  1. Confirm network can access Google services
  2. Check proxy settings
  3. Try configuring proxy in Chatbox

Multimodal Features

Gemini supports image input. In Chatbox:

  1. Select a Gemini model with vision support
  2. Upload images in the conversation
  3. The model will recognize and analyze image content

Usage Tips

  1. Make the most of free quota:

    • Use gemini-1.5-flash or gemini-2.0-flash for daily use
    • Free quota is sufficient for personal use
  2. Leverage long context:

    • Gemini 1.5 Pro supports 1 million Tokens
    • Great for processing very long documents, codebase analysis
  3. Multimodal scenarios:

    • Image analysis, OCR recognition
    • Chart interpretation, visual Q&A
  4. Monitor quota usage:

    • Check usage in AI Studio
    • Avoid making too many requests in a short time