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).
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.
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.
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.
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