2026년 1월 12일, Google은 Gemini API의 개발자 업데이트를 발표하며 모델에 파일을 입력하는 방식과 허용되는 파일 크기를 변경했습니다. 요약하면: 이제 Gemini는 외부 링크와 클라우드 스토리지에서 파일을 직접 가져올 수 있어 매번 업로드할 필요가 없고, 인라인 파일 크기 제한도 대폭 상향되었습니다. 이 업데이트는 이미 클라우드 버킷에 미디어나 문서를 저장하는 실제 앱의 마찰을 줄이고, 짧은 프로토타이핑과 프로덕션 워크플로를 더 빠르고 저렴하게 만들어 줍니다.
CometAPI는 ,Gemini 3 Pro 및 gemini 3 flash 같은 Gemini API를 제공하며, 매력적인 가격을 갖추고 있습니다.
핵심 업데이트 — Gemini API의 새로운 기능은?
- 외부 파일 링크를 직접 읽음
— Gemini는 다음에서 파일을 가져올 수 있습니다:- 공개 HTTPS URL과 서명된 URL(S3 presigned URL, Azure SAS 등).
- Google Cloud Storage(GCS) 오브젝트 등록(한 번 등록해 재사용).
- 인라인 파일 크기 증가 — 인라인(요청 내) 페이로드 제한이 20 MB → 100 MB로 상향(주의: PDF 등 일부 파일 유형은 문서에 표기된 유효 제한이 약간 다를 수 있음).
- 매우 큰 파일에 대한 Files API 및 배치 가이드 변경 없음 — 재사용할 파일이나 인라인/외부 제한을 초과하는 파일의 경우 Files API를 계속 사용(파일당 최대 2 GB, 프로젝트는 20 GB까지 Files API 저장 가능; 업로드된 파일은 기본적으로 48시간 저장). GCS 등록도 대용량 파일(파일당 2 GB)을 지원하며, 재사용을 위해 등록할 수 있음.
- 모델 호환성 안내 — 일부 구형 모델군이나 특화된 버전은 지원이 다를 수 있음(예: 일부 Gemini 2.0 계열 모델의 특정 file-URI 워크플로 예외가 문서에 명시). 대용량 자산 전송 전에 항상 모델별 문서를 확인할 것.
왜 Gemini API의 파일 처리 기능 변화가 중요한가?
이번 업데이트 이전에는 Gemini API(Google의 AI 모델)로 PDF 보고서, 동영상, 오디오 파일, 이미지 등을 분석하려면 먼저 파일을 Gemini의 임시 저장소에 업로드해야 했습니다.
그리고:
- 업로드된 파일은 48시간 후 삭제되었고;
- 파일 크기 제한(최대 20MB)이 있었으며;
- 파일이 이미 클라우드(GCS, S3, Azure 등)에 호스팅되어 있어도 다시 업로드해야 하는 매우 번거로운 과정이 필요했습니다.
이는 개발자의 작업을 두 배로 늘리고, 대역폭 비용을 증가시키며, 지연을 유발하고, 때로는 실제 사용 사례(장시간 녹음, 다페이지 매뉴얼, 고해상도 이미지)를 비현실적으로 만들었습니다. 더 커진 인라인 페이로드와 기존 스토리지(GCS, AWS S3, Azure)의 공개/서명 URL 또는 등록된 GCS 오브젝트를 바로 지정할 수 있는 기능의 결합은 “데이터”에서 “유용한 모델 출력”까지의 경로를 획기적으로 단축합니다:
- 제로-카피 효율성: Gemini가 기존 스토리지 버킷(GCS)이나 외부 URL(AWS S3, Azure)에서 직접 읽도록 함으로써 “ETL 부담”을 없앨 수 있습니다. 더 이상 백엔드 서버로 파일을 다운로드한 뒤 다시 Google로 업로드할 필요가 없습니다. 데이터로 모델이 찾아가게 됩니다.
- 스테이트리스 아키텍처: 상향된 100MB 인라인 제한은 더 강력한 “스테이트리스” 요청을 가능하게 합니다. 파일 ID의 라이프사이클을 관리하거나 매 상호작용마다 오래된 업로드를 정리하는 문제를 신경 쓰지 않아도 됩니다.
- 멀티 클라우드 중립성: 서명된 URL 지원으로 Gemini API가 AWS나 Azure에 호스팅된 데이터 레이크와도 잘 연동됩니다. 멀티 클라우드 전략을 가진 엔터프라이즈가 전체 스토리지 인프라를 Google Cloud로 이전하지 않고도 Gemini의 추론 능력을 활용할 수 있는 큰 이점입니다.
- 비디오, 음성, 문서 이해 등 멀티모달 AI 애플리케이션에 적합.
이 업데이트는 데이터 수집 프로세스를 크게 단순화하여, 추가 업로드 단계 없이 클라우드나 네트워크의 기존 데이터를 Gemini가 직접 액세스하도록 합니다.
누가 가장 큰 혜택을 받나?
- 제품 팀: 문서 중심 기능(요약, 매뉴얼 Q&A, 계약 검토)을 구축하는 팀
- 미디어/엔터테인먼트 앱: 이미 클라우드에 저장된 이미지, 오디오, 비디오 자산을 분석
- 기업: GCS의 대규모 데이터 레이크를 모델이 참조하도록 하여 원본 사본을 중복 없이 활용
- 연구자와 엔지니어: 더 큰 실제 데이터셋으로 복잡한 스토리지 파이프라인 없이 빠르게 프로토타입
요약: 프로토타입부터 프로덕션까지 더 쉽고 저렴해집니다.
지금 Gemini API로 얼마나 큰 파일을 업로드할 수 있나?
헤드라인 수치로는 즉시 용량이 5배 증가했지만, 진짜 이야기는 유연성에 있습니다.
방법별로 지금 Gemini API에 업로드할 수 있는 파일 크기는?
- 요청 인라인(base64 또는 Part.from_bytes): 최대 100 MB(일부 PDF 전용 워크플로는 50 MB). 파일을 한 번의 간단한 요청 흐름으로 보내고 싶고 크기가 ≤100 MB일 때 사용.
- Gemini가 가져오는 외부 HTTP/서명 URL: 최대 100 MB(처리 중에 URL을 페치). 외부 클라우드의 콘텐츠를 재업로드하지 않으려는 경우 사용.
- Files API(업로드): 파일당 최대 2 GB, 프로젝트 Files 저장소는 최대 20 GB, 파일은 48시간 저장. 100 MB 인라인/외부 제한을 초과하거나 재사용할 대형 파일에 사용.
- GCS 오브젝트 등록: 오브젝트당 최대 2 GB 지원, 이미 Google Cloud에 호스팅된 대형 파일에 적합; 등록으로 반복 업로드 없이 재사용 가능. 일회 등록으로 제한 기간 접근을 부여할 수 있음.
(정확한 선택은 파일 크기, 재사용 빈도, 파일이 이미 클라우드에 존재하는지에 따라 달라집니다.)
새로운 100MB 기준
즉시 효력이 발생하여, Gemini API의 인라인 데이터 파일 크기 제한이 20MB에서 100MB로 증가했습니다.
이전에는 고해상도 이미지, 복잡한 PDF 계약서, 중간 길이의 오디오 클립을 다루는 개발자들이 20MB 상한에 자주 걸렸습니다. 이로 인해 데이터를 청크로 나누거나, 미디어를 다운샘플링하거나, 비교적 작은 상호작용에도 Files API를 통한 별도 업로드 흐름을 구현하는 등의 복잡한 우회가 필요했습니다.
새로운 100MB 제한으로, 이제 API 요청에 파일을(base64 인코딩으로) 직접 훨씬 더 크게 전달할 수 있습니다. 이는 다음에 중요한 개선입니다:
- 실시간 애플리케이션: 50MB 사용자 업로드 동영상을 즉시 감성 분석에 처리하며 비동기 업로드 작업 완료를 기다리지 않아도 됨.
- 신속한 프로토타이핑: 복잡한 데이터셋이나 장편 PDF를 컨텍스트 윈도우에 바로 넣어 프롬프트 전략을 즉시 시험.
- 복합 멀티모달리티: 4K 이미지와 고품질 오디오 세그먼트를 한 번의 턴에 함께 전송하면서 제한에 걸릴 걱정 감소.
주의할 점은 인라인 제한이 100MB이지만, Files API와 새로운 외부 링크 지원을 통해 테라바이트 규모의 대규모 데이터 처리 능력은 그대로 유지되어, 대형 워크로드에 대해 사실상 상한을 제거합니다.
권장 의사결정 플로우
- 파일이 ≤ 100 MB이고 단일 요청의 단순함을 원한다면: 인라인 사용(Part.from_bytes 또는 base64 제공). 빠른 데모나 서버리스 함수에 적합.
- 파일이 ≤ 100 MB이고 이미 공개 또는 프리사인드 URL로 호스팅되어 있다면: file_uri(HTTPS 또는 서명 URL) 전달. 업로드 필요 없음.
- 파일이 > 100 MB(그리고 ≤ 2 GB)이거나 재사용할 예정이라면: Files API 업로드 또는 GCS 오브젝트 등록 권장 — 반복 업로드를 줄이고 반복 생성의 지연을 개선.
새로운 외부 파일 링크 지원은 어떻게 작동하나?
가장 중요한 아키텍처 변화는 Gemini API가 스스로 데이터를 “페치”할 수 있게 된 것입니다. 이는 외부 파일 링크를 직접 읽는 기능으로, 내장 데이터 소스를 지원합니다.
API는 이제 URL에서 데이터를 직접 수집할 수 있습니다. 이 지원은 두 가지 시나리오를 포괄합니다:
(1) 외부 URL 지원(공개/서명된 URL):
PDF, 이미지, 오디오, 비디오 같은 파일을 가리키는 표준 HTTPS URL을 생성 요청에 직접 전달할 수 있습니다.
공개 URL: 공개 웹에 이미 있는 콘텐츠(뉴스 기사 PDF나 공개 호스팅 이미지 등)를 분석하는 데 이상적입니다.
서명된 URL: 엔터프라이즈를 위한 다리 역할을 합니다. 데이터가 비공개 AWS S3 버킷이나 Azure Blob Storage에 있다면, 읽기 접근 권한을 부여하는 프리사인드 URL을 생성할 수 있습니다(일시적 링크). 이 URL을 Gemini에 전달하면, API가 처리 중에 안전하게 콘텐츠를 가져옵니다. 즉, AWS에 저장된 민감 문서를 Google 서버로 영구적으로 이동하지 않고도 Gemini로 분석할 수 있습니다.
이는 Google Cloud IAM 역할을 준수하므로, 표준 "Storage Object Viewer" 권한을 사용해 접근을 제어할 수 있음을 의미합니다.
장점: 중간 파일이 필요 없어 보안과 성능이 개선되며, 클라우드 간 데이터 검색에 적합합니다.
(2) Google Cloud Storage(GCS) 직접 연결:
이미 Google 생태계에 있는 데이터의 경우 통합은 더욱 긴밀합니다. 이제 GCS 파일에 대해 **오브젝트 등록(Object Registration)**을 수행할 수 있습니다.
업로드 대신 gs:// URI를 단순히 “등록”하면 됩니다.
클라이언트와 API 간 실제 데이터 전송이 발생하지 않기 때문에 이 과정은 거의 즉각적입니다.
어떻게 새 기능을 사용하나? — 사용 예시(Python SDK)
아래는 일반적인 패턴을 보여주는 실용적인 동기 Python 예시 세 가지입니다: (A) 인라인 바이트(로컬 파일), (B) 외부 HTTPS 또는 서명 URL, (C) GCS URI 참조(등록 오브젝트). 이 스니펫은 공식 Google Gen AI Python SDK(google-genai)를 사용합니다. 모델 이름, 인증, 환경 변수를 셋업에 맞게 조정하세요. CometAPI의 API 키를 사용해 Gemini API에 접근할 수 있으며, 개발자에게 더 저렴한 API 호출 가격을 제공합니다.
사전 준비사항:
pip install --upgrade google-genai를 수행하고 자격 증명/환경 변수를 설정하세요(Developer API는API_KEY, Vertex AI는GOOGLE_GENAI_USE_VERTEXAI,GOOGLE_CLOUD_PROJECT,GOOGLE_CLOUD_LOCATION).
예시 A: 인라인 바이트(로컬 파일 → 최대 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(...)로 파일 바이트를 임베드합니다. 인라인 페이로드는 이제 약 ~100 MB까지 허용됩니다. 이를 초과하면 GCS 또는 Files API 방식을 사용하세요.
예시 B: 외부 HTTPS/서명 URL(Genimi가 페이로드를 페치)
# 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/콘텐츠 유형에 따릅니다. 매우 큰 자산(수 GB)을 전달해야 한다면 Files API 또는 다른 처리 파이프라인을 사용하세요.
Files API vs 인라인 vs 외부 URL: 언제 무엇을 쓸지
- 인라인(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에 저장된 제품 매뉴얼을 읽는다면, 해당 GCS 오브젝트를 한 번 등록(또는 gs:// URI로 지정)하고 동적으로 질의하세요. 동일 PDF를 반복 업로드하는 일을 피하고 백엔드를 더 단순하게 유지합니다. 100 MB를 초과하는 매우 큰 매뉴얼에는 Files API/GCS 등록을 사용하세요.
사용 사례 — 사진을 보내는 소비자용 모바일 앱
단발 캡셔닝을 위한 모바일 앱에는 작은 이미지(100 MB 미만)에 인라인 바이트를 사용하세요. UX를 단순하게 유지하고 두 번째 업로드 단계를 피합니다. 사용자가 동일 이미지를 자주 재사용/공유한다면, GCS에 저장하고 gs:// 또는 서명 URL을 전달하는 방식을 선택하세요.
사용 사례 — 오디오 전사 파이프라인
짧은 음성 메모(100 MB 미만 / 코덱에 따라 약 1분 미만)는 인라인 또는 서명 URL로 전달할 수 있습니다. 장시간 녹음은 Files API로 업로드하고 이후 generate 호출에서 파일을 참조해 효율적으로 재사용하세요. 비디오/오디오 워크플로에는 미디어 문서의 추가 모범 사례 노트가 종종 있습니다.
결론
Google의 Gemini API 업데이트는 기존 데이터를 생성형 AI 워크플로로 가져오는 일을 훨씬 쉽게 만듭니다: 공개 또는 서명 URL과 GCS 등록에서 직접 페치하는 기능이 흔한 운영상의 마찰을 제거하고, 인라인 페이로드의 20 MB → 100 MB 상향은 단순한 단일 요청 흐름에 더 많은 유연성을 제공합니다. 장기 보관, 매우 큰 파일, 반복 사용에는 Files API(파일당 2 GB, 기본 48시간 저장)
시작하려면 CometAPI를 통해 Gemini API를 탐색해 보세요. ,Gemini 3 Pro 및 gemini 3 flash 기능을 Playground에서 시험하고 자세한 지침은 API guide를 참조하세요. 접근 전에 CometAPI에 로그인하고 API 키를 발급받았는지 확인하십시오. CometAPI는 공식 가격보다 훨씬 저렴한 가격을 제공하여 통합을 돕습니다.
Ready to Go?→ Gemini 3 Pro 무료 체험 !