Quickstart with Gemini API in Python
The Gemini API lets you harness powerful language models for a variety of tasks, from text generation to summarization. This tutorial will walk you through setting up the API, making your first request, and interpreting the response — all in Python.
Prerequisites
- Python 3.8+ installed on your machine.
- pip (Python package installer).
- A Gemini API key (obtainable from the Gemini developer portal).
Installation
Install the official gemini client library:
pip install gemini
Quickstart Code
import gemini
# Initialize the client with your API key
client = gemini.Client(api_key="YOUR_API_KEY_HERE")
# Define the prompt
prompt = "Explain the concept of recursion in simple terms."
# Send the request
response = client.generate(prompt)
# Print the result
print(response.text)
How It Works
-
Client Initialization - The
Clientobject handles authentication and request formatting. - Prompt - The text you want the model to process. Keep it clear and concise.
-
Generation -
client.generate()sends the prompt to the model and returns aResponseobject. -
Response Text - The generated text is accessible via
response.text.
Example Output
If everything is set up correctly, you'll see a short paragraph explaining recursion, e.g.:
Recursion is a programming technique where a function calls itself in order to solve a problem. Each recursive call works on a smaller instance of the problem until it reaches a base case that stops further calls.
Tips
- Rate Limits: The free tier includes a limited number of requests per minute. Monitor your usage to avoid hitting limits.
- Error Handling: Wrap API calls in try/except blocks to gracefully handle network errors or invalid responses.
-
Experiment: Adjust the
temperatureparameter (if using advanced settings) to control randomness in generated text.
Conclusion
You now have a minimal, functional Python script that interacts with the Gemini API. From here, you can build more complex applications, integrate the API into web services, or experiment with different prompts to suit your needs.
Top comments (0)