Google Gemini 2.0 Flash API Python Kurulumu: Tam Rehber (2025)

Gereksinimler / Requirements

# Python 3.9 veya üstü gerekli / requires Python 3.9+
python --version

# Çıktı: Python 3.9+ olmalı
# Output: should be Python 3.9+

SDK Kurulumu / SDK Installation

# pip ile kurulum / install with pip
pip install google-genai

# Versiyon kontrolü / check version
pip show google-genai

# Çıktı (output): google-genai 0.6.0+ olmalı

Aralık 2025 itibariyle (as of December 2025) google-genai GA (General Availability) versiyona ulaştı.

Adım 1: Google AI Studio'ya Git / Go to Google AI Studio

1. Tarayıcıda aç / open in browser:
   https://aistudio.google.com/apikey

2. Google hesabınızla giriş yapın / sign in with Google account

3. "Create API Key" butonuna tıklayın / click button

4. API key'i kopyalayın / copy the API key
   → ya-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx formatında

Adım 2: Environment Variable Ayarla / Set Environment Variable

# Linux/macOS
export GOOGLE_API_KEY="your-api-key-here"

# Windows (PowerShell)
$env:GOOGLE_API_KEY="your-api-key-here"

# Windows (CMD)
set GOOGLE_API_KEY=your-api-key-here

# .env dosyasında (önerilir / recommended)
# .env file
GOOGLE_API_KEY=your-api-key-here

alestaweb.com'da environment variable yönetimi rehberimiz var.

Basit Chat Örneği / Simple Chat Example

import os
from google import genai

# API key'i environment variable'dan al / get from env var
api_key = os.environ.get("GOOGLE_API_KEY")
client = genai.Client(api_key=api_key)

# Gemini 2.0 Flash modeli / model
model_id = "gemini-2.0-flash-exp"

# Chat başlat / start chat
response = client.models.generate_content(
    model=model_id,
    contents="Python ile web scraping nasıl yapılır?"
)

print(response.text)

Bu basit örnek (this simple example) tek seferlik soru-cevap yapar (does one-time Q&A).

Conversation History ile Chat (Chat with History)

from google import genai

client = genai.Client(api_key=os.environ.get("GOOGLE_API_KEY"))

# Chat oturumu başlat / start chat session
chat = client.chats.create(model="gemini-2.0-flash-exp")

# İlk mesaj / first message
response1 = chat.send_message("Python'da list comprehension nedir?")
print("AI:", response1.text)

# Follow-up soru (chat geçmişi hatırlanır / history is remembered)
response2 = chat.send_message("Örnek verir misin?")
print("AI:", response2.text)

# Bir örnek daha / another follow-up
response3 = chat.send_message("Bu örneği açıkla")
print("AI:", response3.text)

Chat session, conversation history tutar (maintains conversation history). Her yeni mesaj (each new message) önceki context'i bilir.

Görsel Analizi Örneği / Image Analysis Example

from google import genai
import PIL.Image

client = genai.Client(api_key=os.environ.get("GOOGLE_API_KEY"))

# Görseli yükle / load image
image = PIL.Image.open("diagram.png")

# Görsel + metin prompt / image + text prompt
response = client.models.generate_content(
    model="gemini-2.0-flash-exp",
    contents=[
        "Bu diyagramdaki mimariyi açıkla ve iyileştirme önerileri sun:",
        image
    ]
)

print(response.text)

Bu özellik (this feature) diagram analizi, code screenshot'larını okuma (reading code screenshots), chart analizi için harika.

URL'den Görsel Analizi / Image Analysis from URL

response = client.models.generate_content(
    model="gemini-2.0-flash-exp",
    contents=[
        {
            "text": "Bu görseldeki hata nedir?",
            "inline_data": {
                "mime_type": "image/jpeg",
                "data": requests.get("https://example.com/error.jpg").content
            }
        }
    ]
)

print(response.text)

Code Execution Örneği / Code Execution Example

from google import genai

client = genai.Client(api_key=os.environ.get("GOOGLE_API_KEY"))

# Code execution aktif / enabled
response = client.models.generate_content(
    model="gemini-2.0-flash-exp",
    contents="1'den 100'e kadar asal sayıları bul ve grafik çiz",
    config={
        "tools": [{"code_execution": {}}]  # Code execution tool
    }
)

print(response.text)

Gemini, Python kodu yazacak (will write Python code), çalıştıracak (execute) ve sonucu gösterecek (show result). Grafik bile oluşturabilir (can even create graphs)!

Google Search Örneği / Google Search Example

from google import genai

client = genai.Client(api_key=os.environ.get("GOOGLE_API_KEY"))

# Google Search tool ekleme / add Google Search tool
response = client.models.generate_content(
    model="gemini-2.0-flash-exp",
    contents="Python 3.13'ün yeni özellikleri neler? (2025)",
    config={
        "tools": [{"google_search": {}}]  # Google Search tool
    }
)

print(response.text)

Bu özellik (this feature), en güncel bilgileri almak için kritik (critical for getting latest info). Model'in knowledge cutoff'unu aşar (bypasses model's knowledge cutoff).

1. Efficient Prompting (Verimli Prompt Yazma)

# ❌ Verimsiz prompt / inefficient
"Python öğretir misin?"

# ✅ Verimli prompt / efficient
"Python'da list comprehension'ı açıkla.
3 örnek ver: basit, orta, ileri seviye.
Her örnekten sonra açıklama ekle."

Spesifik ve yapılandırılmış promptlar (specific and structured prompts) daha iyi sonuç verir.

2. Error Handling (Hata Yönetimi)

from google import genai
from google.api_core import exceptions

try:
    response = client.models.generate_content(
        model="gemini-2.0-flash-exp",
        contents="Your prompt here"
    )
    print(response.text)

except exceptions.ResourceExhausted:
    print("Rate limit aşıldı! / Rate limit exceeded!")

except exceptions.InvalidArgument:
    print("Geçersiz prompt! / Invalid prompt!")

except Exception as e:
    print(f"Hata / Error: {e}")

3. Safety Settings (Güvenlik Ayarları)

from google.genai import types

response = client.models.generate_content(
    model="gemini-2.0-flash-exp",
    contents="Your prompt",
    config={
        "safety_settings": [
            {
                "category": "HARM_CATEGORY_HATE_SPEECH",
                "threshold": "BLOCK_MEDIUM_AND_ABOVE"
            },
            {
                "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
                "threshold": "BLOCK_MEDIUM_AND_ABOVE"
            }
        ]
    }
)

Production'da safety filters kullanın (use safety filters in production).