Gemini API anahtarlarını kullanma

Gemini API'yi kullanmak için isteklerinizin kimliğini doğrulamanız gerekir. Standart veya yetkilendirme API anahtarı kullanarak kimlik 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çiyor:

• Standart API anahtarları: Faturalandırma ve kota amacıyla istekleri bir Google Cloud projesiyle ilişkilendirin. Standart anahtarlar, arayanı tanımlamaz. Bu durum, 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, bağlı hizmet hesabının kimliği altında işlenir. Bu sayede ayrıntılı erişim denetimi sağlanır. Yetkilendirme anahtarları varsayılan olarak Generative Language API (Gemini API) ile sınırlıdır ve sistemlerimiz tarafından tespit edilen sızdırılmış anahtarların kullanımını hızla durduran, hızlı etkili sızdırılmış anahtar yaptırımı sağlar.

Gemini API, güvenli kullanım sağlamak için standart anahtarlardan kimlik doğrulama anahtarlarına geçecek:

• Varsayılan kimlik doğrulama anahtarları: 28 Mayıs 2026'dan itibaren Google AI Studio'da oluşturulan tüm yeni API anahtarları otomatik olarak kimlik doğrulama anahtarı olarak oluşturulur.
• Kısıtlanmamış anahtarlar reddedildi: Gemini API, kısıtlanmamış standart anahtarlardan gelen istekleri reddeder. Açık kısıtlamaların uygulandığı standart API anahtarları çalışmaya devam eder. Bu kısıtlama, herkese açık olarak paylaşılabilen veya diğer hizmetlere bağlı anahtarların yetkisiz kullanımını önler.

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 Google AI Studio, Hizmet Şartları'nı kabul ettikten sonra otomatik olarak varsayılan bir Google Cloud projesi ve API anahtarı oluşturur. Kontrol panelinizdeki Projeler görünümüne giderek bu projeyi 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. Sol 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, ardından İçe aktar'ı tıklayın.
5. İçe aktarma işlemi tamamlandıktan sonra, projede anahtar oluşturmak için kontrol panelindeki API Anahtarları sayfasına gidin.

Anahtar oluşturma izinleriyle ilgili sorunları giderme

Create API key (API anahtarı oluştur) düğmesi kullanılamıyorsa ve "You do not have permission to create a key in this project" (Bu projede anahtar oluşturma izniniz yok) mesajı gösteriliyorsa gerekli IAM izinlerine sahip değilsiniz demektir.

Google Cloud projenizden veya kuruluş yöneticinizden aşağıdaki izinleri içeren bir rol (ör. Proje Düzenleyici) vermesini isteyin:

• resourcemanager.projects.get: AI Studio'nun projeyi doğrulamasına izin verir.
• apikeys.keys.create: Anahtar oluşturulmasına 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önetici erişimi alamıyorsanız anahtarlarınızı oluşturmak için bir kuruluşla ilişkili olmayan yeni bir Google Cloud projesi oluşturabilirsiniz.

Kullanım sayfasındaki bilinmeyen anahtarlar

Google AI Studio'daki Kullanım sayfası, projedeki adlandırılmış bir API anahtarıyla eşleştiremediği istekleri (bilinmeyen anahtarlar) altında gruplandırır. 30 günden uzun süre önce silinen anahtarlar, görünen adı olmayan anahtarlar ve OAuth gibi diğer kimlik bilgileriyle yapılan istekler buna dahildir.

Google Cloud Console'da anahtar oluşturma

Google AI Studio yalnızca kısıtlanmamış veya Gemini API ile kısıtlanmış anahtarları gösterir. AI Studio'yu kullanamıyorsanız veya tüm API anahtarlarınızı tek bir yerden yönetmek istiyorsanız API anahtarı oluşturma ile ilgili Cloud belgelerini inceleyin. Gemini API anahtarı oluşturmak için anahtarı bir hizmet hesabına bağlamanız gerekir.

Ortamınızı kurma

Anahtarınızı aldıktan sonra, ortamınızı anahtarı uygulamalarınızda güvenli bir şekilde kullanacak şekilde yapılandırın.

1. seçenek: 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

2. seçenek: API anahtarını kodda açıkça belirtme

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

from google import genai

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

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

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

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

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

main();

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = Client.builder().apiKey("YOUR_API_KEY").build();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Explain how AI works in a few sentences."))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

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

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.8-flash"),
            Input: interactions.NewInteractionsInput("Explain how AI works in a few sentences."),
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

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

Güvenlik ve Secret Manager

Gemini API anahtarınızı şifre gibi koruyun. Güvenliği ihlal edilirse başkaları projenizin kotasını kullanabilir, beklenmedik faturalandırma ücretleri oluşturabilir ve özel kaynaklara erişebilir.

Önemli güvenlik kuralları

• Anahtarları gizli tutun: API anahtarlarını hiçbir zaman Git gibi kaynak kontrol sistemlerine eklemeyin.
• Anahtarları hiçbir zaman istemci tarafında canlı sürümde kullanıma sunmayın: API anahtarlarını doğrudan web veya mobil uygulamalara kod gömmeyin. İstemci tarafı kodunda derlenen anahtarlar kullanıcılar tarafından ayıklanabilir. İstemci tarafı uygulamaların güvenliğini sağlamak için gerçek API çağrılarını yapacak bir arka uç proxy sunucusu çalıştırın.

Secret Manager 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 ani artış olduğunda sizi bilgilendirmesi için Google Cloud Console'da faturalandırma uyarıları ayarlayın.

Sızıntı müdahale kontrol listesi

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

1. Yeni anahtar oluşturun: Google AI Studio veya Cloud Console'da yeni bir anahtar oluşturun.
2. Uygulamanızı güncelleme: Yeni anahtarı kullanarak kodunuzu dağıtın.
3. Güvenliği ihlal edilen 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. Uygulamanın kesintiye uğramaması için yeni anahtar tamamen etkinleşene kadar eski anahtarı silmeyin.
4. Kullanımı denetleme: Yetkisiz etkinlikleri tespit etmek 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 edildiğinde oluşabilecek potansiyel zararı en aza indirir.

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

Kaynak kısıtlamaları, anahtarınızı kullanabilecek IP adreslerini, web sitelerini veya uygulamaları sınırlandırır.

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. Application restrictions (Uygulama kısıtlamaları) bölümünde IP addresses'ı (IP adresleri) (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 kullanmaya devam etmek için kısıtlanmamış anahtarların güvenliğini sağlamanız gerekir.

A yöntemi: Anahtarı yalnızca Gemini API ile kısıtlama (AI Studio)

Anahtarı yalnızca Gemini API için kullanıyorsanız doğrudan AI Studio'da güvenliğini sağlayın:

1. Google AI Studio'daki API Keys (API Anahtarları) sayfasında Unrestricted (Kısıtlanmamış) etiketiyle işaretlenmiş anahtarları bulun.
2. Fareyle etiketin üzerine gelip 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.

B yöntemi: Diğer hizmetler için anahtarı kısıtlama (Google Cloud Console)

Anahtar diğer Google API'leriyle paylaşılıyorsa (önerilmez) Cloud Console'da kısıtlayın. Not: Bu kısıtlamalar uygulandıktan sonra bu anahtarı kullanan Gemini API istekleri 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, bu anahtarın erişmesini istediğiniz API'leri seçmek için API kısıtlamalarını seçin açılır menüsünü kullanın. Generative Language API'yi seçmeyin.
4. 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.

Engellenen etkin olmayan anahtarlar

7 Mayıs 2026'dan itibaren Gemini API, uzun süredir kullanılmayan kısıtlanmamış API anahtarlarını engelleyecek. Bu anahtarlar, AI Studio'da Engellendi etiketiyle gösterilir. 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. Yeni anahtarla doğru şekilde çalıştığını doğrulamak için uygulamanızı test edin.
7. Doğrulama tamamlandıktan sonra, kötüye kullanımı önlemek için eski trafik anahtarınızı silin veya iptal edin.

Sınırlamalar

Google AI Studio'da aşağıdaki proje ve anahtar yönetimi sınırlamaları geçerlidir:

• Google AI Studio Projeler sayfasından 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ı başka kısıtlamalarla değiştirmek için Google Cloud Console kimlik bilgileri sayfasını kullanın.