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, kod yürütmeyi Gelişmiş ayarlar bölümünden 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ütmeye başlayın
 ai.google.dev'de göster
|
 Google Colab'de çalıştır
|
 Kaynağı GitHub'da görüntüle
|
Bu bölümde, quickstart gösterildiği gibi, Gemini SDK'sı yüklediğiniz ve bir API anahtarı yapılandırdığınız varsayılmaktadır.
Kod yürütme ve işlev çağırma
Kod yürütme ve işlev çağırma benzer özelliklerdir:
- Kod yürütme, modelin API arka ucundaki kodu sabit ve izole bir ortamda çalıştırmasını sağlar.
- İşlev çağrısı, modelin istediği işlevleri istediğiniz ortamda çalıştırmanıza olanak tanır.
Genel olarak, kullanım alanınızı işleyebiliyorsa kod yürütmeyi tercih etmeniz gerekir. Kod yürütmenin kullanımı daha kolaydır (sadece etkinleştirirseniz) ve tek bir GenerateContent isteğinde çözümlenir (dolayısıyla tek bir ücret alınır). İşlev çağrısı, her işlev çağrısından çıkışı geri göndermek için ek GenerateContent isteği alır (bu nedenle birden fazla ücret alınır).
Çoğu durumda, yerel olarak çalıştırmak istediğiniz işlevleriniz varsa işlev çağrısını kullanmanız gerekir. API'nin sizin yerinize Python kodu yazıp çalıştırmasını ve sonucu döndürmesini istiyorsanız kod yürütmeyi kullanmanız gerekir.
Faturalandırma
Gemini API'den kod yürütmeyi etkinleştirmek için ek ücret alınmaz. Geçerli 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 modelin size döndürdüğü nihai çıkış jetonları için faturalandırılırsınız.
- Oluşturulan kodu temsil eden jetonlar çıkış jetonları olarak sayılır.
- Kod yürütme sonuçları da çıkış jetonları olarak sayılır.
Sınırlamalar
- Model yalnızca kod oluşturup yürütebilir. Medya dosyaları gibi diğer yapıları döndüremez.
- Bu özellik, dosya G/Ç'sini veya metin dışı çıkışlar içeren kullanım alanlarını (örneğin, veri grafikleri) desteklemez.
- Kod yürütme, zaman aşımına uğramadan önce en fazla 30 saniye boyunca çalışabilir.
- 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 yeteneklerinde bazı farklılıklar vardır. Yaptığımız testlere göre, Gemini 1.5 Pro en iyi performans gösteren modeldir.