Gemini API kod yürütme özelliği, modelin Python kodu oluşturup çalıştırmasını ve nihai bir sonuca ulaşana kadar sonuçlardan iteratif olarak öğrenmesini sağlar. Kod tabanlı akıl yürütmeden yararlanan ve metin çıkışı üreten uygulamalar oluşturmak için bu kod yürütme özelliğini kullanabilirsiniz. Örneğin, kod yürütmeyi denklemleri çözen veya metni işleyen bir uygulamada kullanabilirsiniz.
Kod yürütme hem AI Studio'da hem de Gemini API'de kullanılabilir. AI Studio'da, sağ paneldeki Araçlar bölümünden kod yürütmeyi etkinleştirebilirsiniz. Gemini API, işlev çağırma işlemine benzer şekilde kod yürütme aracı sağlar. Kod yürütme aracını ekledikten sonra, ne zaman kullanılacağına model karar verir.
Kod yürütme ortamı aşağıdaki kitaplıkları içerir:
altair, chess, cv2, matplotlib, mpmath, numpy, pandas,
pdfminer, reportlab, seaborn, sklearn, statsmodels, striprtf,
sympy ve tabulate. Kendi kitaplıklarınızı yükleyemezsiniz.
Kod yürütmeyi kullanmaya başlama
Bu bölümde, hızlı başlangıç bölümünde gösterilen kurulum ve yapılandırma adımlarını tamamladığınız varsayılmaktadır.
Giriş/çıkış (G/Ç)
Gemini 2.0 Flash'tan itibaren kod yürütme, dosya girişini ve grafik çıkışını destekler. Bu yeni giriş ve çıkış özelliklerini kullanarak CSV ve metin dosyaları yükleyebilir, dosyalarla ilgili sorular sorabilir ve yanıtın bir parçası olarak Matplotlib grafikleri oluşturabilirsiniz.
G/Ç fiyatlandırması
Kod yürütme G/Ç'sini kullandığınızda giriş jetonları ve çıkış jetonları için ücretlendirilirsiniz:
Jeton girme:
- Kullanıcı istemi
Çıkış jetonları:
- Model tarafından oluşturulan kod
- Kod ortamında kod yürütme çıkışı
- Model tarafından oluşturulan özet
G/Ç ayrıntıları
Kod yürütme G/Ç ile çalışırken aşağıdaki teknik ayrıntılara dikkat edin:
- Kod ortamının maksimum çalışma süresi 30 saniyedir.
- Kod ortamı bir hata oluşturursa model, kod çıkışını yeniden oluşturmaya karar verebilir. Bu işlem 5 kez tekrarlanabilir.
- Maksimum dosya girişi boyutu, model jetonu penceresiyle sınırlıdır. AI Studio'da, Gemini Flash 2.0 kullanılarak oluşturulan maksimum giriş dosyası boyutu 1 milyon parçadır (desteklenen giriş türlerinin metin dosyaları için yaklaşık 2 MB). Çok büyük bir dosya yüklerseniz AI Studio dosyayı göndermenize izin vermez.
| Tek tur | İki yönlü (Çok modlu Live API) | |
|---|---|---|
| Desteklenen modeller | Tüm Gemini 2.0 modelleri | Yalnızca Flash deneysel modelleri |
| Desteklenen dosya giriş türleri | .png, .jpeg, .csv, .xml, .cpp, .java, .py, .js, .ts | .png, .jpeg, .csv, .xml, .cpp, .java, .py, .js, .ts |
| Desteklenen nokta grafik kitaplıkları | Matplotlib | Matplotlib |
| Çok amaçlı araç kullanımı | Hayır | Evet |
Faturalandırma
Gemini API'den kod yürütme özelliğinin etkinleştirilmesi için ek ücret alınmaz. Kullandığınız Gemini modeline göre geçerli giriş ve çıkış jetonu ücretiyle faturalandırılırsınız.
Kod yürütmeyle ilgili faturalandırma hakkında bilmeniz gereken diğer noktalar:
- Modele ilettiğiniz giriş jetonları için yalnızca bir kez, model tarafından size döndürülen nihai çıkış jetonları için ise bir kez faturalandırılırsınız.
- Oluşturulan kodu temsil eden jetonlar çıkış jetonu olarak sayılır. Oluşturulan kod, metin ve resim gibi çoklu biçimli çıkışlar içerebilir.
- Kod yürütme sonuçları da çıkış jetonu olarak sayılır.
Faturalandırma modeli aşağıdaki şemada gösterilmektedir:
- Kullandığınız Gemini modeline göre geçerli giriş ve çıkış jetonu ücretiyle faturalandırılırsınız.
- Gemini, yanıtınızı oluştururken kod yürütme işlemini kullanıyorsa orijinal istem, oluşturulan kod ve yürütülen kodun sonucu ara jetonlar olarak etiketlenir ve giriş jetonları olarak faturalandırılır.
- Ardından Gemini bir özet oluşturur ve oluşturulan kodu, çalıştırılan kodun sonucunu ve nihai özeti döndürür. Bunlar çıkış jetonları olarak faturalandırılır.
- Gemini API, API yanıtında bir ara jeton sayısı içerir. Böylece, ilk isteminizden sonra neden ek giriş jetonları aldığınızı bilirsiniz.
Sınırlamalar
- Model yalnızca kod oluşturabilir ve çalıştırabilir. Medya dosyaları gibi diğer yapıları döndüremez.
- Bazı durumlarda kod yürütmeyi etkinleştirmek, model çıktısının diğer alanlarında (ör. hikaye yazma) gerilemelere neden olabilir.
- Farklı modellerin kod yürütmeyi başarılı bir şekilde kullanma becerisinde bazı farklılıklar vardır.