Gemini API referansı

Bu API referansında, Gemini modelleriyle etkileşim kurmak için kullanabileceğiniz tekli, akış ve gerçek zamanlı API'ler açıklanmaktadır. REST API'leri, HTTP isteklerini destekleyen tüm ortamlarda kullanabilirsiniz. İlk API çağrınızı yapmaya nasıl başlayacağınızı öğrenmek için Başlangıç kılavuzuna bakın. Dile özgü kitaplıklarımız ve SDK'larımızla ilgili referansları arıyorsanız sol gezinme panelindeki SDK referansları bölümünde ilgili dilin bağlantısına gidin.

Birincil uç noktalar

Gemini API, aşağıdaki başlıca uç noktalar etrafında düzenlenmiştir:

• Etkileşimler (CreateInteraction) (Önerilir): Gemini ile geliştirme için önerilen standart temel öğe. Bu öğe, ajan tabanlı iş akışları, sunucu tarafında durum yönetimi ve karmaşık çok formatlı, çok aşamalı etkileşimler için optimize edilmiştir.
• Standart içerik üretimi (generateContent): İsteğinizi işleyen ve modelin tam yanıtını tek bir pakette döndüren standart bir REST uç noktası. Bu seçenek, sonucun tamamını bekleyebileceğiniz etkileşimsiz görevler için en uygundur.
• Akış halinde içerik oluşturma (streamGenerateContent): Yanıt parçalarını oluşturuldukça size göndermek için sunucu tarafından gönderilen etkinlikleri (SSE) kullanır. Bu sayede chatbot'lar gibi uygulamalarda daha hızlı ve etkileşimli bir deneyim sunulur.
• Live API (BidiGenerateContent): Çift yönlü akış için durum bilgisi olan WebSocket tabanlı bir API'dir. Gerçek zamanlı sohbet kullanım alanları için tasarlanmıştır.
• Toplu mod (batchGenerateContent): generateContent istek gruplarını göndermek için kullanılan standart bir REST uç noktasıdır.
• Yerleştirmeler (embedContent): Girişten Content metin yerleştirme vektörü oluşturan standart bir REST uç noktası.
• Gen Media API'leri: Görsel üretimi için Imagen ve video üretimi için Veo gibi özel modellerimizle medya oluşturmaya yönelik uç noktalar. Gemini'da bu özellikler yerleşik olarak bulunur ve generateContent API'si kullanılarak erişilebilir.
• Platform API'leri: Dosya yükleme ve jeton sayma gibi temel özellikleri destekleyen yardımcı program uç noktaları.

Kimlik doğrulama

Gemini API'ye yapılan tüm istekler, API anahtarınızın bulunduğu bir x-goog-api-key üstbilgisi içermelidir. Google Yapay Zeka Studio'da birkaç tıklamayla oluşturabilirsiniz.

Aşağıda, üst bilgiye API anahtarının dahil edildiği bir örnek istek verilmiştir:

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 iletme talimatları için Gemini API anahtarlarını kullanma kılavuzuna bakın.