← Help Center
🔵

Connect Gemini (Google): screen-by-screen guide

Time: 5 to 10 minutes with your Google account. Cost: there is a free tier (with low limits) and the paid tier with prepaid credits (minimum US$ 5, valid for 12 months, non-refundable).

Free or paid? On the free tier, Google may use the questions and answers to improve its products, and usage limits are low. To serve customers, use the paid tier (Screen 4): your data is no longer used for training and the limits go up. Google Cloud’s US$ 300 welcome credit does not apply to Gemini.

Screen 1 — Open Google AI Studio

1. Go to aistudio.google.com/api-keys and sign in with your Google account.

2. Accept the terms on first access.

Google Workspace account (company email)? Access is enabled by default, but your admin may have turned it off. If you see "you do not have access to Google AI Studio", ask your Workspace admin to turn AI Studio on.

Screen 2 — Project

Every key belongs to a Google Cloud project — that is where billing and limits live.

  • First access: AI Studio already creates a default project and a key for you.
  • Already use Google Cloud? Your projects do not show up on their own. Go to Dashboard → Projects → Import projects, find the project and click Import.
  • Recommended: use a project just for your customer-service AI (e.g. "support-ai"). That keeps spending and limits separate from your other systems.

Screen 3 — Create the key ("Create a new key")

1. On the API Keys page, click Create API key.

2. The "Create a new key" window opens:

  • Name the key: change "Gemini API Key" to Blocks2Work (so you know what it is for).
  • Choose an imported project: pick the project from Screen 2. If the list is empty or the project is missing, import it first (Screen 2).

3. Click Create key.

4. In the list, click the new key and the copy icon.

Seeing "You do not have permission to create a key in this project"? You lack permission on the project. Ask the project admin (Editor role) or create a new project.

Screen 4 — Turn on the paid tier (recommended)

1. In the key list (or in Projects), look at the project’s Billing Tier column. If it says Free, click Set up billing.

2. First time on Google Cloud? Choose your country, accept the terms and enter contact details and a card. Already have a billing account? Choose an existing one or Add new billing account.

3. Make the prepaid purchase (minimum US$ 5). Some accounts can choose between Prepay and Postpay (invoice at the end of the month).

4. At aistudio.google.com/billing, turn on Setup auto-reload and set a monthly recharge limit.

5. Optional: at aistudio.google.com/spend → Monthly spend cap → Edit spend cap, set a spending cap for the project.

When the prepaid balance hits zero, all keys on that billing account stop immediately (error 402) — AI conversations go to the team until you top up. That is why auto-reload is worth turning on.

Last screen: paste the key into Blocks2Work

1. In Blocks2Work, open Settings → Integrations and scroll to Artificial intelligence (or use the Connect my AI account button).

2. Choose the provider and paste the key into the API key field.

3. Keep the "fast and cheap" model (ideal for customer service) and adjust the daily answer limit — it protects your spending.

4. Click Test and connect. We test the key right away: if it shows connected in green, you are all set.

The key is stored encrypted and is not shown again. Only the account owner or an admin can connect it.

Privacy

Messages the AI agent answers are sent to the chosen provider to generate the reply, under the terms of your account with that provider. Do not put anything in "Business information" that cannot be said to a customer.

Getting an error?

  • 402 / no credits ("No credits"): the prepaid balance ran out — buy credits or turn on auto-reload (Screen 4).
  • 429 / quota: free-tier limit reached — turn on the paid tier (Screen 4) or wait.
  • 403 / permission / key blocked: the key is restricted to another API or was blocked. Create a new key in AI Studio.
  • "Set up Prepay" in the billing column: the billing account exists but needs the prepaid purchase to work.
  • A Google Cloud account with overdue payments on other services also suspends Gemini, even with credit.

Still need help?

Email [email protected] with a screenshot (if there is an error). We reply within 1 business day.


Last updated: 2026-10-31

Did this article help? If you need more detail, write to [email protected].