Gemini API hızlı başlangıç kılavuzu

Bu hızlı başlangıç kılavuzunda, kitaplıklarımızı nasıl yükleyeceğiniz ve Etkileşimler API'sini kullanarak ilk Gemini API isteğinizi nasıl yapacağınız gösterilmektedir.

Başlamadan önce

Gemini API'yi kullanmak için isteklerinizin kimliğini doğrulayacak, güvenlik sınırlarını uygulayacak ve hesabınızdaki kullanımı izleyecek bir API anahtarına sahip olmanız gerekir.

Başlamak için AI Studio'da ücretsiz olarak bir tane oluşturun:

Gemini API anahtarı oluşturma

Google GenAI SDK'yı yükleme

pip install -q -U google-genai

npm install @google/genai

İlk isteğinizi gönderme

Gemini API'ye istek göndermek için kullanabileceğiniz iki yöntem vardır:

• (Önerilen) Interactions API, çok adımlı araç kullanımı, düzenleme ve türü belirlenmiş yürütme adımları aracılığıyla karmaşık akıl yürütme akışları için yerel destek sunan yeni bir temeldir. Bundan sonra, ana mainline ailesinin ötesindeki yeni modellerin yanı sıra yeni ajan tabanlı yetenekler ve araçları yalnızca Interactions API'de kullanıma sunulacak.
• generateContent, modelden basit ve durum bilgisiz bir yanıt oluşturmanın bir yolunu sunar. Etkileşimler API'sini kullanmanızı önersek de generateContent tamamen desteklenir.

Bu örnekte, Gemini 3 Flash modelini kullanarak Gemini API'ye istek göndermek için Etkileşimler API'si kullanılmaktadır.

API anahtarınızı GEMINI_API_KEY ortam değişkeni olarak ayarlarsanız Gemini API kitaplıkları kullanılırken istemci tarafından otomatik olarak alınır. Aksi takdirde, istemciyi başlatırken API anahtarınızı bağımsız değişken olarak iletmeniz gerekir.

Gemini API belgelerindeki tüm kod örneklerinde GEMINI_API_KEY ortam değişkenini ayarladığınız varsayılır.

# This will only work for SDK newer than 2.0.0
from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

// This will only work for SDK newer than 2.0.0
import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

# Specifies the API revision to avoid breaking changes when they become default
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Durumsuz mod

Varsayılan olarak, previous_interaction_id kullanırken Interactions API, görüşme durumunu sunucu tarafında yönetir. Konuşma geçmişini istemci tarafında kendiniz yönetmeyi tercih ederseniz store=false değerini ayarlayıp sonraki isteklerin input alanında birikmiş adımları ileterek durum bilgisiz modu etkinleştirebilirsiniz.

Ayrıntılı bilgi ve tam çok turlu durum bilgisi içermeyen örnekler için Metin oluşturma kılavuzu'na bakın.

Sırada ne var?

İlk API isteğinizi gönderdiğinize göre, Gemini'ın nasıl çalıştığını gösteren aşağıdaki kılavuzları inceleyebilirsiniz:

• Metin oluşturma
• Görüntü üretme
• Görüntü anlama
• Düşünme (Thinking)
• İşlev çağırma
• Uzun bağlam
• Yerleştirmeler