DEV Community

Phil IPS
Phil IPS

Posted on

Getting Started with the Gemini API: A 500-Word Tutorial

#python #api #ai #tutorial

Getting Started with the Gemini API

The Gemini API provides access to Google's powerful language models. This tutorial will guide you through the essential steps to start using the API in your projects.

1. Obtain an API Key

  1. Go to the Google AI Platform console.
  2. Create a new project or select an existing one.
  3. Enable the Generative Language API.
  4. Generate an API key and keep it secure.

2. Set Up Your Environment

Install the required Python package:

pip install google-generativeai
Enter fullscreen mode Exit fullscreen mode

Set your API key as an environment variable:

import os
os.environ["GOOGLE_API_KEY"] = "YOUR_API_KEY"
Enter fullscreen mode Exit fullscreen mode

3. Initialize the Client 

import google.generativeai as genai

model = genai.GenModel("gemini-1.5-pro")
Enter fullscreen mode Exit fullscreen mode

4. Make a Completion Request

Create a prompt and generate text:

prompt = "Explain quantum computing in simple terms."
response = model.generate(prompt)
print(response.text)
Enter fullscreen mode Exit fullscreen mode

The generate method returns a Generation object. The text attribute contains the model's output.

5. Handle the Response

Access the generated text and usage information:

print(response.text)          # Generated content
print(response.usage)         # Token usage and cost
print(response.model)         # Model name
Enter fullscreen mode Exit fullscreen mode

6. Manage Costs

The API charges per million tokens. Monitor your usage to control costs. The free tier includes a limited number of tokens each month.

7. Error Handling

Network issues or invalid requests may raise exceptions. Use try/except blocks:

try:
    response = model.generate(prompt)
except Exception as e:
    print(f"Error: {e}")
Enter fullscreen mode Exit fullscreen mode

8. Next Steps

  • Try different models like gemini-1.5-ultra for higher quality.
  • Use the API for chat completions, embeddings, or batch requests.
  • Integrate into web apps, bots, or data pipelines.

Conclusion

The Gemini API is easy to use and offers powerful capabilities. Follow these steps to start building AI applications today.

📦 Want the production-ready version?

This article covers the fundamentals. The AI Agent Architecture Patterns Library pack goes further — agent architecture, tool design and production guardrails, plus full source code and deployment configs.

→ Get AI Agent Architecture Patterns Library

Extracted from real production systems, not toy examples.

Top comments (0)