2026 жылдың 12 қаңтарында Google Gemini API-ге қатысты әзірлеушілер жаңартуын жариялады, ол файлдарды модельге қалай жеткізу және олардың қаншалықты үлкен болуы мүмкін екеніне өзгерістер енгізеді. Қысқаша: енді Gemini сыртқы сілтемелерден және бұлттық сақтаудан файлдарды тікелей алады (яғни оларды әрдайым жүктеу міндетті емес), әрі inline файл өлшемі лимиті едәуір артты. Бұл жаңартулар бұлттағы медиа немесе құжаттарды сақтайтын шынайы қолданбалардағы үйкелісті жояды және қысқа прототиптеу мен өндірістік жұмыс ағындарын жылдам әрі арзан етеді.
CometAPI Gemini 3 Pro және gemini 3 flash сияқты gemini api ұсынады, әрі оның бағасы тартымды.
Негізгі жаңартулар — Gemini API-де не жаңалық?
- Сыртқы файл сілтемелерін тікелей оқиды
— Gemini файлдарды келесі дереккөздерден ала алады:- Қоғамдық HTTPS URL-дер және қол қойылған URL-дер (S3 presigned URL-дері, Azure SAS және т.б.).
- Google Cloud Storage (GCS) объектілерін тіркеу (GCS объектісін бір рет тіркеп, қайта пайдалану).
- Inline файл өлшемі артты — inline (сұраныс ішіндегі) жүктеме лимиттері 20 MB → 100 MB деңгейіне көтерілді (ескерту: кейбір файл түрлері, мысалы PDF, құжаттамада көрсетілген сәл өзгеше тиімді лимиттерге ие болуы мүмкін).
- Өте үлкен файлдар үшін Files API және пакеттеу жөніндегі нұсқаулар өзгермеген — қайта пайдаланғыңыз келетін немесе inline/сыртқы лимиттерден үлкен файлдар үшін Files API-ді қолданыңыз (файлдың ең көп мөлшері 2 GB, жобаға 20 GB Files API қоймасы; жүктелген файлдар әдепкіде 48 сағат сақталады). GCS тіркеуі де үлкен файлдарды қолдайды (файлға 2 GB) және тіркеліп, қайта пайдаланылуы мүмкін.
- Модель үйлесімділігі туралы ескертпелер — кейбір ескі модель отбасылары немесе мамандандырылған нұсқаларда қолдау өзгеше болуы мүмкін (құжаттарда кейбір файл-URI жұмыс ағындары үшін белгілі Gemini 2.0 отбасындағы ерекшеліктер аталады). Үлкен активтерді жіберер алдында әр модельге тән құжаттаманы әрдайым тексеріңіз.
Неліктен Gemini API файлдарды өңдеу мүмкіндіктерінің өзгерісі маңызды?
Бұл жаңартуға дейін Gemini API (Google-дың AI моделі) файлдарды талдауын қаласаңыз, мысалы: PDF есеп; видео; аудио файл; немесе бірнеше сурет; алдымен файлдарды Gemini-дің уақытша қоймасына жүктеу қажет болатын.
Және:
- жүктелген файлдар 48 сағаттан кейін жойылатын;
- файлдар тым үлкен болмауы тиіс еді (ең көбі 20MB);
- егер файлдарыңыз бұлтта (мысалы, GCS, S3 немесе Azure) қазірдің өзінде орналастырылған болса, оларды қайта жүктеу керек болатын — өте қолайсыз.
Бұл әзірлеушілерге еңбекті екі еселейді, өткізу қабілеті шығындарын арттырады, кідіріс енгізеді және кейде шынайы қолдану жағдайларын (ұзақ жазбалар, көп беттік нұсқаулықтар, жоғары ажыратымдылықтағы суреттер) мүмкін емес ететін. Үлкенірек inline жүктемелер мен Gemini-ді бар сақтауға (қоғамдық немесе қол қойылған URL-дер, немесе тіркелген GCS объектілері арқылы) бағдарлау қабілетінің тіркесімі “деректерден” “пайдалы модель нәтижесіне” дейінгі жолды едәуір қысқартады:
- Zero-Copy тиімділігі: Gemini-ге бар сақтаудағы (GCS) немесе сыртқы URL-дердегі (AWS S3, Azure) файлдарды тікелей оқуға мүмкіндік беру арқылы сіз “ETL салығын” жоясыз. Файлды өз backend серверіңізге жүктеп алып, қайта Google-ға жүктеудің қажеті жоқ. Модель деректерге келеді, керісінше емес.
- Күйсіз архитектура: 100MB inline лимитінің артуы неғұрлым қуатты “күйсіз” сұраныстарға жол ашады. Сізге әр өзара әрекеттесу үшін файл ID өмірлік циклін басқару немесе ескі жүктемелерді тазалаумен айналысу қажет емес.
- Көп бұлтқа бейтараптық: Қол қойылған URL-дерді қолдау Gemini API-ге AWS немесе Azure-де орналастырылған дерек көлдерімен үйлесімді жұмыс істеуге мүмкіндік береді. Бұл көп бұлт стратегиясы бар кәсіпорындар үшін үлкен жеңіс, олар Gemini-дің пайымдау қабілеттерін барлық сақтау инфрақұрылымын Google Cloud-қа көшірмей-ақ пайдалана алады.
- Көпмодальды AI қолданбаларына қолайлы (мысалы, видео, дауыс және құжаттарды түсіну).
Бұл жаңартулар деректерді қабылдау процесін едәуір жеңілдетеді, әзірлеушілерге бұлттан немесе желіден бар деректерге қосымша жүктеу қадамдарынсыз Gemini арқылы тікелей қол жеткізуге мүмкіндік береді.
Кімдер ең көп пайда көреді?
- Өнім топтары құжатқа бағытталған мүмкіндіктерді құратындар (түйіндеме, нұсқаулықтар бойынша сұрақ-жауап, келісімшартты қарау).
- Медиа/ойын-сауық қолданбалары, бұлтта сақталған сурет, аудио немесе видео активтерді талдайды.
- Кәсіпорындар GCS-тегі үлкен дерек көлдерімен, модельдің деректердің канондық көшірмелеріне сілтеме жасауын қалайды, оларды көбейтпей.
- Зерттеушілер мен инженерлер күрделі сақтау құбырларын құрмай-ақ үлкен, шынайы деректер жиындарымен жылдам прототиптеуді қалайды.
Қысқасы: прототиптен өндіріске дейінгі жол жеңілірек әрі арзанырақ болады.
Қазір Gemini API-ге қандай өлшемдегі файлды жүктеуге болады?
Негізгі сан — дереу сыйымдылықтың бес есе артуы, бірақ шын мәнінде маңыздысы — оның ұсынатын икемділігі.
Әр түрлі әдістер арқылы қазір Gemini API-ге қаншалықты үлкен файл жүктеуге болады?
- Сұранысқа inline (base64 немесе Part.from_bytes): 100 MB-қа дейін (кейбір PDF-ке тән жұмыс ағындары үшін 50 MB). Файлды бір реттік қарапайым ағынмен жібергіңіз келсе және файл ≤100 MB болса, осыны пайдаланыңыз.
- Сыртқы HTTP / Қол қойылған URL-ді Gemini өзі алады: 100 MB-қа дейін (Gemini өңдеу кезінде URL-ді алады). Сыртқы бұлттардан мазмұнды қайта жүктеуден қашу үшін осыны қолданыңыз.
- Files API (жүктеу): файлға 2 GB-қа дейін, жоба Files қоймасы 20 GB-қа дейін, файлдар 48 сағат сақталады. 100 MB inline/сыртқы лимиттен асатын немесе қайта пайдаланылатын үлкен файлдар үшін осыны қолданыңыз.
- GCS объектісін тіркеу: объектке 2 GB-қа дейін қолдайды және Google Cloud-та бұрыннан орналасқан үлкен файлдарға арналған; тіркеу қайталап пайдалануға мүмкіндік береді. Бір реттік тіркеу шектеулі уақытқа қолжетімділік бере алады.
(Нақты таңдауды файл өлшемі, қайта қолдану жиілігі және файлдың бұлтта бұрыннан бар-жоғы анықтайды.)
Жаңа 100MB стандарты
Дереу күшіне енген түрде, Gemini API inline деректер үшін файл өлшемі лимитін 20MB-тан 100MB-қа арттырды.
Бұрын жоғары ажыратымдылықтағы суреттермен, күрделі PDF келісімдермен немесе орташа ұзындықтағы аудио клиптермен жұмыс істейтін әзірлеушілер жиі 20MB шегіне тірелетін. Бұл оларды деректерді бөліктерге бөлу, медианы төмендетіп үлгілеу немесе салыстырмалы түрде кіші өзара әрекеттесулер үшін де Files API арқылы бөлек жүктеу ағынын басқару сияқты күрделі айналып өту жолдарын енгізуге мәжбүр етті.
Жаңа 100MB лимитімен енді айтарлықтай үлкен жүктемелерді API сұранысының ішінде тікелей (base64 кодталған) жібере аласыз. Бұл келесі жағдайлар үшін маңызды жақсарту:
- Нақты уақыттағы қолданбалар: 50MB пайдаланушы жүктеген видеоны дереу пікір талдау үшін өңдеу, асинхронды жүктеу жұмысын күтусіз.
- Жылдам прототиптеу: күрделі деректер жиынын немесе толық көлемді кітап PDF-ін контекст терезесіне тастап, prompt стратегиясын дереу сынау.
- Күрделі көпмодальдылық: Бір жауапта 4K суреттер мен жоғары сапалы аудио сегменттер комбинациясын жіберу, шектеулі лимитке тірелемін деп алаңдамай.
Маңызды: inline лимит 100MB болғанымен, Gemini API-дің алып деректер жиындарын (терабайттар) өңдеу қабілеті Files API және жаңа External Link қолдауы арқылы қолжетімді күйде қалады, ауыр жүктемелер үшін жоғарғы шекті тиімді түрде жояды.
Ұсынылатын шешім қабылдау ағымы
- Егер файл ≤ 100 MB және бір реттік қарапайымдықты қаласаңыз: inline пайдаланыңыз (Part.from_bytes немесе base64 беріңіз). Жылдам демо немесе serverless функциялар үшін жақсы.
- Егер файл ≤ 100 MB және қазірдің өзінде қоғамдық немесе алдын ала қол қойылған URL арқылы орналастырылған болса: file_uri (HTTPS немесе қол қойылған URL) беріңіз. Жүктеу қажет емес.
- Егер файл > 100 MB (және ≤ 2 GB) немесе оны қайта пайдалануды жоспарласаңыз: Files API жүктеу немесе GCS объектісін тіркеу ұсынылады — бұл қайталанатын жүктеулерді азайтады және жиі генерациялар үшін кідіріске әсер етеді.
Жаңа сыртқы файл сілтемелерін қолдау қалай жұмыс істейді?
Ең елеулі архитектуралық өзгеріс — Gemini API-дің деректерді өздігінен “алып” келуі. Бұл мүмкіндік тікелей сыртқы файл сілтемелерін оқуға, кірістірілген дереккөздерді қолдауға арналған.
API енді деректерді URL-дерден тікелей қабылдай алады. Бұл қолдау екі бөлек сценарийді қамтиды:
(1) Сыртқы URL қолдауы (Public / Signed URLs):
Енді генерация сұранысыңызда файлға (PDF, сурет немесе видео секілді) нұсқайтын стандартты HTTPS URL-ді тікелей бере аласыз.
Қоғамдық URL-дер: Ашық вебтегі мазмұнды талдауға қолайлы, мысалы жаңалықтағы PDF мақала немесе қоғамдық түрде орналастырылған сурет.
Қол қойылған URL-дер: Бұл — кәсіпорындарға арналған көпір. Егер деректеріңіз жеке AWS S3 шелек немесе Azure Blob Storage-та болса, Pre-Signed URL (оқуға уақытша қолжетімділік беретін сілтеме) жасауға болады. Бұл URL-ді Gemini-ге бергенде, API өңдеу кезінде мазмұнды қауіпсіз түрде алады. Бұл дегеніңіз, сезімтал құжаттарды AWS-та сақтай отырып, оларды тұрақты түрде Google серверлеріне көшірмей-ақ Gemini арқылы талдай аласыз.
Бұл Google Cloud IAM рөлдерін құрметтейді, яғни қолжетімділікті стандартты "Storage Object Viewer" рұқсаттары арқылы басқара аласыз.
Пайдалар: аралық файлдар қажет емес, қауіпсіздік пен өнімділікті жақсартады, бұлттар арасындағы деректерді алуға қолайлы.
(2) Google Cloud Storage (GCS) жүйесіне тікелей қосылу:
Google экожүйесіндегі деректер үшін интеграция одан да тығыз. Енді GCS файлдары үшін Объектіні тіркеуді орындай аласыз.
Жүктеудің орнына, жай ғана файлдың gs:// URI-ін "тіркейсіз".
Бұл процесс дерлік лезде, өйткені клиентіңіз бен API арасында нақты деректер тасымалы болмайды.
Жаңа мүмкіндіктерді қалай қолданасыз? — Қолдану үлгілері (Python SDK)
Төменде үш практикалық Python мысалы (синхронды) келтірілген, олар жиі кездесетін үлгілерді көрсетеді: (A) inline байттар (жергілікті файлдан), (B) сыртқы HTTPS немесе қол қойылған URL, және (C) GCS URI-ге (тіркелген объект) сілтеме. Бұл үзінділер ресми Google Gen AI Python SDK (google-genai) пайдаланады; модель атауларын, аутентификацияны және орта айнымалыларын өз баптауларыңызға сай реттеңіз. Gemini API-ге қол жеткізу үшін CometAPI-дің API кілтін пайдалана аласыз — ол әзірлеушілерге арзанырақ API қоңырау бағаларын ұсынатын AI API агрегатор платформасы.
Алғышарт:
pip install --upgrade google-genaiжәне тіркеу деректеріңізді / орта айнымалыларын орнатыңыз (Developer API үшінAPI_KEY, Vertex AI үшінGOOGLE_GENAI_USE_VERTEXAI,GOOGLE_CLOUD_PROJECT,GOOGLE_CLOUD_LOCATION).
Мысал A: Inline байттар (жергілікті файл → 100 MB-қа дейін жіберу)
# 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()
Ескертпелер: мұнда файл байттарын енгізу үшін Part.from_bytes(...) пайдаланылады. Inline жүктемелер енді шамамен 100 MB-қа дейін рұқсат етіледі. Егер бұдан асып кетсе, GCS немесе Files API тәсілін қолданыңыз.
Мысал B: Сыртқы HTTPS / қол қойылған URL (Gemini жүктемені өзі алады)
# 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()
Ескертпелер: Gemini external_url-ді сұраныс барысында өзі алады. Жеке бұлт сақтау провайдерлері (AWS/Azure) үшін қол қойылған URL-дерді пайдаланыңыз. Сыртқы алу практикалық өлшем/пішім лимиттеріне бағынады (құжаттаманы қараңыз).
Мысал C: GCS объектісіне (gs://) тікелей сілтеме
# 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()
Ескертпелер: GCS қолжетімділігі дұрыс IAM және қызметтік аккаунт баптауларын талап етеді (object viewer рұқсаттары, тиісті аутентификация). GCS объектілерін тіркегенде немесе сілтеме жасағанда, орындалу ортасы (Vertex / ADC / қызметтік аккаунт) қажетті рұқсаттарға ие екеніне көз жеткізіңіз.
Шектеулер және қауіпсіздік мәселелері
Өлшем және мазмұн түрі шектеулері
Сыртқы алу өлшемі: сыртқы URL алу құжатталған лимиттерге (іс жүзінде алынатын жүктеме 100 MB-қа дейін) және қолдау көрсетілетін MIME/мазмұн түрлеріне бағынады. Егер өте үлкен активтерді (көп гигабайт) беру қажет болса, Files API-ді немесе басқа өңдеу құбырын қолданыңыз.
Files API мен inline және сыртқы URL: қайсысын қашан қолдану
- Inline (from_bytes) — қолданбаңызда байттар дайын тұр және өлшемі ≤100 MB болса, бір реттік файлдар үшін ең қарапайым. Тәжірибе және кіші қызметтер үшін жақсы.
- Сыртқы URL / Қол қойылған URL — файл басқа жерде тұрса (S3, Azure, ашық веб); байттарды жылжытудан қашып, өткізу қабілеті шығындарын азайтады. Жеке активтер үшін қол қойылған URL-дерді қолданыңыз.
- GCS / Тіркелген объектілер — деректеріңіз қазірдің өзінде Google Cloud-та болса және IAM арқылы тұрақты сілтемелермен өндірістік үлгіні қаласаңыз, ең қолайлы.
- Files API — көп рет қолданылатын немесе өте үлкен файлдарды бірнеше сұраныстарда қайта пайдаланғыңыз келсе; файл/жоба квоталарын және сақталудың уақытша саясатын ескеріңіз.
Қауіпсіздік және құпиялылық
- Қол қойылған URL-дер: алдын ала қол қойылған URL-дерді шектелген өмірлік уақытпен және тар рұқсаттармен жасаңыз. Сұраныстарға ұзақ өмір сүретін құпияларды енгізбеңіз.
- IAM және OAuth: GCS-ке тікелей қолжетімділік үшін ең аз құқық принципімен қызметтік аккаунттарды орнатыңыз (оқуға objectViewer). Ұйымыңыздың кілт айналымы және журнал жүргізу үздік тәжірибелерін ұстаныңыз.
- Деректердің орналасуы және сәйкестік: API-ге сыртқы мазмұнды алуға рұқсат бергенде, бұл сіздің деректерді өңдеу және реттеу талаптарына сай келетініне көз жеткізіңіз (кейбір реттелетін деректерді, тіпті уақытша болса да, сыртқы қызметке жіберуге болмайды). Модель провайдері сұраныстар туралы метадеректерді журналдарда сақтауы мүмкін — мұны құпиялылық талдауыңызда ескеріңіз.
Операциялық ескертпелер
- Files API қоймасының уақытшалығы: Files API-ге жүктелген файлдар уақытша болуы мүмкін (тарихи түрде 48 сағат); ұзақ мерзімді сақтау үшін GCS немесе басқа тұрақты қоймаларды пайдаланып, тікелей сілтеме жасаңыз.
- Қайталанатын алу: егер файл әр сұраныста URL арқылы жиі қолданылса, қайталанатын алу үстемақысына ұшырауыңыз мүмкін; жиі қайта пайдалану үшін кэштеуді немесе GCS көшірмесін тіркеуді қарастырыңыз.
Бұл қосымша архитектурасын қалай өзгертеді — тәжірибелік мысалдар
Пайдалану жағдайы — құжатқа бай білім көмекшісі
Егер сіз GCS-та сақталған өнім нұсқаулықтарын оқитын ішкі білім көмекшісін іске қоссanız, сол GCS объектілерін бір рет тіркеп (немесе gs:// URI-лерін көрсетіп), оларды динамикалық түрде сұраңыз. Бұл бірдей PDF-терді қайта-қайта жүктеуден құтқарады және backend-ті оңайлатады. Өте үлкен нұсқаулықтар (>100 MB) үшін Files API/GCS тіркеуін пайдаланыңыз.
Пайдалану жағдайы — тұтынушы мобильді қосымшасының фотосурет жіберуі
Бір реттік сурет сипаттауға арналған мобильді қосымша үшін шағын суреттерді (<100 MB) inline байттармен жіберіңіз. Бұл UX-ті қарапайым етеді және екінші жүктеу қадамын болдырмайды. Егер пайдаланушылар бір суретті жиі қайта пайдаланса немесе бөліссе, оны GCS-қа сақтап, gs:// немесе қол қойылған URL беріңіз.
Пайдалану жағдайы — аудио транскрипциялау пайплайны
Қысқа дауыс жазбаларын (<100 MB / < шамамен 1 минут, кодекке байланысты) inline немесе қол қойылған URL арқылы беруге болады. Ұзақ жазбалар үшін Files API арқылы жүктеп, кейінгі генерация қоңырауларында файлға сілтеме жасаңыз — бұл тиімді қайта пайдалануға мүмкіндік береді. Видео/аудио жұмыс ағындары жиі медиа құжаттарында қосымша үздік тәжірибелермен сүйемелденеді.
Қорытынды
Google-дың Gemini API жаңартуы “бар” деректерді генеративті AI жұмыс ағындарына енгізуді әлдеқайда жеңілдетеді: қоғамдық немесе қол қойылған URL-дерден және GCS тіркеуінен тікелей алу жалпы операциялық үйкелісті жояды, ал inline жүктемелердің 20 MB → 100 MB-қа секіруі инженерлерге қарапайым, бір сұранысты ағымдар үшін көбірек икемділік береді. Ұзақ өмір сүретін, өте үлкен немесе қайта-қайта қолданылатын файлдар үшін Files API (файлға 2 GB, әдепкі 48 сағат сақтау)
Бастау үшін, CometAPI арқылы Gemini API-ді зерттеңіз: ,Gemini 3 Pro және gemini 3 flash мүмкіндіктерін Playground ішінде қолданып көріңіз және егжей-тегжейлі нұсқаулар үшін API guide қараңыз. Қол жеткізбес бұрын, CometAPI-ге кіргеніңізге және API кілтін алғаныңызға көз жеткізіңіз. CometAPI интеграцияға көмектесу үшін ресми бағадан әлдеқайда төмен баға ұсынады.
Дайынсыз ба?→ Gemini 3 Pro тегін сынау !