CometAPI ile geliştirinBirden çok model için tek bir API mi gerekiyor?İş akışını Playground'da test edin, ardından model ve maliyet kullanım senaryonuza uyduğunda bir API anahtarı oluşturun.
Gemini API: Şu anda hangi dosya boyutları ve girdi yöntemleri destekleniyor?
12 Ocak 2026 tarihinde Google, Gemini API’sine dosyaları modele nasıl aktardığınızı ve bu dosyaların ne kadar büyük olabileceğini değiştiren bir geliştirici güncellemesi yayımladı. Kısacası: Gemini artık dosyaları harici bağlantılardan ve bulut depolamadan doğrudan getiriyor (yani onları her zaman yüklemek zorunda değilsiniz) ve satır içi dosya boyutu sınırı önemli ölçüde artırıldı. Bu güncellemeler, medyayı veya belgeleri zaten bulut kovalarında depolayan gerçek dünyadaki uygulamalar için sürtünmeyi ortadan kaldırıyor ve kısa süreli prototipleme ve üretim iş akışlarını daha hızlı ve daha düşük maliyetli hâle getiriyor.
12 Ocak 2026'da Google, Gemini API için, dosyaları modele nasıl aktaracağınızı ve bu dosyaların ne kadar büyük olabileceğini değiştiren bir geliştirici güncellemesi yayımladı. Kısaca: Gemini artık dosyaları doğrudan harici bağlantılardan ve bulut depolamadan alabiliyor (yani her zaman yüklemeniz gerekmiyor) ve satır içi dosya boyutu sınırı önemli ölçüde artırıldı. Bu güncellemeler, medyayı veya belgeleri zaten bulut kovalarında saklayan gerçek dünya uygulamalarındaki sürtünmeyi ortadan kaldırır ve kısa prototipleme ile üretim iş akışlarını daha hızlı ve daha ucuz hale getirir.
Netlik, kaynak ataması ve güncel API terminolojisi açısından gözden geçirildi.
Genel HTTPS URL’leri ve imzalı URL’ler (S3 önceden imzalı URL’ler, Azure SAS, vb.).
Google Cloud Storage (GCS) nesne kaydı (bir GCS nesnesini bir kez kaydedin ve yeniden kullanın).
Artırılmış satır içi dosya boyutu — satır içi (istek içi) taşıma sınırları 20 MB → 100 MB olarak yükseltildi (not: PDF’ler gibi bazı dosya türlerinin belgelerde belirtilen biraz farklı etkili sınırları olabilir).
Çok büyük dosyalar için Files API ve toplu işlem yönergeleri değişmedi — Yeniden kullanmayı planladığınız dosyalar veya satır içi/harici sınırları aşan dosyalar için Files API’yi kullanmaya devam edin (dosya başına en fazla 2 GB, projeler 20 GB’a kadar Files API depolama tutabilir; yüklenen Dosyalar varsayılan olarak 48 saat saklanır). GCS kaydı da büyük dosyaları (dosya başına 2 GB) destekler ve yeniden kullanım için kaydedilebilir.
Model uyumluluk notları — bazı eski model aileleri veya özel varyantlar farklı desteğe sahip olabilir (belgelerde, bazı dosya-URI iş akışları için belirli Gemini 2.0 aile modelleri gibi istisnalar belirtilir). Büyük varlıklar göndermeden önce her zaman modele özel belgeleri doğrulayın.
Gemini API’nin dosya işleme yeteneklerindeki değişiklik neden önemli?
Bu güncellemeden önce, Gemini API’nin (Google’ın yapay zekâ modeli) PDF rapor, video, ses dosyası veya bazı görseller gibi dosyaları analiz etmesini istiyorsanız, önce dosyaları Gemini’nin geçici depolamasına yüklemeniz gerekiyordu.
Ve:
yüklenen dosyalar 48 saat sonra siliniyordu;
dosyalar çok büyük olamıyordu (en fazla 20 MB);
dosyalarınız zaten bulutta barındırılıyorsa (GCS, S3 veya Azure gibi), onları yeniden yüklemek zorundaydınız — oldukça zahmetli.
Bu durum geliştirici çabasını ikiye katlıyor, bant genişliği maliyetlerini artırıyor, gecikme ekliyor ve bazen gerçek dünya kullanım senaryolarını (uzun kayıtlar, çok sayfalı kılavuzlar, yüksek çözünürlüklü görseller) uygulanamaz hâle getiriyordu. Daha büyük satır içi yükler ile Gemini’yi mevcut depolamaya işaret edebilme (genel veya imzalı URL’ler ya da kayıtlı GCS nesneleri aracılığıyla) kombinasyonu, “veri”dan “yararlı model çıktısı”na giden yolu dramatik biçimde kısaltır:
Sıfır Kopya Verimliliği: Gemini’nin mevcut depolama kovalarınızdan (GCS) veya harici URL’lerden (AWS S3, Azure) dosyaları doğrudan okuyabilmesiyle “ETL vergisini” ortadan kaldırırsınız. Bir dosyayı arka uç sunucunuza indirip ardından Google’a yeniden yüklemeniz gerekmez. Model verinin yanına gelir, tersi değil.
Durumsuz Mimari: Artırılan 100 MB’lık satır içi sınır daha güçlü “durumsuz” istekleri mümkün kılar. Her etkileşim için bir dosya kimliğinin yaşam döngüsünü yönetmeniz veya eski yüklemeleri temizlemeniz gerekmez.
Çoklu Buluta Uyum: İmzalı URL desteği, Gemini API’nin AWS veya Azure’da barındırılan veri gölleriyle uyumlu çalışmasını sağlar. Bu, çoklu bulut stratejileri olan işletmeler için büyük bir kazançtır; tüm depolama altyapısını Google Cloud’a taşımadan Gemini’nin muhakeme yeteneklerinden yararlanmayı sağlar.
Çok modlu yapay zekâ uygulamaları için uygundur (video, ses ve belge anlama gibi).
Bu güncellemeler, veri alma sürecini önemli ölçüde basitleştirir; geliştiricilerin, ek yükleme adımlarına gerek kalmadan buluttaki veya ağdaki mevcut verilere Gemini üzerinden doğrudan erişmesini sağlar.
Kimler en çok fayda sağlar?
Ürün ekipleri: belge odaklı özellikler (özetleme, kılavuzlar üzerinde Soru-Cevap, sözleşme inceleme) geliştirirken.
Medya/eğlence: bulutta zaten depolanan görsel, ses veya video varlıklarını analiz eden uygulamalar.
Kurumsal müşteriler: GCS’de büyük veri gölleri bulunan ve modelin, kopyalamak yerine kanonik kopyalara başvurmasını isteyenler.
Araştırmacılar ve mühendisler: karmaşık depolama hatları kurmadan, daha büyük gerçek veri setleriyle prototip yapmak isteyenler.
Kısacası: prototipten üretime geçiş daha kolay ve daha ucuz hâle gelir.
Artık Gemini API’ye ne boyutta dosya yükleyebilirsiniz?
Başlık niteliğindeki sayı, anlık kapasitede beş kat artışa işaret ediyor; ancak asıl hikâye sağladığı esneklikte yatıyor.
Farklı yöntemlerle şimdi Gemini API’ye ne kadar büyük dosya yükleyebilirsiniz?
İstek içinde satır içi (base64 veya Part.from_bytes): en fazla 100 MB (bazı PDF’ye özel iş akışları için 50 MB). Dosyanın ≤100 MB olduğu ve basit tek istekli bir akış istediğiniz durumlarda kullanın.
Harici HTTP / İmzalı URL, Gemini tarafından alınır: en fazla 100 MB (Gemini işlemi sırasında URL’yi alır). Harici bulutlardaki içeriği yeniden yüklemekten kaçınmak için kullanın.
Files API (yükleme): dosya başına en fazla 2 GB, proje Files depolaması 20 GB’a kadar, dosyalar 48 saat saklanır. Yeniden kullanacağınız büyük dosyalar veya 100 MB’lık satır içi/harici sınırı aşan dosyalar için kullanın.
GCS nesne kaydı: nesne başına 2 GB’a kadar destekler ve Google Cloud’da zaten barındırılan büyük dosyalar için tasarlanmıştır; kayıt, tekrar tekrar yükleme yapmadan yeniden kullanıma izin verir. Tek seferlik kayıt, sınırlı bir süre için erişim sağlayabilir.
(Tam seçiminiz, dosya boyutuna, yeniden kullanım sıklığına ve dosyanın zaten bulut depolamada bulunup bulunmadığına bağlıdır.)
Yeni 100 MB Standardı
Derhal geçerli olmak üzere, Gemini API satır içi veriler için dosya boyutu sınırını 20 MB’dan 100 MB’a yükseltti.
Daha önce, yüksek çözünürlüklü görseller, karmaşık PDF sözleşmeler veya orta uzunlukta ses klipleriyle çalışan geliştiriciler sık sık 20 MB tavanına takılıyordu. Bu, veriyi parçalara ayırma, medyayı aşağı örnekleme veya nispeten küçük etkileşimler için bile Files API üzerinden ayrı bir yükleme akışı yönetme gibi karmaşık geçici çözümler uygulamalarını gerektiriyordu.
Yeni 100 MB sınırı ile artık API isteğinde (base64 kodlu) önemli ölçüde daha büyük yükleri doğrudan gönderebilirsiniz. Bu, şu açılardan kritik bir iyileştirmedir:
Gerçek zamanlı uygulamalar: Kullanıcı tarafından yüklenmiş 50 MB’lık bir videoyu, eşzamanlı yükleme işi tamamlanmasını beklemeden anlık duygu analizi için işlemek.
Hızlı prototipleme: Bir karmaşık veri setini veya tam uzunlukta bir kitap PDF’sini bağlama penceresine bırakıp bir istem stratejisini derhal test etmek.
Karmaşık çoklu modluluk: Tek bir adımda 4K görseller ve yüksek sadakatli ses segmentlerinin kombinasyonunu, kısıtlayıcı bir sınırı aşma endişesi olmadan göndermek.
Önemli bir not: Satır içi sınır 100 MB olsa da, Gemini API’nin devasa veri setlerini (terabaytlarca veri) işleme kapasitesi Files API ve yeni Harici Bağlantı desteği aracılığıyla kullanılabilir durumda; bu da ağır iş yükleri için pratikte üst sınırı ortadan kaldırır.
Önerilen karar akışı
Dosya ≤ 100 MB ise ve tek istekli sadelik istiyorsanız: satır içi kullanın (Part.from_bytes veya base64 sağlayın). Hızlı demolar veya sunucusuz işlevler için uygundur.
Dosya ≤ 100 MB ise ve halihazırda herkese açık bir yerde veya önceden imzalanmış bir URL ile barındırılıyorsa: file_uri’yı iletin (HTTPS veya imzalı URL). Yükleme gerekmez.
Dosya > 100 MB (ve ≤ 2 GB) ise veya yeniden kullanmayı bekliyorsanız: Files API yükleme veya GCS nesne kaydı önerilir — yinelenen yüklemeleri azaltır ve tekrar eden üretimler için gecikmeyi iyileştirir.
Yeni harici dosya bağlantısı desteği nasıl çalışıyor?
En önemli mimari değişiklik, Gemini API’nin veriyi kendi başına “getirme” yeteneğidir. Bu yetenek, harici dosya bağlantılarını doğrudan okumayı ve yerleşik veri kaynaklarını desteklemeyi sağlar
Artık API, verileri doğrudan URL’lerden alabilir. Bu destek iki farklı senaryoyu kapsar:
(1) Harici URL desteği (Genel / İmzalı URL’ler):
Artık bir dosyaya (PDF, görsel, ses veya video gibi) işaret eden standart bir HTTPS URL’sini doğrudan oluşturma isteğinizde iletebilirsiniz.
Genel URL’ler: Haber makalesi PDF’si veya herkese açık olarak barındırılan bir görsel gibi, halihazırda açık web’de bulunan içerikleri analiz etmek için idealdir.
İmzalı URL’ler: Bu, kurumsal köprüdür. Verileriniz özel bir AWS S3 kovasında veya Azure Blob Storage’da bulunuyorsa, okuma erişimi tanıyan bir Önceden İmzalanmış URL (geçici bağlantı) oluşturabilirsiniz. Bu URL’yi Gemini’ye ilettiğinizde API, işleme sırasında içeriği güvenli bir şekilde alır. Bu, hassas belgeleri Google’ın sunucularına kalıcı olarak taşımadan AWS’de saklanan belgeleri analiz edebileceğiniz anlamına gelir.
Google Cloud IAM rollerine saygı duyar; yani erişimi standart “Storage Object Viewer” izinleriyle kontrol edebilirsiniz.
Yararları: Ara dosyalara gerek yoktur, güvenliği ve performansı artırır, bulut ortamları arasında veri alma için uygundur.
(2) Google Cloud Storage (GCS) ile doğrudan bağlantı:
Veriler Google ekosisteminde zaten bulunuyorsa, entegrasyon daha da sıkıdır. Artık GCS dosyaları için Nesne Kaydı gerçekleştirebilirsiniz.
Yükleme yapmak yerine, dosyanın gs:// URI’sini basitçe “kaydedersiniz”.
İstemci ile API arasında fiilî bir veri aktarımı gerçekleşmediği için bu işlem neredeyse anında tamamlanır.
Yeni özellikleri nasıl kullanırsınız? — Kullanım örnekleri (Python SDK)
Aşağıda yaygın kalıpları gösteren üç pratik Python örneği (eşzamanlı) yer alıyor: (A) satır içi baytlar (yerel dosyadan), (B) harici HTTPS veya imzalı URL, ve (C) bir GCS URI’ye (kaydedilmiş nesne) referans verme. Bu parçacıklar resmi Google Gen AI Python SDK’sını (google-genai) kullanır; model adlarını, kimlik doğrulamayı ve ortam değişkenlerini kurulumunuza göre ayarlayın. Gemini API’ye erişmek için CometAPI’nin API anahtarını kullanabilirsiniz; geliştiricilere daha ucuz API çağrı fiyatları sunan bir yapay zekâ API toplama platformudur.
Önkoşul: pip install --upgrade google-genai ve kimlik bilgilerinizi / ortam değişkenlerinizi ayarlayın (Geliştirici API için API_KEY, Vertex AI için GOOGLE_GENAI_USE_VERTEXAI, GOOGLE_CLOUD_PROJECT, GOOGLE_CLOUD_LOCATION).
Örnek A: Satır içi baytlar (yerel dosya → 100 MB’a kadar gönderin)
# Example A: send a local file's bytes inline (suitable up to 100 MB)from google import genaifrom google.genai import types# Create client (Developer API)client = genai.Client(api_key="YOUR_GEMINI_API_KEY")MODEL = "gemini-2.5-flash" # choose model; production models may differfile_path = "large_document.pdf" # local file <= ~100 MBmime_type = "application/pdf"# Read bytes and create an inline Partwith open(file_path, "rb") as f: data = f.read()part = types.Part.from_bytes(data=data, mime_type=mime_type)# Send the file inline with a textual promptresponse = client.models.generate_content( model=MODEL, contents=[ "Please summarize the attached document in one paragraph.", part, ],)print(response.text)client.close()
Notlar: Bu, dosya baytlarını gömmek için Part.from_bytes(...) kullanır. Satır içi yükler artık ~100 MB’a kadar izinlidir. Bunu aşıyorsanız, GCS veya Files API yaklaşımını kullanın.
Örnek B: Harici HTTPS / imzalı URL (Gemini içeriği alır)
# Example B: reference a public HTTPS URL or a signed URL (Gemini fetches it)from google import genaifrom google.genai import typesclient = genai.Client(api_key="YOUR_API_KEY")MODEL = "gemini-2.5-flash"# Public or signed URL to a PDF/image/audio/etc.external_url = "https://example.com/reports/quarterly_report.pdf"# or a pre-signed S3/Azure URL:# external_url = "https://s3.amazonaws.com/yourbucket/obj?X-Amz-..."part = types.Part.from_uri(file_uri=external_url, mime_type="application/pdf")response = client.models.generate_content( model=MODEL, contents=[ "Give me the three key takeaways from this report.", part, ],)print(response.text)client.close()
Notlar: Gemini, external_url’yi istek zamanında alır. Özel bulut depolama sağlayıcıları (AWS/Azure) için imzalı URL’ler kullanın. Harici alma işlemlerinin pratik boyut/biçim sınırları vardır (bkz. belgeler).
Örnek C: Bir GCS nesnesine (gs://) doğrudan referans verin
# Example C: reference a GCS file (ensure service account has storage access)from google import genaifrom google.genai import types# For Vertex AI usage, standard practice is to use ADC (Application Default Credentials)client = genai.Client(vertexai=True, project="your-project-id", location="us-central1")MODEL = "gemini-3-pro" # example model idgcs_uri = "gs://my-bucket/path/to/manual.pdf"part = types.Part.from_uri(file_uri=gcs_uri, mime_type="application/pdf")response = client.models.generate_content( model=MODEL, contents=[ "Extract the section titles from the attached manual and list them.", part, ],)print(response.text)client.close()
Notlar: GCS erişimi doğru IAM ve hizmet hesabı kurulumu gerektirir (object viewer izinleri, uygun kimlik doğrulama). GCS nesnelerini kaydedip veya referans verirken, çalışma zamanının (Vertex / ADC / hizmet hesabı) gerekli izinlere sahip olduğundan emin olun.
Sınırlamalar ve güvenlik hususları
Boyut ve içerik türü kısıtları
Harici alma boyutu: harici URL’den alma, belgelenmiş sınırlara (pratikte alınan yük başına 100 MB) ve desteklenen MIME/içerik türlerine tabidir. Çok büyük varlıkları (çoklu GB) iletmeniz gerekiyorsa, Files API’yi veya farklı bir işleme hattını kullanın.
Files API mi, satır içi mi, harici URL mi: hangisi ne zaman kullanılmalı
Satır içi (from_bytes) — uygulamanızda baytlar zaten mevcut ve boyut ≤100 MB ise tek seferlik dosyalar için en basit yöntem. Deneyler ve küçük hizmetler için iyi.
Harici URL / İmzalı URL — dosya başka bir yerde (S3, Azure, açık web) yaşıyorsa en iyi yöntem; bayt taşımayı önler ve bant genişliğini azaltır. Özel varlıklar için imzalı URL’ler kullanın.
GCS / Kayıtlı nesneler — verileriniz zaten Google Cloud’da ise ve IAM kontrolleriyle üretim kalıbı istiyorsanız en uygun yöntem.
Files API — birden çok istekte yeniden kullanmak istediğiniz kalıcı veya çok büyük dosyalar için kullanın; dosya başına ve proje kotalarını, saklama/geçicilik politikalarını not edin.
Güvenlik ve gizlilik
İmzalı URL’ler: önceden imzalanmış URL’ler sınırlı bir ömür ve dar izinlerle oluşturulmalıdır. İsteklere uzun ömürlü gizli bilgiler gömmeyin.
IAM & OAuth: GCS’ye doğrudan erişim için hizmet hesaplarını en az ayrıcalık ilkesine göre ayarlayın (okuma erişimi için objectViewer). Kuruluşunuzun anahtar döndürme ve günlükleme en iyi uygulamalarını izleyin.
Veri yerleşimi ve uyumluluk: API’nin harici içeriği almasına izin verdiğinizde, bunun veri işleme ve düzenleyici gereksinimlerinizle uyumlu olduğundan emin olun (bazı düzenlenmiş veriler, geçici olsa bile harici bir hizmete gönderilmemelidir). Model sağlayıcı, günlüklerde isteklerle ilgili üst verileri kalıcı tutabilir — gizlilik analizinizde bunu dikkate alın.
Operasyonel dikkat noktaları
Geçici Files API depolaması: Files API’ye yüklenen dosyalar geçici olabilir (geçmişte 48 saat); uzun süreli depolama için GCS veya diğer dayanıklı depoları kullanın ve doğrudan onlara referans verin.
Tekrarlanan alma: bir dosya her istekte URL üzerinden referans verilir ve sık kullanılırsa, tekrarlanan alma ek yükleri oluşabilir; yoğun yeniden kullanım için önbelleğe almayı veya GCS kopyasını kaydetmeyi düşünün.
Bu, uygulama mimarisini nasıl değiştirir — pratik örnekler
Kullanım senaryosu — belge ağırlıklı bilgi asistanı
GCS’de depolanan ürün kılavuzlarını okuyan bir dahili bilgi asistanı çalıştırıyorsanız, bu GCS nesnelerini bir kez kaydedin (veya gs:// URI’leriyle işaret edin) ve dinamik olarak sorgulayın. Bu, aynı PDF’leri tekrar tekrar yüklemenizi önler ve arka ucunuzu daha basit tutar. Çok büyük kılavuzlar (>100 MB) için Files API/GCS kaydını kullanın.
Kullanım senaryosu — fotoğraf gönderen tüketici mobil uygulaması
Tek atımlık altyazı üretimi için görseller gönderen bir mobil uygulama için, küçük görsellerde (<100 MB) satır içi baytları kullanın. Bu, kullanıcı deneyimini basit tutar ve ikinci bir yükleme adımını önler. Kullanıcılar aynı görseli sık sık yeniden kullanacak veya paylaşacaksa, onu GCS’de saklayın ve bunun yerine bir gs:// veya imzalı URL iletin.
Kullanım senaryosu — ses yazıya dökme hatları
Kısa ses notları (<100 MB / kodeğe bağlı olarak < ~1 dakika) satır içi veya imzalı URL üzerinden iletilebilir. Uzun kayıtlar için Files API ile yükleyin ve verimli yeniden kullanım için sonraki oluşturma çağrılarında dosyaya referans verin. Video/ses iş akışlarında medya belgelerinde sıklıkla ek en iyi uygulama notları bulunur.
Sonuç
Google’ın Gemini API güncellemesi, “mevcut” verileri üretken yapay zekâ iş akışlarına dahil etmeyi çok daha kolaylaştırır: genel veya imzalı URL’lerden doğrudan alma ve GCS kaydı yaygın bir operasyonel sürtünme noktasını ortadan kaldırır ve satır içi yükler için 20 MB → 100 MB sıçraması, mühendislere basit, tek istekli akışlarda daha fazla esneklik sağlar. Uzun ömürlü, çok büyük veya tekrar tekrar kullanılan dosyalar için Files API (dosya başına 2 GB, varsayılan olarak 48 saat depolama)
Başlamak için, CometAPI aracılığıyla ,Gemini 3 Pro ve gemini 3 flash’ın yeteneklerini Playground içinde keşfedin ve ayrıntılı talimatlar için API kılavuzunu inceleyin. Erişmeden önce lütfen CometAPI’ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. CometAPI entegrasyonu kolaylaştırmak için resmi fiyattan çok daha düşük bir fiyat sunar.
