Connect Gemini API model choice to your application’s input, output and project controls. Use this hub to move from Google AI Studio setup to a small, measurable developer integration.

What Google offers through the API

The Gemini Developer API combines model access with Google AI Studio’s project and key management. The current quickstart uses the Google Gen AI SDK and the Interactions interface. Model entries cover text workflows and dedicated media capabilities, so begin with the kind of input and output your application requires. Official documentation.

For a document assistant, write an evaluation that separates reading the supplied document from supplying general background knowledge. A response can sound persuasive while missing the passage that actually answers the question. Save the evidence you expect the model to use and check whether the result preserves it. Add awkward examples such as unclear scans, incomplete tables and unrelated pages before you expand the workflow.

Google’s catalog distinguishes general Gemini models from image, speech, live-audio and other specialized offerings. Nano Banana names refer to documented image-model entries, whose API identifiers should be copied from that catalog. A capability available in one entry should not be assumed for every model carrying the Gemini family name. Official documentation.

Choose an evaluation artifact that matches the output. A generated image needs a visual review, an extracted field needs a known value, and a spoken response needs listening for intelligibility and timing. Do not collapse these into a single text-quality score. Make the input preparation reproducible so you can tell whether a change came from the model, a media conversion step or the instructions.

Gemini API keys belong to Cloud projects, and the current key documentation distinguishes authorization keys from older standard keys. Project access, billing and restrictions therefore belong in the setup checklist. A key that exists in a console is not sufficient evidence that every deployed environment can use it. Official documentation.

Keep a small operational record for each project: the application owner, approved input types, selected model identifier, billing contact and failure behavior. If the application receives private documents, decide how they are removed from debugging artifacts. An integration is easier to maintain when a developer can reproduce a failure without needing the original confidential file.

This hub links the technical and operational questions. The key guide follows the project setup path; Models explains how to narrow the catalog; Pricing keeps token and media charges separate. Rate limits covers capacity by project, while Errors helps distinguish a request-shape problem from access or service pressure. The Python tutorial keeps the first call small and prints diagnostics instead of hiding exceptions.

After the first successful call, preserve a baseline before adding conversation state, grounding or asynchronous work. Introduce each feature deliberately and record what changed in accepted results and usage. If the application needs a capability that the current interface does not provide, check the corresponding provider guide before substituting another interface. Similar naming is not proof that request fields or response handling are interchangeable.

Pricing at a glance

Pricing at a glance
SummaryVerified value
Lowest input price modelGemini 2.5 Flash Preview TTS
Input priceFree per 1M tokens
Output priceFree per 1M tokens
Free accessSelected models have a Free Tier in the official pricing table. Paid-only features and use of submitted data follow the terms linked on that page.

Last verified · Source ↗

Read Gemini API pricing for token and media categories.

Models available

Model catalog
ModelOfficial identifierModalitiesContext tokensInput USD / 1MOutput USD / 1MStatus
Gemini 2.5 Computer Use Previewgemini-2.5-computer-use-preview-10-2025text131,072$1.25$10Active
Gemini 2.5 Flashgemini-2.5-flashtext1,048,576$0.3$2.5Active
Gemini 2.5 Flash Preview TTSgemini-2.5-flash-preview-ttstext8,192FreeFreeActive
Gemini 2.5 Flash-Litegemini-2.5-flash-litetext1,048,576$0.1$0.4Active
Gemini 2.5 Progemini-2.5-protext1,048,576$1.25$10Active
Gemini 3 Flash Previewgemini-3-flash-previewtext1,048,576$0.5$3Active
Gemini 3 Pro Image (Nano Banana Pro) 🍌gemini-3-pro-imagetext131,072$2$12Active
Gemini 3.1 Flash Image (Nano Banana 2) 🍌gemini-3.1-flash-imagetext65,536$0.5$3Active
Gemini 3.1 Flash Lite Image (Nano Banana 2 Lite) 🍌gemini-3.1-flash-lite-imagetext65,536$0.25$1.5Active
Gemini 3.1 Flash TTS Previewgemini-3.1-flash-tts-previewtext8,192FreeFreeActive
Gemini 3.1 Flash-Litegemini-3.1-flash-litetext1,048,576$0.25$1.5Active
Gemini 3.1 Pro Previewgemini-3.1-pro-previewtext1,048,576$2$12Active
Gemini 3.5 Flashgemini-3.5-flashtext1,048,576$1.5$9Active
Gemini 3.5 Flash-Litegemini-3.5-flash-litetext1,048,576$0.3$2.5Active
Gemini 3.5 Live Translategemini-3.5-live-translate-previewtext16,384FreeFreeActive
Gemini 3.5 Transcribegemini-3.5-transcribetext98,304FreeFreeActive
Gemini 3.5 Transcribe Livegemini-3.5-transcribe-livetext131,072FreeFreeActive
Gemini 3.6 Flashgemini-3.6-flashtext1,048,576$0.75$3.75Active
Gemini 3.7 Flashgemini-3.7-flashtext1,048,576$0.75$3.75Active
Gemini 3.8 Flashgemini-3.8-flashtext1,048,576$0.75$3.75Active
Gemini Omni Flashgemini-omni-1.1-flashtext131,072$1.5$9Active
Gemini Omni Flash Previewgemini-omni-flash-previewtext131,072$1.5$9Active

Last verified · Source ↗

Explore the Google API model guide.

Free tier and how to get a key

Free access terms
ConditionVerified details
Current termsSelected models have a Free Tier in the official pricing table. Paid-only features and use of submitted data follow the terms linked on that page.
Eligible modelsgemini-3.8-flash, gemini-3.7-flash, gemini-3.6-flash, gemini-3.5-flash, gemini-3.5-live-translate-preview, gemini-3.5-transcribe-live, gemini-3.5-transcribe, gemini-3.5-flash-lite, gemini-3.1-flash-lite, gemini-3.1-flash-tts-preview, gemini-3-flash-preview, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite, gemini-2.5-flash-preview-tts, gemini-robotics-er-2, gemini-robotics-er-2-streaming

Last verified · Source ↗

Follow AI Studio key setup and inspect the model’s free-tier conditions.

Rate limits and tiers

Read Gemini project limits before attaching parallel workers.

Service status

No active AI product incidents listed in the official feed.

Checked 12 Sep 2026 16:15 UTC · Official status ↗

Start in 5 minutes

Run the Google Gen AI Python tutorial.

result = client.interactions.create(model="gemini-3.8-flash", input="Hello", store=False)
print(result.output_text)

Recent changes

  1. Google · Gemini 2.5 Computer Use Preview — MetadataModel: Gemini 2.5 Computer Use Preview 10-2025 → Model: Gemini 2.5 Computer Use PreviewSource ↗
  2. Google · Gemini 2.5 Flash Image (Nano Banana) 🍌 — MetadataModel: Nano Banana → Model: Gemini 2.5 Flash Image (Nano Banana) 🍌Source ↗
  3. Google · Gemini 3 Pro Image (Nano Banana Pro) 🍌 — MetadataModel: Nano Banana Pro → Model: Gemini 3 Pro Image (Nano Banana Pro) 🍌Source ↗
  4. Google · Gemini 3.1 Flash Lite Image (Nano Banana 2 Lite) 🍌 — MetadataModel: Nano Banana 2 Lite → Model: Gemini 3.1 Flash Lite Image (Nano Banana 2 Lite) 🍌Source ↗
  5. Google · Gemini 3.1 Flash Image (Nano Banana 2) 🍌 — MetadataModel: Nano Banana 2 → Model: Gemini 3.1 Flash Image (Nano Banana 2) 🍌Source ↗
  6. Google · Gemini Omni Flash — MetadataModel: Gemini Omni 1.1 Flash → Model: Gemini Omni FlashSource ↗
  7. Google · Gemini 3.1 Flash-Lite — MetadataModel: Gemini 3.1 Flash Lite → Model: Gemini 3.1 Flash-LiteSource ↗
  8. Google · Gemini 3.5 Flash-Lite — MetadataModel: Gemini 3.5 Flash Lite → Model: Gemini 3.5 Flash-LiteSource ↗

Subscribe to the changelog RSS feed

Use the AI API cost calculator to turn the model and workload you are considering into an estimate.

Last verified · Source ↗

Frequently asked questions

Which Gemini client does the tutorial use?
The official google-genai Python package and its Interactions interface. Official documentation.
Do separate keys create separate project capacity?
No. The rate-limit documentation applies quotas per project. Official documentation.
Where should I inspect model availability?
Use the current model catalog and the access available to your project. Official documentation.
Can I assume a free tier covers every modality?
No. Check the specific model and feature columns in the pricing reference. Official documentation.
How do I troubleshoot a key that used to work?
Inspect key type, restrictions and project access in the current API-key guide. Official documentation.

Sources

Last verified · Source ↗