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 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ütme aracını ekledikten sonra, 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ızla başa çıkabiliyorsa kod yürütmeyi tercih etmeniz gerekir. Kod yürütmenin kullanımı daha basittir (yalnızca etkinleştirmeniz gerekir) ve tek bir GenerateContent isteğiyle çözülür (bu nedenle tek bir ödeme 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. Testlerimize göre en iyi performansı gösteren model Gemini 1.5 Pro'dur.