Gemini API anahtarı alma

Gemini API'yi kullanmak için API anahtarına ihtiyacınız vardır. Google AI Studio'da birkaç tıklamayla anahtar oluşturabilirsiniz.

Google AI Studio'da Gemini API anahtarı edinme

API anahtarınızı ayarlama

İlk test için bir API anahtarını sabit kodlayabilirsiniz ancak bu, güvenli olmadığı için yalnızca geçici olmalıdır. Bu bölümün geri kalanında, API anahtarınızı farklı işletim sistemlerinde yerel olarak ortam değişkeni olarak nasıl ayarlayacağınız açıklanmaktadır.

Linux/macOS - Bash

Bash, yaygın bir Linux ve macOS terminal yapılandırmasıdır. Aşağıdaki komutu çalıştırarak bunun için bir yapılandırma dosyanız olup olmadığını kontrol edebilirsiniz:

~/.bashrc

Yanıt "Böyle bir dosya veya dizin yok" ise bu dosyayı oluşturup aşağıdaki komutları çalıştırarak açmanız veya zsh kullanmanız gerekir:

touch ~/.bashrc
open ~/.bashrc

Ardından, aşağıdaki dışa aktarma komutunu ekleyerek API anahtarınızı ayarlamanız gerekir:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Dosyayı kaydettikten sonra aşağıdaki komutu çalıştırarak değişiklikleri uygulayın:

source ~/.bashrc

macOS - Zsh

Zsh, yaygın bir Linux ve macOS terminal yapılandırmasıdır. Aşağıdaki komutu çalıştırarak bunun için bir yapılandırma dosyanız olup olmadığını kontrol edebilirsiniz:

~/.zshrc

Yanıt "Böyle bir dosya veya dizin yok" ise bu dosyayı oluşturup aşağıdaki komutları çalıştırarak açmanız veya bash kullanmanız gerekir:

touch ~/.zshrc
open ~/.zshrc

Ardından, aşağıdaki dışa aktarma komutunu ekleyerek API anahtarınızı ayarlamanız gerekir:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Dosyayı kaydettikten sonra aşağıdaki komutu çalıştırarak değişiklikleri uygulayın:

source ~/.zshrc

Windows

  1. Sistem ayarlarında "Ortam Değişkenleri"ni arayın
  2. "Kullanıcı değişkenleri"ni (mevcut kullanıcı için) veya "Sistem değişkenleri"ni (tüm kullanıcılar için - dikkatli kullanın) düzenleyin.
  3. Değişkeni oluşturun ve export GEMINI_API_KEY=your_key_here ekleyin
  4. Değişiklikleri uygulama

İlk Gemini API isteğinizi gönderme

Ayarlarınızı doğrulamak için curl komutunu kullanabilirsiniz:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

API anahtarınızın güvenliğini sağlama

Gemini API anahtarınızın güvenliğini sağlamanız önemlidir. Gemini API anahtarınızı kullanırken göz önünde bulundurmanız gereken bazı noktalar aşağıda belirtilmiştir:

  • Google AI Gemini API, yetkilendirme için API anahtarları kullanır. Gemini API anahtarınıza başkaları erişirse projenizin kotasını kullanarak çağrı yapabilirler. Bu durum, ayarlanmış modellere ve dosyalara erişmenin yanı sıra faturalandırılan projeler için kota kaybına veya ek ücretlere neden olabilir.

  • API anahtarı kısıtlamaları eklemek, her API anahtarı aracılığıyla kullanılabilen alanı sınırlandırmaya yardımcı olabilir.

  • Gemini API anahtarınızın güvenliğini sağlamak sizin sorumluluğunuzdadır.

    • Gemini API anahtarlarını kaynak denetimine KAYDETMEYİN.
    • İstemci tarafı uygulamalarda (Android, Swift, web ve Dart/Flutter) API anahtarlarının açığa çıkma riski vardır. Google AI Gemini API'yi doğrudan mobil ve web uygulamalarınızdan çağırmak için üretim uygulamalarında Google AI istemci SDK'larını kullanmanızı önermiyoruz.

Bazı genel en iyi uygulamalar için bu destek makalesini de inceleyebilirsiniz.