{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"entry_sha256":"a05b4e80b6ee01151c93850d1cbac33683c22d552df01698e40d21c8a6b278e0","entry":{"id":"google/gemini-api","name":"Gemini API (Google AI Studio)","vendor":"Google","summary":"Google's Gemini models through the Gemini API, with keys made in Google AI Studio. Every key lives in a Google Cloud project; the free tier works without billing, the paid tier needs a linked Cloud Billing account and prepaid credit.","aliases":["google ai studio","generative language api","gemini key"],"category":"ai","group":"B","homepage":"https://ai.google.dev/","docs":["https://ai.google.dev/gemini-api/docs/api-key","https://ai.google.dev/gemini-api/docs/billing"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"api-key","url":"https://ai.google.dev/gemini-api/docs/api-key","title":"Using Gemini API keys","accessed":"2026-10-25","supports":"Keys created on AI Studio API Keys page; every key belongs to a Cloud project; default project for new users; import existing projects; Project Editor-level IAM needed; GEMINI_API_KEY / GOOGLE_API_KEY (GOOGLE_API_KEY wins); auth keys default since 28 May 2026; unrestricted standard keys rejected; dormant unrestricted keys blocked since 7 May 2026; security advice; limits on projects/keys shown.","kind":"official"},{"id":"billing","url":"https://ai.google.dev/gemini-api/docs/billing","title":"Gemini API billing","accessed":"2026-10-25","supports":"Set up billing from AI Studio; minimum $5 prepay; tiers and spend caps ($250 / $2,000 / $20,000+); tier qualification; prepay 402 at zero balance; tier upgrades within about 10 minutes; Cloud trial credit not usable.","kind":"official"},{"id":"terms","url":"https://ai.google.dev/gemini-api/terms","title":"Gemini API Additional Terms of Service (effective 23 March 2026)","accessed":"2026-10-25","supports":"18+ only; not for under-18 audiences; professional/business use; available regions; Paid Services only for apps offered to EEA/Switzerland/UK users; unpaid content used to improve products with human review; EEA/CH/UK get paid-tier data terms; no competing models; Prohibited Use Policy; no bypassing safety; no clinical use; grounding restrictions.","kind":"official"},{"id":"regions","url":"https://ai.google.dev/gemini-api/docs/available-regions","title":"Available regions for Google AI Studio and Gemini API","accessed":"2026-10-25","supports":"UK, Switzerland, all EU and EEA countries are listed as available.","kind":"official"},{"id":"troubleshooting","url":"https://ai.google.dev/gemini-api/docs/troubleshooting","title":"Gemini API troubleshooting guide","accessed":"2026-10-25","supports":"403 project denied / unpaid balance / leaked key; 429 backoff; 402 depleted prepay; free tier restriction fixed by linking billing.","kind":"official"},{"id":"trial","url":"https://docs.cloud.google.com/free/docs/free-cloud-features","title":"Google Cloud Free Program","accessed":"2026-10-25","supports":"The $300 Cloud Free Trial credit cannot pay for Gemini API in AI Studio.","kind":"official"},{"id":"leaked-keys","url":"https://bleepingcomputer.com/news/security/previously-harmless-google-api-keys-now-expose-gemini-ai-data/","title":"BleepingComputer: Previously harmless Google API keys now expose Gemini AI data","accessed":"2026-10-25","supports":"Researchers reported public Google API keys (e.g. Maps) gaining Gemini access when the API was enabled in the same project; charges and data exposure risk.","kind":"community"}],"allowed_domains":["aistudio.google.com","console.cloud.google.com"],"account_model":{"summary":"Sign in to Google AI Studio with a Google Account. Each API key belongs to a Google Cloud project; new users get a default project and key after accepting the terms. Free tier runs without billing. Paid tier is set per project by linking a Cloud Billing account (google/cloud-billing); spend caps apply at billing account level.","accounts":[{"name":"Google Account","kind":"personal","owned_by":"the person (must be 18 or over)","required":true},{"name":"Cloud project","kind":"project","parent":"Google Account","required":true,"note":"Created automatically for new users, or imported into AI Studio from Cloud console."},{"name":"Cloud Billing account","kind":"billing","parent":"Google Account","required":false,"note":"Needed for the paid tier, and in practice for any app offered to EEA, Swiss or UK users."}],"notes":["Workspace users may need their admin to allow AI Studio [to verify for your domain].","Once a project has an active billing account, AI Studio use under that account counts as a Paid Service for data-use terms."]},"prerequisites":[{"entry":"google/cloud-billing","note":"Only for the paid tier (and required for apps serving EEA/CH/UK users)."}],"have_ready":[{"kind":"payment_card","description":"Payment method for a Cloud Billing account and at least $5 of prepaid credit (paid tier only).","needed_for":["billing"],"auto_check":"none","source":"billing"},{"kind":"other","description":"Confirmation you are 18 or over and that your app is not aimed at under-18s.","why":"The Gemini API terms require both.","needed_for":["accept-terms"],"auto_check":"none","source":"terms"}],"steps":[{"id":"accept-terms","title":"Sign in to Google AI Studio and accept the terms","summary":"Sign in with the Google Account that should own the project and accept the Gemini API terms. New users get a default project and key.","route":"guided","depends_on":[],"gate":"human_terms","url":"https://aistudio.google.com/","sources":["api-key","terms"]},{"id":"import-project","title":"Import an existing Cloud project (optional)","summary":"To use an existing project, open Projects in AI Studio, choose Import projects and select it. You need Editor-level IAM permissions on it.","route":"guided","depends_on":["accept-terms"],"gate":"none","url":"https://aistudio.google.com/projects","recovery":[{"hiccup":"The Create API key button is greyed out.","fix":"Your Google Account lacks IAM permissions on the project (for example Project Editor); ask the project owner or use a project you own.","source":"api-key"}],"optional":true,"sources":["api-key"]},{"id":"create-key","title":"Create an API key","summary":"On the API Keys page create a key in the chosen project. Keys created since 28 May 2026 are auth keys, bound to a service account and limited to the Gemini API by default.","route":"guided","depends_on":["accept-terms"],"gate":"none","url":"https://aistudio.google.com/apikey","recovery":[{"hiccup":"Requests fail because the key is unrestricted or shows a Blocked tag.","fix":"The Gemini API rejects unrestricted standard keys; create a new key (auth key) or restrict the key to the Generative Language API.","source":"api-key"},{"hiccup":"403 \"Your API key was reported as leaked.\"","fix":"Generate a new key, deploy it, disable the old one and audit usage. Never put the key in client-side code or a public repo.","source":"troubleshooting"}],"capture":{"env":"GEMINI_API_KEY","kind":"api_key"},"sources":["api-key"]},{"id":"billing","title":"Upgrade the project to the paid tier","summary":"On API Keys or Projects, choose Set up billing for the project, link a Cloud Billing account and prepay at least $5. New users default to prepay; requests fail with 402 when the balance reaches zero.","route":"guided","depends_on":["create-key"],"gate":"human_payment","url":"https://aistudio.google.com/projects","lead_time":{"official":{"text":"Tier upgrades usually show within 10 minutes of a successful payment; bank transfers can take several days to clear.","source":"billing"}},"recovery":[{"hiccup":"Free tier error even after making a new key.","fix":"Free tier limits are per project; a new key in the same project does not help. Link an active billing account to upgrade.","source":"troubleshooting"},{"hiccup":"HTTP 402 errors.","fix":"Prepay credit is used up; add credits (do not retry automatically).","source":"troubleshooting"},{"hiccup":"403 project denied or unpaid balance.","fix":"Pay any past-due balance in the billing console; access returns automatically.","source":"troubleshooting"},{"hiccup":"Service paused for all projects mid-month.","fix":"The billing account hit its tier spend cap ($250 at Tier 1); it resets on the 1st, or qualify for a higher tier ($100 paid + 3 days for Tier 2).","source":"billing"},{"hiccup":"Expected the $300 Cloud Free Trial to pay for Gemini.","fix":"The Cloud welcome credit cannot be used for the Gemini API or AI Studio; buy prepaid credit.","source":"trial"}],"optional":true,"sources":["billing"]},{"id":"restrict-and-alert","title":"Restrict the key and set alerts","summary":"Optionally add IP restrictions, keep the key server-side (use a backend proxy for web/mobile), store it in a secret manager and set billing alerts.","route":"guided","depends_on":["create-key"],"gate":"none","url":"https://console.cloud.google.com/apis/credentials","optional":true,"sources":["api-key"]}],"outputs":[{"name":"GEMINI_API_KEY","description":"Gemini API key. Client libraries also read GOOGLE_API_KEY, which takes precedence if both are set.","secret":true,"example_format":"AIza… [to verify: auth key prefix]","from_step":"create-key"}],"terms_notes":[{"kind":"rules_say","severity":"red","title":"EEA, Swiss and UK users need the paid tier","text":"You may use only Paid Services when making apps available to users in the EEA, Switzerland or the UK.","source":"terms"},{"kind":"rules_say","severity":"red","title":"Free tier data is used to improve Google products","text":"On unpaid services (AI Studio, unpaid API quota) Google uses prompts and responses to improve its products and human reviewers may read them. Do not send sensitive, confidential or personal data. If you are in the EEA, Switzerland or UK, the paid-tier data terms apply even to free use.","source":"terms"},{"kind":"rules_say","severity":"red","title":"Adults only, no under-18 audiences","text":"You must be 18 or over, and may not use the API in a service directed at or likely to be used by under-18s.","source":"terms"},{"kind":"rules_say","severity":"red","title":"Banned uses","text":"No building competing models, no reverse engineering or extracting models, no bypassing safety filters, no clinical practice or medical advice, and you must follow the Prohibited Use Policy. Agents must not bypass human-confirmation requests.","source":"terms"},{"kind":"rules_say","severity":"amber","title":"Grounding results cannot be stored","text":"Grounding with Google Search results and suggestions may not be cached, resold, analysed, trained on or used to build an index.","source":"terms"},{"kind":"rules_say","severity":"amber","title":"Price changes take effect in 30 days","text":"Google may change pricing effective 30 days after posting; continued use is consent.","source":"terms"},{"kind":"people_report","severity":"amber","title":"Old public keys can reach Gemini","text":"Researchers reported (Feb 2026) that public Google API keys, such as Maps keys in web pages, could call Gemini and run up charges once the Gemini API was enabled in the same project. Use a dedicated project for Gemini.","source":"leaked-keys"}],"pricing_notes":{"free_tier":"Free tier with rate limits per project, no billing needed (content may be used to improve products outside EEA/CH/UK).","costs":"Paid tier billed through Cloud Billing; minimum $5 prepay. Tier spend caps: Tier 1 $250, Tier 2 $2,000 (after $100 paid + 3 days), Tier 3 $20,000 to $100,000+ (after $1,000 paid + 30 days). Per-model token prices on the pricing page.","source":"billing"},"api_provisioning":{"available":"partial","notes":"Keys are Cloud API keys, so they can be created and restricted with the API Keys API or gcloud services api-keys in a project with the Generative Language API enabled [to verify for auth keys]. Accepting terms and billing need a person.","docs":["https://ai.google.dev/gemini-api/docs/api-key"],"source":"api-key"},"detect":{"env_names":["GEMINI_API_KEY","GOOGLE_API_KEY","GOOGLE_GENERATIVE_AI_API_KEY"],"packages":["@google/genai","@google/generative-ai","google-genai","google-generativeai","@ai-sdk/google"]}}}