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 kitaplıklar genel kullanıma sunulmuştur ve tüm resmi belgelerimizde ve örneklerimizde kullanılır.
Gemini API'yi kullanmaya yeni başlıyorsanız hızlı başlangıç kılavuzumuzu inceleyerek başlayın.
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. Bu API'ler kararlıdır, üretimde kullanım için tam olarak desteklenir ve aktif olarak bakımı yapılır. Bu cihazlar, 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, yeni özelliklere (ör. Live API ve Veo) erişim sağlamaz ve desteği sonlandırılma sürecindedir. Bu cihazlar Eylül 2025'in sonunda güncellemeleri almayı durduracak, ö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 destekler Eylül 2025'in sonunda sona erer. | google-genai |
JavaScript/TypeScript | @google/generativeai |
Hata düzeltmeleri de dahil olmak üzere tüm destekler Eylül 2025'in sonunda sona erer. | @google/genai |
Go | google.golang.org/generative-ai |
Hata düzeltmeleri de dahil olmak üzere tüm destekler Eylül 2025'in sonunda sona erer. | 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 kurulum 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 desteği sonlandırılmış kitaplıkları kullanarak kod üretebilir. 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: