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 API anahtarı gerekir. Başlamak için ücretsiz olarak API anahtarı oluşturabilirsiniz.

Gemini API anahtarı oluşturma

Google GenAI SDK'yı yükleme

Python

Python 3.9+ kullanarak aşağıdaki pip komutunu kullanarak google-genai paketini yükleyin:

pip install -q -U google-genai

JavaScript

Node.js v18+'ı kullanarak aşağıdaki npm komutunu kullanarak TypeScript ve JavaScript için Google Gen AI SDK'yı yükleyin:

npm install @google/genai

İlk isteğinizi gönderme

Aşağıda, Gemini 3 Flash modelini kullanarak Gemini API'ye istek göndermek için Interactions API'nin kullanıldığı bir örnek verilmiştir.

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 dokümanlarındaki tüm kod örneklerinde GEMINI_API_KEY ortam değişkenini ayarladığınız varsayılır.

Python

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)

JavaScript

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();

REST

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

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: