Google Gemini API
  1. models
Google Gemini API
  • Get API key
  • Release notes
  • Libraries
  • Run Gemini on Google Cloud
  • Model Capabilities
    • Overview
    • Long context
    • Structured output
    • Document understanding
    • Image understanding
    • Video understanding
    • Audio understanding
    • Text generation
      • Text input
      • Image input
      • Streaming output
      • Multi-turn conversations
      • Multi-turn conversations (Streaming)
      • Configuration parameters
    • Generate images
      • Generate images using Gemini
      • Image editing with Gemini
      • Generate images using Imagen 3
    • Gemini thinking
      • Use thinking models
      • Set budget on thinking models
    • Function calling
      • Function Calling with the Gemini API
  • models
    • All Model
    • Pricing
    • Rate limits
    • Billing info
  • Safety
    • Safety settings
    • Safety guidance
  1. models

Billing info

This guide provides an overview of different Gemini API billing options, explains how to enable billing and monitor usage, and provides answers to frequently asked questions (FAQs) about billing.
Upgrade to the Gemini API paid tier

About billing#

Billing for the Gemini API is based on two pricing tiers: free of charge (or free) and pay-as-you-go (or paid). Pricing and rate limits differ between these tiers and also vary by model. You can check out the rate limits and pricing pages for more into. For a model-by-model breakdown of capabilities, see the Gemini models page.

How to request an upgrade#

The Gemini API uses Cloud Billing for all billing services. To transition from the Free tier to a paid tier, you must first enable Cloud Billing for your Google Cloud project.
When your project meets the specified criteria, it becomes eligible for an upgrade to the next tier. To request an upgrade, follow these steps:
1.
Go to the AI Studio API keys page.
2.
Find the project you want to upgrade and click Upgrade.
3.
The system will automatically verify your project's eligibility. This process takes a few seconds.
4.
If your project meets all the requirements, it will be instantly upgraded to the next tier.

Why use the paid tier?#

When you enable billing and use the paid tier, you benefit from higher rate limits, and your prompts and responses aren't used to improve Google products. For more information on data use for paid services, see the terms of service.

Cloud Billing#

The Gemini API uses Cloud Billing for billing services. To use the paid tier, you must set up Cloud Billing on your cloud project. After you've enabled Cloud Billing, you can use Cloud Billing tools to track spending, understand costs, make payments, and access Cloud Billing support.

Enable billing#

You can enable Cloud Billing starting from Google AI Studio:
1.
Open Google AI Studio.
2.
In the bottom of the left sidebar, select Settings > Plan information.
3.
Click Set up Billing for your chosen project to enable Cloud Billing.

Monitor usage#

After you enable Cloud Billing, you can monitor your usage of the Gemini API in the Google Cloud console. The service name for the API is generativelanguage.googleapis.com, and in the console the Gemini API is also referred to as the Generative Language API.
Cloud console
To learn more, see the Google Cloud documentation on monitoring API usage.

Frequently asked questions#

This section provides answers to frequently asked questions.

What am I billed for?#

Gemini API pricing is based on the following:
Input token count
Output token count
Cached token count
Cached token storage duration
For pricing information, see the pricing page.

Where can I view my quota?#

You can view your quota and system limits in the Google Cloud console.

How do I request more quota?#

To request more quota, follow the instructions at How to request an upgrade.

Can I use the Gemini API for free in EEA (including EU), the UK, and CH?#

Yes, we make the free tier and paid tier available in many regions.

If I set up billing with the Gemini API, will I be charged for my Google AI Studio usage?#

No, Google AI Studio usage remains free of charge regardless of if you set up billing across all supported regions.

Can I use 1M tokens in the free tier?#

The free tier for Gemini API differs based on the model selected. For now, you can try the 1M token context window in the following ways:
In Google AI Studio
With pay-as-you-go plans
With free-of-charge plans for select models
See the latest free-of-charge rate limits per model on rate limits page.

How can I calculate the number of tokens I'm using?#

Use the GenerativeModel.count_tokens method to count the number of tokens. Refer to the Tokens guide to learn more about tokens.

Can I use my Google Cloud credits with the Gemini API?#

Yes, Google Cloud credits can be used towards Gemini API usage.

How is billing handled?#

Billing for the Gemini API is handled by the Cloud Billing system.

Am I charged for failed requests?#

If your request fails with a 400 or 500 error, you won't be charged for the tokens used. However, the request will still count against your quota.

Is there a charge for fine-tuning the models?#

Model tuning is free, but inference on tuned models is charged at the same rate as the base models.

Is GetTokens billed?#

Requests to the GetTokens API are not billed, and they don't count against inference quota.

How is my Google AI Studio data handled if I have a paid API account?#

Refer to the terms for details on how data is handled when Cloud billing is enabled (see "How Google Uses Your Data" under "Paid Services"). Note that your Google AI Studio prompts are treated under the same "Paid Services" terms so long as at least 1 API project has billing enabled, which you can validate on the Gemini API Key page if you see any projects marked as "Paid" under "Plan".

Where can I get help with billing?#

To get help with billing, see Get Cloud Billing support.
Previous
Rate limits
Next
Safety settings
Built with