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. 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, 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 Gelişmiş ayarlar 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ütmeyi araç olarak eklemenizin ardından, bunun ne zaman kullanılacağına model karar verir.
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.
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 ucunda sabit ve izole bir ortamda kod çalıştırmasına olanak tanır.
- İş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 gelen çıkışı geri göndermek için ek bir GenerateContent isteği alır (bu nedenle birden fazla ücret alınır).
Çoğu durumda, yerel olarak çalıştırmak istediğiniz kendi işlevleriniz varsa işlev çağrısını, API'nin sizin için 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ütme özelliğini etkinleştirmek için ek ücret alınmaz. Giriş ve çıkış jetonlarının geçerli ücreti üzerinden 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.
- Kod yürütme sonuçları da çıkış jetonu olarak sayılır.
Sınırlamalar
- Model yalnızca kod oluşturabilir ve çalıştırabilir. Medya dosyaları gibi diğer yapıları döndüremez.
- Bu özellik, dosya G/Ç'yi veya metin dışı çıkış içeren kullanım alanlarını (ör. veri noktaları veya CSV dosyası yükleme) 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 becerisinde bazı farklılıklar vardır. Yaptığımız testlere göre, Gemini 1.5 Pro en iyi performans gösteren modeldir.