API anahtarı alma

Gemini API'yi kullanmak için API anahtarı gerekir. Google AI Studio'da tek tıklamayla anahtar oluşturabilirsiniz.

API anahtarı alma

API anahtarınızı curl komutuyla doğrulama

Kurulumunuzu doğrulamak için curl komutu kullanabilirsiniz. API anahtarını URL'de aktarabilirsiniz:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

Veya x-goog-api-key başlığında:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

API anahtarınızı güvende tutun

Gemini API anahtarınızı güvende tutmak önemlidir. Gemini API anahtarınızı kullanırken göz önünde bulundurmanız gereken birkaç nokta aşağıda belirtilmiştir:

  • Google AI Gemini API, yetkilendirme için API anahtarlarını kullanır. Gemini API anahtarınıza başka kullanıcıların erişimi olursa projenizin kotasını kullanarak çağrı yapabilirler. Bu durum, kota kaybına veya ek faturalandırma ücretlerine (faturalandırma etkinse) neden olabilir. API anahtarları, hassaslaştırılmış modellere ve dosyalara erişimi de korur.

  • Google AI Studio'da API anahtarı al'ı tıkladığınızda, yeni veya mevcut bir Google Cloud projesinde Gemini API anahtarı sağlayıp sağlamayacağınızı seçersiniz. Google AI Studio'daki API anahtarları listesinde, AI Studio'nun Google AI Gemini API ile kullanılmak üzere sağladığı tüm API anahtarları (ilişkili tüm Google Cloud projeleriyle birlikte) gösterilir.

    • Bununla birlikte, Google Cloud projesindeki tüm API anahtarları, Google AI Gemini API'yi çağırmak için kullanılabilir. Projenizin tüm API anahtarlarını Google Cloud Console'daki API'ler ve Hizmetler > Kimlik Bilgileri panelinde görüntüleyebilir ve yönetebilirsiniz.

  • API anahtarı kısıtlamaları eklemek, her API anahtarı aracılığıyla kullanılabilecek yüzey alanını sınırlandırmaya yardımcı olabilir. Google AI Studio tarafından oluşturulan Gemini API anahtarı, varsayılan olarak yalnızca Google AI Gemini API (resmi adıyla "Generative Language API" veya generativelanguage.googleapis.com) ile kullanılabilir.

    • Google Cloud projenizde API kısıtlamaları olmayan API anahtarları veya Generative Language API'yi izin verilenler listesine eklenmiş API anahtarları varsa bu anahtarlar Google AI Gemini API ile kullanılabilir. En iyi uygulama, her API anahtarını yalnızca bu anahtarı kullanarak çağırdığınız API'lerle kısıtlamaktır.
    • API anahtarı kısıtlamaları olsa bile API anahtarınızı ele geçiren kötü amaçlı kişiler, projenizin söz konusu API anahtarı için izin verilenler listesine eklenmiş tüm API'lerin kotasını kullanarak çağrı yapmak amacıyla bu anahtarı kullanabilir.

  • Gemini API anahtarınızı güvende tutmak sizin sorumluluğunuzdadır.

    • Gemini API anahtarlarını kaynak kontrolüne İŞARETLEMEYİN.
    • İstemci tarafı uygulamalar (Android, Swift, web ve Dart/Flutter) API anahtarlarının açığa çıkma riskini taşır. Bu nedenle, 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ı önermeyiz. API anahtarınızı güvenceye almayla ilgili dile özgü en iyi uygulamaları öğrenmek için SDK hızlı başlangıç kılavuzlarına göz atın.

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

Sonraki adımlar