Gemini API ile geliştirme yaparken Google GenAI SDK'yı kullanmanızı öneririz. Bunlar, en popüler diller için geliştirdiğimiz ve bakımını yaptığımız resmi, üretime hazır kitaplıklardır. Bu işlevler genel kullanıma sunulmuştur ve tüm resmi belgelerimizde ve örneklerimizde kullanılmaktadır.
Gemini API'yi kullanmaya yeni başlıyorsanız hızlı başlangıç kılavuzumuzu inceleyerek başlayabilirsiniz.
Dil desteği ve yükleme
Google GenAI SDK; Python, JavaScript/TypeScript, Go ve Java dillerinde kullanılabilir. Her dilin kitaplığını paket yöneticilerini kullanarak yükleyebilir veya daha fazla bilgi için GitHub depolarını ziyaret edebilirsiniz:
Python
Kitaplık:
google-genai
GitHub deposu: googleapis/python-genai
Yükleme:
pip install google-genai
JavaScript
Kitaplık:
@google/genai
GitHub deposu: googleapis/js-genai
Yükleme:
npm install @google/genai
Go
Kitaplık:
google.golang.org/genai
GitHub deposu: googleapis/go-genai
Yükleme:
go get google.golang.org/genai
Java
Kütüphane:
google-genai
GitHub deposu: googleapis/java-genai
Yükleme: Maven kullanıyorsanız bağımlılıklarınıza aşağıdakileri ekleyin:
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
Genel kullanılabilirlik
Gemini 2.0'ı kullanıma sunduğumuz 2024'ün sonlarında, Gemini API'ye erişmek için yeni bir kitaplık grubu olan Google GenAI SDK'yı kullanıma sunmaya başladık.
Mayıs 2025 itibarıyla, desteklenen tüm platformlarda genel kullanıma sunulmuş olup Gemini API'ye erişmek için önerilen kitaplıklardır. Kararlıdırlar, üretim amaçlı kullanım için tam olarak desteklenirler ve aktif olarak bakımları yapılır. Bu planlar, en yeni özelliklere erişim sağlar ve Gemini ile çalışırken en iyi performansı sunar.
Eski kitaplıklarımızdan birini kullanıyorsanız en yeni özelliklere erişebilmek ve Gemini ile çalışırken en iyi performansı elde edebilmek için geçiş yapmanızı önemle tavsiye ederiz. Daha fazla bilgi için eski kitaplıklar bölümünü inceleyin.
Eski kitaplıklar ve taşıma
Eski kitaplıklarımızdan birini kullanıyorsanız yeni kitaplıklara geçmenizi öneririz.
Eski kitaplıklar, son özelliklere (ör. Live API ve Veo) erişim sağlamaz ve desteği sonlandırılma sürecindedir. Bu cihazlar 30 Kasım 2025'ten itibaren güncelleme almayı bırakacak, özellik eksiklikleri artacak ve olası hatalar düzeltilmeyecek.
Her eski kitaplığın destek durumu farklıdır. Ayrıntılı bilgi için aşağıdaki tabloya bakın:
Dil | Eski kitaplık | Destek durumu | Önerilen kitaplık |
---|---|---|---|
Python | google-generativeai |
Hata düzeltmeleri de dahil olmak üzere tüm destek 30 Kasım 2025'te sona erecek. | google-genai |
JavaScript/TypeScript | @google/generativeai |
Hata düzeltmeleri de dahil olmak üzere tüm destek 30 Kasım 2025'te sona erecek. | @google/genai |
Go | google.golang.org/generative-ai |
Hata düzeltmeleri de dahil olmak üzere tüm destek 30 Kasım 2025'te sona erecek. | google.golang.org/genai |
Dart ve Flutter | google_generative_ai |
Aktif olarak bakımı yapılmıyor | firebase_ai gibi güvenilir topluluk veya üçüncü taraf kitaplıklarını kullanın ya da REST API'yi kullanarak erişin. |
Swift | generative-ai-swift |
Aktif olarak bakımı yapılmıyor | Firebase AI Logic'i kullanma |
Android | generative-ai-android |
Aktif olarak bakımı yapılmıyor | Firebase AI Logic'i kullanma |
Java geliştiricileri için not: Gemini API için Google tarafından sağlanan eski bir Java SDK'sı olmadığından önceki bir Google kitaplığından geçiş yapılması gerekmez. Dil desteği ve yükleme bölümündeki yeni kitaplıkla doğrudan başlayabilirsiniz.
Kod üretme için istem şablonları
Üretken modeller (ör. Gemini, Claude) ve yapay zeka destekli IDE'ler (ör. Cursor), eğitim verilerinin kesilme tarihi nedeniyle Gemini API için eski veya kullanımdan kaldırılmış kitaplıkları kullanarak kod oluşturabilir. Oluşturulan kodun en yeni ve önerilen kitaplıkları kullanması için istemlerinizde doğrudan sürüm ve kullanım yönergeleri sağlayın. Gerekli bağlamı sağlamak için aşağıdaki şablonları kullanabilirsiniz: