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 ilk Gemini API isteğinizi nasıl oluşturacağı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

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

Go

go get komutunu kullanarak modül dizininize google.golang.org/genai adresini yükleyin:

go get google.golang.org/genai

Java

Maven kullanıyorsanız bağımlılıklarınıza aşağıdakileri ekleyerek google-genai'yi yükleyebilirsiniz:

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

C#

dotnet add komutunu kullanarak modül dizininize googleapis/go-genai'yi yükleyin.

dotnet add package Google.GenAI

Apps Komut Dosyası

  1. Yeni bir Apps Komut Dosyası projesi oluşturmak için script.new adresine gidin.
  2. Başlıksız proje'yi tıklayın.
  3. Apps Komut Dosyası projesini AI Studio olarak yeniden adlandırın ve Yeniden adlandır'ı tıklayın.
  4. API anahtarınızı ayarlayın.
    1. Sol tarafta Proje Ayarları'nı Proje ayarları simgesi tıklayın.
    2. Komut Dosyası Özellikleri bölümünde Komut dosyası özelliği ekle'yi tıklayın.
    3. Property (Mülk) alanına anahtar adını girin: GEMINI_API_KEY.
    4. Değer için API anahtarının değerini girin.
    5. Komut dosyası özelliklerini kaydet'i tıklayın.
  5. Code.gs dosyasının içeriğini aşağıdaki kodla değiştirin:

İ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 2.5 Flash modelini kullanarak Gemini API'ye istek göndermek için generateContent yöntemi 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.

Python

from google import genai

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

response = client.models.generate_content(
    model="gemini-3-flash-preview", contents="Explain how AI works in a few words"
)
print(response.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 response = await ai.models.generateContent({
    model: "gemini-3-flash-preview",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Go

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-3-flash-preview",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

Java

package com.example;

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    Client client = new Client();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-3-flash-preview",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

C#

using System.Threading.Tasks;
using Google.GenAI;
using Google.GenAI.Types;

public class GenerateContentSimpleText {
  public static async Task main() {
    // The client gets the API key from the environment variable `GOOGLE_API_KEY`.
    var client = new Client();
    var response = await client.Models.GenerateContentAsync(
      model: "gemini-3-flash-preview", contents: "Explain how AI works in a few words"
    );
    Console.WriteLine(response.Candidates[0].Content.Parts[0].Text);
  }
}

Apps Komut Dosyası

// See https://developers.google.com/apps-script/guides/properties
// for instructions on how to set the API key.
const apiKey = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
function main() {
  const payload = {
    contents: [
      {
        parts: [
          { text: 'Explain how AI works in a few words' },
        ],
      },
    ],
  };

  const url = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent';
  const options = {
    method: 'POST',
    contentType: 'application/json',
    headers: {
      'x-goog-api-key': apiKey,
    },
    payload: JSON.stringify(payload)
  };

  const response = UrlFetchApp.fetch(url, options);
  const data = JSON.parse(response);
  const content = data['candidates'][0]['content']['parts'][0]['text'];
  console.log(content);
}

REST

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "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: