Gemini API anahtarlarını kullanma

Gemini API'yi kullanmak için isteklerinizin kimliğini doğrulamanız gerekir. Standart veya yetkilendirme API anahtarı kullanarak kimliğinizi doğrulayabilirsiniz.

Gemini API anahtarı oluşturma veya görüntüleme

API anahtarı türleri: Standart ve Yetkilendirme

API anahtarları, Gemini API'ye erişim sağlar ancak güvenlik özellikleri farklıdır. Gemini API, güvenliği artırmak için standart API anahtarlarından yetkilendirme anahtarlarına geçiş yapıyor:

• Standart API anahtarları: Faturalandırma ve kota amacıyla istekleri bir Google Cloud projesiyle ilişkilendirir. Standart anahtarlar, arayanı tanımlamadığı için destekleyebilecekleri izinlerin ve erişim denetiminin ayrıntı düzeyini sınırlar.
• Yetkilendirme (auth) anahtarları: Doğrudan bir Google Cloud hizmet hesabına bağlıdır. Yetkilendirme anahtarı kullandığınızda istekleriniz, bu bağlı hizmet hesabının kimliği altında işlenir ve ayrıntılı erişim kontrolü sağlanır. Yetkilendirme anahtarları varsayılan olarak Generative Language API (Gemini API) ile sınırlıdır ve sistemlerimiz tarafından algılanan sızdırılmış anahtarların kullanımını hızlı bir şekilde durduran, hızlı etkili sızdırılmış anahtar zorunluluğu sağlar.

Gemini API, güvenli kullanımı sağlamak için Standart anahtarlardan Kimlik Doğrulama anahtarlarına geçiş yapacak:

• Varsayılan kimlik doğrulama anahtarları: Google AI Studio'da oluşturulan tüm yeni API anahtarları otomatik olarak kimlik doğrulama anahtarı olarak oluşturulur.
• 19 Haziran 2026'da: Gemini API, sınırsız standart anahtarlardan gelen istekleri reddedecek. Açık kısıtlamalar uygulanmış standart API anahtarları çalışmaya devam eder. Bu kısıtlama, herkese açık olarak paylaşılan veya diğer hizmetlere bağlanan anahtarların yetkisiz kullanımını engeller.
• Eylül 2026'da: Gemini API, standart anahtarlardan gelen istekleri reddedecek. Hizmet kesintisi yaşamamak için bu tarihten önce kimlik doğrulama anahtarlarına geçiş yapmanız gerekir. Eylül 2026'dan önce kimlik doğrulama anahtarlarına geçiş yapmayı unutmayın.

Google AI Studio'da API anahtarlarını yönetme

Projelerinizi ve anahtarlarınızı doğrudan Google AI Studio'da yönetebilirsiniz.

Google Cloud projeleri

Her Gemini API anahtarı bir Google Cloud projesiyle ilişkilendirilir. Google Cloud projeleri faturalandırmayı, ortak çalışanları ve izinleri yönetir. Google AI Studio, bu projelere erişmek için basit bir arayüz sunar.

• Varsayılan proje: Yeni bir kullanıcıysanız Hizmet Şartları'nı kabul ettikten sonra Google AI Studio otomatik olarak varsayılan bir Google Cloud projesi ve API anahtarı oluşturur. Bu projeyi, kontrol panelinizdeki Projeler görünümüne giderek yeniden adlandırabilirsiniz.
• Mevcut projeler: Google Cloud hesabınız varsa AI Studio varsayılan bir proje oluşturmaz. Bunun yerine mevcut projelerinizi içe aktarmanız gerekir.

Projeleri içe aktarma

Google AI Studio, varsayılan olarak tüm Google Cloud projelerinizi göstermez. Kullanmak istediğiniz projeleri içe aktarmanız gerekir:

1. Google AI Studio'ya gidin.
2. Soldaki panelden Kontrol Paneli'ni açın ve Projeler'i seçin.
3. Projeleri içe aktar düğmesini tıklayın.
4. İçe aktarmak istediğiniz Google Cloud projesini arayıp seçin ve İçe aktar'ı tıklayın.
5. İçe aktarma işlemi tamamlandıktan sonra kontrol panelindeki API Anahtarları sayfasına giderek ilgili projede anahtar oluşturun.

Anahtar oluşturma izinleriyle ilgili sorunları giderme

API anahtarı oluştur düğmesi kullanılamıyorsa ve şu mesajı gösteriyorsa: "Bu projede anahtar oluşturma izniniz yok", gerekli IAM izinlerine sahip değilsinizdir.

Google Cloud projenizin veya kuruluş yöneticinizin size aşağıdaki izinleri içeren bir rol (ör. Proje Düzenleyicisi) vermesini isteyin:

• resourcemanager.projects.get: AI Studio'nun projeyi doğrulamasını sağlar.
• apikeys.keys.create: Anahtar oluşturmaya izin verir.
• serviceusage.services.enable: Generative Language API'nin etkinleştirilmesini sağlar.
• iam.serviceAccounts.create: Bağlı hizmet hesabını oluşturmak için gereklidir.
• iam.serviceAccountApiKeyBindings.create: Hizmet hesabını API anahtarına bağlar.

Yönetim erişimi alamıyorsanız anahtarlarınızı oluşturmak için bir kuruluşla ilişkilendirilmemiş yeni bir Google Cloud projesi oluşturabilirsiniz.

Ortamınızı kurma

Anahtarınız olduğunda ortamınızı, uygulamalarınızda güvenli bir şekilde kullanacak şekilde yapılandırın.

Ortam değişkenlerini kullanma (önerilir)

GEMINI_API_KEY veya GOOGLE_API_KEY ortam değişkenini ayarlayın. Gemini API istemci kitaplıkları bu değişkenleri otomatik olarak algılar ve kullanır. İkisi de ayarlanırsa GOOGLE_API_KEY öncelikli olur.

Değişkeni ayarlamak için işletim sisteminizi seçin:

~/.bashrc

touch ~/.bashrc && open ~/.bashrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.bashrc

~/.zshrc

touch ~/.zshrc && open ~/.zshrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.zshrc

API anahtarını kodda açıkça sağlama

İstemciyi başlatırken API anahtarını açıkça iletebilirsiniz. Yalnızca ortam değişkenlerini kullanamıyorsanız bu işlemi yapın.

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Explain how AI works in a few words"
)
print(response.text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3.5-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

package main

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

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        APIKey:  "YOUR_API_KEY",
        Backend: genai.BackendGeminiAPI,
    })
    if err != nil {
        log.Fatal(err)
    }

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

package com.example;

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

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    Client client = Client.builder().apiKey("YOUR_API_KEY").build();

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

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

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent"       -H 'Content-Type: application/json'       -H "x-goog-api-key: YOUR_API_KEY"       -X POST       -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Güvenlik ve gizli anahtar yönetimi

Gemini API anahtarınızı şifre gibi kullanın. Bu anahtarların güvenliği ihlal edilirse diğer kullanıcılar projenizin kotasını kullanabilir, beklenmedik faturalandırma ücretlerine neden olabilir ve özel kaynaklara erişebilir.

Önemli güvenlik kuralları

• Anahtarları gizli tutun: API anahtarlarını asla Git gibi kaynak kontrol sistemlerine işlemeyin.
• Üretimde anahtarları asla istemci tarafında kullanmayın: API anahtarlarını doğrudan web veya mobil uygulamalara sabit kodlamayın. İstemci tarafı kodunda derlenen anahtarlar kullanıcılar tarafından çıkarılabilir. İstemci tarafı uygulamaların güvenliğini sağlamak için gerçek API çağrılarını yapmak üzere bir arka uç proxy sunucusu çalıştırın.

Gizli anahtar yönetimi için en iyi uygulamalar

• Ortam değişkenleri: Anahtarları yapılandırma dosyaları yerine ortam değişkenlerinden okuyun.
• Secret Manager: Üretim için anahtarlarınızı Google Cloud Secret Manager gibi güvenli bir gizli anahtar deposunda saklayın.
• Faturalandırma uyarıları: Kullanım veya maliyetlerde artış olması durumunda sizi bilgilendirmek için Google Cloud Console'da faturalandırma uyarıları ayarlayın.

Sızıntı yanıtı kontrol listesi

API anahtarınızın sızdırıldığından şüpheleniyorsanız:

1. Yeni bir anahtar oluşturun: Google AI Studio veya Cloud Console'da yedek bir anahtar oluşturun.
2. Uygulamanızı güncelleyin: Kodunuzu yeni anahtarı kullanarak dağıtın.
3. Güvenliği ihlal edilmiş anahtarı devre dışı bırakın veya silin: Yeni anahtar doğrulandıktan sonra sızdırılan anahtarı Cloud Console'da devre dışı bırakın. Uygulama kapalı kalma süresini önlemek için yeni anahtar tamamen etkinleşene kadar eski anahtarı silmeyin.
4. Kullanımı denetleme: Yetkisiz etkinliği belirlemek için Google Cloud Console'da faturalandırma günlüklerini ve API kullanımını kontrol edin.

Anahtarlarınızı kısıtlama ve güvenliğini sağlama

API anahtarlarınıza kısıtlamalar eklemek, bir anahtarın güvenliği ihlal edilirse oluşabilecek zararı en aza indirir.

İstek kaynağı kısıtlamaları uygulama

Kaynak kısıtlamaları, anahtarınızı hangi IP adreslerinin, web sitelerinin veya uygulamaların kullanabileceğini sınırlar.

1. Google Cloud Console Kimlik Bilgileri sayfasına gidin.
2. Projenizi seçin ve kısıtlamak istediğiniz API anahtarının adını tıklayın.
3. Uygulama kısıtlamaları bölümünde IP adresleri'ni (veya ortamınız için uygun kısıtlama türünü) seçin.
4. İzin verilen IP adreslerini veya aralıklarını belirtin, ardından Kaydet'i tıklayın.

Kısıtlanmamış standart API anahtarlarının güvenliğini sağlama

Gemini API'yi 19 Haziran 2026'dan sonra kullanmaya devam etmek için tüm kısıtlanmamış anahtarları güvenli hale getirmeniz gerekir.

Anahtarı yalnızca AI Studio üzerinden Gemini API ile kısıtlama

Anahtarı yalnızca Gemini API için kullanıyorsanız doğrudan AI Studio'da güvenli hale getirin:

1. Google AI Studio'daki API Anahtarları sayfasında, Kısıtlanmamış etiketiyle işaretlenmiş anahtarları bulun.
2. Fareyle etiketin üzerine gelin ve iletişim kutusunda Kısıtlama ekle'yi tıklayın.
3. Yalnızca Gemini API ile kısıtla'yı seçin.
4. Onaylamak için Anahtarı kısıtla'yı tıklayın.

Google Cloud Console üzerinden anahtarı diğer hizmetler için kısıtlama

Anahtar diğer Google API'leriyle paylaşılıyorsa (önerilmez) Cloud Console'da kısıtlayın. Not: Bu anahtar kullanılarak yapılan Gemini API istekleri, bu kısıtlamalar uygulandıktan sonra başarısız olur.

1. Google Cloud Console Kimlik Bilgileri sayfasını ziyaret edin.
2. Projeyi ve API anahtarını seçin.
3. API kısıtlamaları bölümünde Anahtarı kısıtla'yı seçin.
4. Açılır listeden, bu anahtarın erişmesini istediğiniz API'leri seçin. Generative Language API'yi seçmeyin.
5. Kaydet'i tıklayın. Gemini API'yi kullanmaya devam etmek için AI Studio'da ayrı ve kısıtlanmış bir anahtar oluşturun.

Etkin olmayan engellenen anahtarlar

7 Mayıs 2026'dan itibaren Gemini API, uzun süredir kullanılmayan sınırsız API anahtarlarını engeller. Bu anahtarlar, AI Studio'da Engellendi etiketini gösterir. Devam etmek için yeni bir anahtar oluşturmanız veya mevcut bir kısıtlanmış anahtarı kullanmanız gerekir.

Kimlik doğrulama anahtarına geçiş yapma

Yeni bir kimlik doğrulama API anahtarı oluşturmak ve uygulamalarınızı güncellemek için aşağıdaki adımları uygulayın:

1. AI Studio API Anahtarları sayfasına gidin.
2. Standart olarak listelenen anahtarları belirlemek için Anahtar Türü sütununu kontrol edin.
3. Yeni bir anahtar oluşturmak için API anahtarı oluştur'u tıklayın. AI Studio'da oluşturulan tüm yeni anahtarlar otomatik olarak kimlik doğrulama anahtarı olarak oluşturulur.
4. Yeni kimlik doğrulama API anahtarını kopyalayın.
5. Yeni kimlik doğrulama API anahtarını kullanmak için uygulama kodunuzu, ortam değişkenlerinizi ve tüm dağıtım yapılandırmalarınızı güncelleyin.
6. Uygulamanızı test ederek yeni anahtarla doğru şekilde çalıştığını doğrulayın.
7. Doğrulandıktan sonra, kötüye kullanımı önlemek için eski trafik anahtarınızı silin veya iptal edin.

Sınırlamalar

Google Yapay Zeka Studio, proje ve anahtar yönetimiyle ilgili aşağıdaki sınırlamaları uygular:

• Google AI Studio Projeler sayfasında tek seferde en fazla 10 proje oluşturabilirsiniz.
• API anahtarları ve Projeler sayfalarında en fazla 100 anahtar ve 50 proje gösterilir.
• Yalnızca kısıtlanmamış veya özellikle Generative Language API (Gemini API) ile kısıtlanmış API anahtarları gösterilir.

Gelişmiş proje yönetimi veya anahtarları diğer kısıtlamalarla değiştirmek için Google Cloud Console kimlik bilgileri sayfasını kullanın.