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
| Summary | Verified value |
|---|---|
| Lowest input price model | Gemini 2.5 Flash Preview TTS |
| Input price | Free per 1M tokens |
| Output price | Free per 1M tokens |
| Free access | Selected 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 | Official identifier | Modalities | Context tokens | Input USD / 1M | Output USD / 1M | Status |
|---|---|---|---|---|---|---|
| Gemini 2.5 Computer Use Preview | gemini-2.5-computer-use-preview-10-2025 | text | 131,072 | $1.25 | $10 | Active |
| Gemini 2.5 Flash | gemini-2.5-flash | text | 1,048,576 | $0.3 | $2.5 | Active |
| Gemini 2.5 Flash Preview TTS | gemini-2.5-flash-preview-tts | text | 8,192 | Free | Free | Active |
| Gemini 2.5 Flash-Lite | gemini-2.5-flash-lite | text | 1,048,576 | $0.1 | $0.4 | Active |
| Gemini 2.5 Pro | gemini-2.5-pro | text | 1,048,576 | $1.25 | $10 | Active |
| Gemini 3 Flash Preview | gemini-3-flash-preview | text | 1,048,576 | $0.5 | $3 | Active |
| Gemini 3 Pro Image (Nano Banana Pro) 🍌 | gemini-3-pro-image | text | 131,072 | $2 | $12 | Active |
| Gemini 3.1 Flash Image (Nano Banana 2) 🍌 | gemini-3.1-flash-image | text | 65,536 | $0.5 | $3 | Active |
| Gemini 3.1 Flash Lite Image (Nano Banana 2 Lite) 🍌 | gemini-3.1-flash-lite-image | text | 65,536 | $0.25 | $1.5 | Active |
| Gemini 3.1 Flash TTS Preview | gemini-3.1-flash-tts-preview | text | 8,192 | Free | Free | Active |
| Gemini 3.1 Flash-Lite | gemini-3.1-flash-lite | text | 1,048,576 | $0.25 | $1.5 | Active |
| Gemini 3.1 Pro Preview | gemini-3.1-pro-preview | text | 1,048,576 | $2 | $12 | Active |
| Gemini 3.5 Flash | gemini-3.5-flash | text | 1,048,576 | $1.5 | $9 | Active |
| Gemini 3.5 Flash-Lite | gemini-3.5-flash-lite | text | 1,048,576 | $0.3 | $2.5 | Active |
| Gemini 3.5 Live Translate | gemini-3.5-live-translate-preview | text | 16,384 | Free | Free | Active |
| Gemini 3.5 Transcribe | gemini-3.5-transcribe | text | 98,304 | Free | Free | Active |
| Gemini 3.5 Transcribe Live | gemini-3.5-transcribe-live | text | 131,072 | Free | Free | Active |
| Gemini 3.6 Flash | gemini-3.6-flash | text | 1,048,576 | $0.75 | $3.75 | Active |
| Gemini 3.7 Flash | gemini-3.7-flash | text | 1,048,576 | $0.75 | $3.75 | Active |
| Gemini 3.8 Flash | gemini-3.8-flash | text | 1,048,576 | $0.75 | $3.75 | Active |
| Gemini Omni Flash | gemini-omni-1.1-flash | text | 131,072 | $1.5 | $9 | Active |
| Gemini Omni Flash Preview | gemini-omni-flash-preview | text | 131,072 | $1.5 | $9 | Active |
Last verified · Source ↗
Explore the Google API model guide.
Free tier and how to get a key
| Condition | Verified details |
|---|---|
| Current terms | Selected 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 models | gemini-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
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
- Google · Gemini 2.5 Computer Use Preview — MetadataModel: Gemini 2.5 Computer Use Preview 10-2025 → Model: Gemini 2.5 Computer Use PreviewSource ↗
- Google · Gemini 2.5 Flash Image (Nano Banana) 🍌 — MetadataModel: Nano Banana → Model: Gemini 2.5 Flash Image (Nano Banana) 🍌Source ↗
- Google · Gemini 3 Pro Image (Nano Banana Pro) 🍌 — MetadataModel: Nano Banana Pro → Model: Gemini 3 Pro Image (Nano Banana Pro) 🍌Source ↗
- 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 ↗
- Google · Gemini 3.1 Flash Image (Nano Banana 2) 🍌 — MetadataModel: Nano Banana 2 → Model: Gemini 3.1 Flash Image (Nano Banana 2) 🍌Source ↗
- Google · Gemini Omni Flash — MetadataModel: Gemini Omni 1.1 Flash → Model: Gemini Omni FlashSource ↗
- Google · Gemini 3.1 Flash-Lite — MetadataModel: Gemini 3.1 Flash Lite → Model: Gemini 3.1 Flash-LiteSource ↗
- Google · Gemini 3.5 Flash-Lite — MetadataModel: Gemini 3.5 Flash Lite → Model: Gemini 3.5 Flash-LiteSource ↗
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?
Do separate keys create separate project capacity?
Where should I inspect model availability?
Can I assume a free tier covers every modality?
How do I troubleshoot a key that used to work?
Sources
- Gemini API getting started ↗
- Gemini models ↗
- Developer API pricing ↗
- Rate limits ↗
- API-key management ↗
- API errors ↗
- Troubleshooting ↗
- Billing ↗
- Context caching ↗
- Batch API ↗
- Python SDK reference ↗
Last verified · Source ↗