Gemini API referansı

Bu API referansı, Gemini modelleriyle etkileşim kurmak için kullanabileceğiniz tekli, akışlı ve gerçek zamanlı API'leri açıklamaktadır. REST API'lerini HTTP isteklerini destekleyen her ortamda kullanabilirsiniz. İlk API çağrınıza nasıl başlayacağınız konusunda bilgi için Başlangıç ​​kılavuzuna bakın. Dilimize özgü kütüphaneler ve SDK'lar için referansları arıyorsanız, sol gezinme menüsündeki SDK referansları altındaki ilgili dil bağlantısına gidin.

Birincil sonuç noktaları

Gemini API'si aşağıdaki temel uç noktalar etrafında düzenlenmiştir:

  • Etkileşimler (CreateInteraction ) (Tavsiye edilen): Gemini ile geliştirme için önerilen standart temel bileşen; ajan tabanlı iş akışları, sunucu tarafı durum yönetimi ve karmaşık çok modlu, çok turlu konuşmalar için optimize edilmiştir.
  • Standart içerik oluşturma (generateContent ): İsteğinizi işleyen ve modelin tüm yanıtını tek bir paket halinde döndüren standart bir REST uç noktası. Bu, sonucun tamamını bekleyebileceğiniz etkileşimsiz görevler için en uygundur.
  • Akış içeriği oluşturma (streamGenerateContent ): Sunucu Tarafından Gönderilen Olaylar (SSE) kullanarak, yanıtın parçalarını oluşturuldukları anda size iletir. Bu, sohbet botları gibi uygulamalar için daha hızlı ve etkileşimli bir deneyim sağlar.
  • Canlı API (BidiGenerateContent ): Gerçek zamanlı konuşma tabanlı kullanım durumları için tasarlanmış, çift yönlü akış sağlayan, durum bilgisi içeren WebSocket tabanlı bir API.
  • Toplu işlem modu (batchGenerateContent ): Toplu veri gönderimi için standart bir REST uç noktası.generateContent istekler.
  • Gömülü Veriler (embedContent ): Girdiden metin gömme vektörü oluşturan standart bir REST uç noktası.Content .
  • Gen Medya API'leri: Görüntü oluşturma için Imagen ve video oluşturma için Veo gibi özel modellerimizle medya oluşturmak için uç noktalar. Gemini'nin bu özellikleri de yerleşik olarak mevcuttur ve bunlara generateContent API'sini kullanarak erişebilirsiniz.
  • Platform API'leri: Dosya yükleme ve token sayma gibi temel yetenekleri destekleyen yardımcı uç noktalar.

Kimlik doğrulama

Gemini API'sine yapılan tüm istekler, API anahtarınızı içeren bir x-goog-api-key başlığı içermelidir. Google AI Studio'da birkaç tıklamayla bir tane oluşturun.

Aşağıda, başlıkta API anahtarının yer aldığı örnek bir istek bulunmaktadır:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash: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"
          }
        ]
      }
    ]
  }'

Gemini SDK'larını kullanarak anahtarınızı API'ye nasıl ileteceğinize ilişkin talimatlar için Gemini API anahtarlarını kullanma kılavuzuna bakın.