회의 자료는 파워포인트, 예산표는 엑셀, 계약서 초안은 워드로 오가는 경우가 많습니다. 지금까지 이런 파일을 Gemini API에 넣으려면 PDF로 바꾸거나 텍스트만 뽑아내는 전처리 단계를 따로 두는 일이 흔했습니다.
구글은 11월 Gemini API 릴리스 노트에서 마이크로소프트 오피스와 오픈문서(OpenDocument) 파일을 API에 직접 넘기고, 필요한 페이지·시트·셀 범위만 잘라 처리하는 기능을 차례로 추가했다고 밝혔습니다. 이 글은 공식 문서를 기준으로 지원 형식, 기본 처리 방식, 범위 지정 옵션, 비용 계산 방법과 주의점을 정리했습니다. 자료 확인일은 2026년 11월 22일입니다.
1. 무엇이 바뀌었나: 변환 없이 오피스 파일을 그대로 넣기
Gemini API 릴리스 노트를 보면 변화는 두 번에 나뉘어 기록돼 있습니다. 11월 5일 항목은 PPT, ODP, ODS 입력 지원과 구형 워드(DOC) 파일의 페이지 이미지 처리를 추가했고, 도구(함수)가 오피스 파일·오디오·영상을 모델에게 돌려줄 수 있게 했습니다. 11월 18일 항목은 워드·파워포인트·엑셀 파일을 직접 전달하고, 문서·스프레드시트·영상·오디오를 잘라서(slicing) 넘기는 기능을 소개했습니다.
핵심은 두 가지입니다.
- 파일 변환 단계 없이 원본 오피스 파일을 document 블록으로 넘길 수 있습니다.
- 페이지 범위, 워크시트 탭, 셀 범위, 콘텐츠 레이어를 골라 필요한 부분만 모델에 보낼 수 있습니다.
독립 정리 매체인 Authority AI Tools와 Chasing Next도 같은 내용을 개발자용 업데이트로 다뤘습니다. 다만 이번 변화는 API 기능이며, Gemini 앱에서 파일을 올리는 일반 사용 방식과는 구분해서 봐야 합니다.
2. 지원 형식 10종과 모델별 기본 처리 방식
Gemini API 문서 이해(Document understanding) 안내에 정리된 오피스·오픈문서 형식은 모두 10가지입니다.
- 문서: DOCX, DOC, DOTX, ODT
- 프레젠테이션: PPTX, PPT, ODP
- 스프레드시트: XLSX, XLS, ODS
파일은 인라인 데이터로 넣거나 Files API로 올린 뒤 URI로 참조할 수 있고, 형식마다 정해진 MIME 타입을 함께 지정합니다. 처리 옵션을 따로 주지 않으면 모델 세대에 따라 기본 동작이 다릅니다.
- Gemini 4 이상: DOCX·DOTX·ODT·PPTX와 DOC·PPT·ODP는 페이지(슬라이드) 이미지로 처리되며, 중간 해상도 기준 페이지당 약 560토큰입니다. XLSX·XLS·ODS는 모든 시트의 값, 수식, 시트 이름을 받습니다.
- Gemini 3·2.5: DOCX·DOTX·ODT·PPTX는 추출 텍스트(내장 이미지 포함)로, DOC·PPT·ODP는 페이지 이미지로 처리됩니다. XLSX·XLS는 모든 시트를 값만 담은 CSV로 받습니다.
즉 같은 엑셀 파일이라도 Gemini 4 계열은 수식까지 읽고, 이전 세대는 계산된 값만 읽습니다. 수식 검토가 목적이라면 어떤 모델을 쓰는지부터 확인하는 편이 좋습니다.

3. 페이지·슬라이드 범위와 콘텐츠 레이어 고르기
PDF, 문서, 프레젠테이션 파일은 document 블록에 processing 옵션(type은 static)을 붙이고 그 안의 page_options로 범위를 지정합니다. 공식 문서 기준으로 이 옵션은 Gemini 3과 Gemini 4 이상 모델에서 사용자 입력과 함수 결과(function_result) 양쪽에 쓸 수 있습니다.
- start_page·end_page: 1부터 세는 포함 범위입니다. 0 이하를 넣으면 400 오류가 나고, 전체 페이지 수를 넘는 시작 페이지는 빈 결과를 돌려줍니다. 끝 페이지가 전체 페이지 수를 넘으면 마지막 페이지로 맞춰집니다.
- content_layers: 렌더링한 페이지 이미지(page_image), 추출 텍스트(page_text), 또는 둘 다 고를 수 있습니다. processing을 지정하면 기본값은 페이지 이미지입니다.
- resolution: low·medium·high 가운데 고르며, 페이지당 약 280·560·1,120토큰입니다. 기본값은 medium입니다.
공식 문서가 권하는 순서도 눈여겨볼 만합니다. 분량이 큰 문서나 발표 자료는 먼저 텍스트 레이어로 훑어본 뒤, 차트나 복잡한 레이아웃이 있는 페이지만 고해상도 이미지로 다시 요청하라는 것입니다. 모델은 전체 페이지 수와 워크시트 이름을 자동으로 받기 때문에, 대화 중에 다음 범위를 이어서 요청하는 흐름도 가능하다고 안내돼 있습니다.
4. 엑셀: 시트 탭·셀 범위·수식만 골라 보내기
XLSX, XLS, ODS 파일은 processing 안에 spreadsheet_options를 씁니다.
- sheet_index: 탭 순서 기준 1부터 세는 워크시트 번호입니다. 생략하면 모든 시트를 받으며, 시트당 최대 5만 셀입니다. 0 이하이거나 시트 수보다 큰 값은 400 오류입니다.
- visible_cells: A1:G40이나 B5처럼 표준 A1 표기로 셀 범위를 지정하면, 선택한 모든 레이어가 그 영역으로 잘립니다.
- content_layers: 계산된 값(data), 원래 수식(formulas), 차트와 서식을 보여 주는 렌더링 화면(visual) 가운데 고릅니다. 기본값은 값과 수식입니다.
- resolution: visual 레이어를 켰을 때 화면 렌더링 해상도를 정합니다.
예를 들어 여러 탭으로 된 재무 모델에서 두 번째 탭의 특정 범위 수식만 점검하고 싶다면, 시트 번호와 셀 범위를 지정하고 레이어를 수식 중심으로 고르면 됩니다. 차트 모양까지 봐야 할 때만 visual을 추가하는 식으로 나눠 쓰면 입력량을 줄일 수 있습니다.

5. 비용 계산 방법과 도입 전 주의점
공식 문서는 processing 옵션을 쓰면 선택한 페이지, 시트, 콘텐츠 레이어만 토큰으로 세고 과금한다고 설명합니다. 페이지 이미지 토큰은 Gemini 4·3 모델에서 해상도에 따라 약 280·560·1,120토큰이고, Gemini 2.5 모델은 페이지당 258토큰으로 고정입니다.
아래는 편집부가 공식 수치로 계산한 대략적인 입력 토큰 예시입니다. 실제 호출로 잰 값이 아니며, 프롬프트와 출력 토큰은 빠져 있습니다. 단가는 릴리스 노트에 적힌 Gemini 4 Hydrogen 유료 등급 입력 가격(100만 토큰당 1.50달러)을 썼습니다.
- 80장짜리 발표 자료를 옵션 없이 기본(medium)으로 넣으면 약 4만 4,800토큰, 입력 비용은 약 0.067달러입니다.
- 그중 차트가 있는 5장만 high로 잘라 넣으면 약 5,600토큰, 입력 비용은 약 0.008달러입니다.
도입 전에 확인할 점도 있습니다.
- 파일 한도는 원본 전체에 적용됩니다. 파일당 50MB, 오피스·오픈문서는 2,000페이지(슬라이드), PDF는 1,000페이지까지이며, 일부만 잘라 써도 원본이 이 한도를 넘으면 안 됩니다.
- Files API 보관 기간은 48시간입니다. 같은 파일을 반복해서 쓰는 작업이라면 만료 후 다시 올리는 절차가 필요합니다.
- 문서 간 표기 차이가 있습니다. 11월 5일 릴리스 노트는 ODS 파일에서 첫 번째 시트의 데이터와 수식만 받는다고 적었고 DOCX·PPTX 처리는 그대로라고 했지만, 현재 문서 이해 안내의 표는 Gemini 4 이상에서 ODS 전체 시트, DOCX·PPTX 페이지 이미지 처리로 적고 있습니다. 실제 동작은 사용하는 모델로 작은 파일부터 확인하는 편이 안전합니다.
- 가격은 바뀔 수 있습니다. 예를 들어 릴리스 노트는 Gemini 4 Carbon의 할인 가격이 11월 30일까지라고 밝혔습니다. 계산 전에 가격표를 다시 확인하세요.
- 민감한 업무 파일은 보안 정책을 먼저 봐야 합니다. 계약서나 재무 자료를 외부 API로 보내도 되는지는 회사 내부 규정과 API 데이터 처리 조건을 먼저 확인해야 합니다.
정리하면, 이번 업데이트로 오피스 파일을 변환 없이 넣을 수 있게 됐고, 페이지·시트·셀 범위를 지정하면 필요한 부분만 과금됩니다. 처음 써 본다면 텍스트 레이어로 전체를 훑고, 필요한 페이지만 이미지로 다시 보는 순서부터 시험해 보길 권합니다. 모델 세대에 따라 기본 처리 방식이 다르다는 점도 함께 확인하세요.
출처 (2026년 11월 22일 확인)
- Google AI Studio, Document understanding – Gemini API
- Google AI Studio, Gemini API 릴리스 노트(11월 5일·12일·18일 항목)
- Authority AI Tools, Gemini API November updates
- Chasing Next, Office Files and Multimodal Tool Results in the Gemini API
AI로 생성한 설명용 일러스트이며 실제 사건의 사진이 아닙니다.
