Gemini API kod yürütme özelliği, modelin Python kodu oluşturmasını ve çalıştırmasını ve nihai çıkışa ulaşana kadar sonuçlardan aşamalı olarak öğrenmesini sağlar. Bu kod yürütme özelliğini, kod tabanlı akıl yürütmeden yararlanan ve metin çıkışı üreten uygulamalar derlemek için kullanabilirsiniz. Örneğin, denklemleri çözen veya metinleri işleyen bir uygulamada kod yürütmeyi kullanabilirsiniz.
Kod yürütme işlemi hem AI Studio'da hem de Gemini API'de kullanılabilir. AI Studio'da, Araçlar altındaki sağ panelde kod yürütmeyi etkinleştirebilirsiniz. Gemini API, işlev çağrısına benzer şekilde, bir araç olarak kod yürütme imkanı sunar. Kod yürütmeyi araç olarak eklemenizin ardından, bunun ne zaman kullanılacağına model karar verir.
Kod yürütme ortamı şu 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.
Başlamadan önce
Gemini API'yi çağırmadan önce seçtiğiniz SDK'nın yüklü olduğundan ve Gemini API anahtarının yapılandırılmış ve kullanıma hazır olduğundan emin olun.
Kod yürütmeye başlayın
Giriş/çıkış (G/Ç)
Gemini 2.0 Flash sürümünden itibaren, kod yürütme işlevi dosya girişini ve grafik çıkışını destekler. Bu yeni giriş ve çıkış özelliklerini kullanarak CSV ve metin dosyaları yükleyebilir, dosyalar hakkında sorular sorabilir ve yanıt kapsamında Matplotlib grafiklerinin oluşturulmasını sağlayabilirsiniz.
G/Ç fiyatlandırması
Kod yürütme G/Ç'sini kullanırken giriş jetonları ve çıkış jetonları için ücretlendirilirsiniz:
Giriş jetonları:
- 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 zamanı 30 saniyedir.
- Kod ortamı hata oluşturursa model, kod çıkışını yeniden oluşturmaya karar verebilir. Bu durum en fazla 5 kez tekrarlanabilir.
- Maksimum dosya giriş boyutu, model jeton penceresiyle sınırlıdır. AI Studio'da, Gemini Flash 2.0 ile maksimum giriş dosyası boyutu 1 milyon jetondur (desteklenen giriş türlerindeki metin dosyaları için yaklaşık 2 MB). Çok büyük bir dosya yüklerseniz AI Studio ilgili dosyayı göndermenize izin vermez.
| Tek dönüş | Çift Yönlü (Multimodal 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 çizim kitaplıkları | Matplotlib | Matplotlib |
| Çok araçlı kullanım | Hayır | Evet |
Faturalandırma
Gemini API'den kod yürütmeyi etkinleştirmek için ek ücret alınmaz. Kullandığınız Gemini modeline bağlı olarak mevcut giriş ve çıkış jetonları üzerinden faturalandırılırsınız.
Kod yürütme için faturalandırma hakkında bilmeniz gereken diğer birkaç nokta aşağıda belirtilmiştir:
- Modele aktardığınız giriş jetonları için yalnızca bir kez faturalandırılırsınız ve model tarafından size döndürülen nihai çıkış jetonları için faturalandırılırsınız.
- Oluşturulan kodu temsil eden jetonlar çıkış jetonları olarak sayılır. Oluşturulan kod, metin ve resimler gibi çok modlu çıktıları içerebilir.
- Kod yürütme sonuçları da çıkış jetonları olarak sayılır.
Faturalandırma modeli aşağıdaki şemada gösterilmektedir:
- Kullandığınız Gemini modeline bağlı olarak mevcut giriş ve çıkış jetonları üzerinden faturalandırılırsınız.
- Gemini, yanıtınızı oluştururken kod yürütmeyi kullanıyorsa orijinal istem, oluşturulan kod ve yürütülen kodun sonucu ara jeton olarak etiketlenir ve giriş jetonları olarak faturalandırılır.
- Gemini daha sonra bir özet oluşturup oluşturulan kodu, yürütülen kodun sonucunu ve son özeti döndürür. Bunlar çıkış jetonları olarak faturalandırılır.
- Gemini API, API yanıtında ara jeton sayısı içerir. Böylece ilk isteminizden sonra neden ek giriş jetonları aldığınızı anlayabilirsiniz.
Sınırlamalar
- Model yalnızca kod oluşturup yürütebilir. 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 becerileri konusunda bazı farklılıklar vardır.