Gemini 완전 가이드: 요금제, 모델, Skills, AI Studio, Antigravity

이 가이드에 대하여

이 가이드는 Gemini의 한국어 참고 문서로, Google 공식 페이지에 흩어져 있는 정보를 하나로 정리했습니다. 어떤 제품이 있는지, 요금제는 어떻게 나뉘는지, 모델은 어떻게 고르는지, API는 어떻게 연결하는지, 명령줄 개발 도구는 어떻게 쓰는지, 그리고 데이터가 어떻게 처리되는지를 다룹니다.

조회 날짜와 사용 방법

모든 사실의 조회 날짜는 2026-11-06입니다. 각 장 끝에 출처와 조회 날짜를 표시했으며, 가이드 안에서 따로 표시하지 않은 내용은 모두 이 날의 공식 페이지를 기준으로 합니다.

Gemini는 올해 변화가 매우 컸습니다. 이름, 요금제, 모델, 가격이 거의 한 바퀴 바뀌었습니다. 본문의 가격, 날짜, 기능 범위는 다시 바뀔 수 있으므로, 결정을 내리기 전에 공식 페이지에서 한 번 더 확인하시기 바랍니다.

올해 무엇이 바뀌었나

인식이 아직 2025년에 머물러 있다면, 다음 몇 가지를 먼저 업데이트해야 합니다.

작성 원칙

• 공식 페이지에서 확인되는 사실만 씁니다. 확인할 수 없거나 페이지마다 설명이 서로 모순되는 부분은 “공식 미공개” 또는 “페이지별 설명 불일치”라고 직접 적으며, 제3자 수치로 채우지 않습니다.
• 대만 달러 가격은 “참고 가격”으로 표시하며, Google 공식 페이지에 당시 표시된 값을 기준으로 합니다.
• 모델 품질의 우열은 매기지 않습니다. 각 사가 발표한 benchmark는 모두 자체 공개 수치이므로 직접 비교할 수 없습니다. 여러분의 작업으로 직접 테스트하시기 바랍니다.
• 본문의 일부 기능에는 연령, 지역, 계정 유형 제한이 있으며, 각 장에서 따로 표시합니다.

읽는 방법

어떤 진입점을 써야 할지 알고 싶다면 2장을 보십시오. 유료 결제가 필요한지 알고 싶다면 3장을 보십시오. 코드를 작성하거나 API를 연결한다면 10장과 11장을 보십시오. 데이터가 어디로 가는지 걱정된다면 바로 12장을 보십시오.

출처: Gemini release notes, Gemini API 모델 페이지, Gemini 구독 요금제 (2026-11-06 조회)

Gemini란 무엇인가: 제품 지도

Google에서 “Gemini”는 모델 패밀리와 일련의 제품군을 동시에 가리킵니다. 먼저 진입점을 구분한 다음, 어느 것을 쓸지 정하십시오.

일반 사용자의 진입점

Google의 소비자 요금제 페이지는 Gemini 관련 제품을 하나의 제품 라인으로 나열합니다.

• Gemini app: 대화, 파일 분석, Canvas, Deep Research, Gemini Live, 이미지와 동영상 생성.
• Google Flow: 이미지와 동영상 창작.
• Gemini Notebook: NotebookLM과 연동되는 노트북(5장).
• Gmail, Docs, Vids 안의 Gemini: Google 애플리케이션 안에서 바로 사용.
• Search의 AI Mode와 에이전트 기능.
• Google Antigravity: 개발용.
• Project Genie: Ultra 요금제.
• YouTube Premium Lite, Premium: Pro, Ultra 요금제에 포함.

데스크톱: Gemini의 Windows App은 2026-09-10에 출시되었고, macOS 버전은 2026-10-13에 Antigravity 코드 인터페이스가 추가되었습니다.

개발자의 세 가지 진입점

Antigravity 공식 문서는 네 가지 surface를 나열합니다.

• 데스크톱 App(v2.5 이상)
• CLI agy(v1.2 이상)
• IDE 확장 프로그램(VS Code, JetBrains, Visual Studio, Zed, Xcode, Eclipse)
• Antigravity SDK(Python)

진입점 고르는 방법

최근 공식 업데이트 타임라인

공식 release notes에서 최근 3개월의 주요 날짜입니다.

조회 당일(2026-11-06) 기준으로 release notes에는 아직 11월 항목이 없습니다.

출처: Gemini 구독 요금제(대만), Google Antigravity 시작하기, Gemini release notes (2026-11-06 조회)

요금제와 가격

Gemini의 개인 요금제는 현재 Google AI Plus, Pro, Ultra의 3단계에 무료 버전을 더한 구성입니다. 요금제는 모델뿐 아니라 저장 공간, Flow credits, 그 밖의 Google 서비스까지 묶여 있습니다.

개인 요금제(대만)

아래 표는 대만 공식 페이지의 표시 가격이며, NT$는 참고 가격입니다. 실제 금액은 결제 페이지를 기준으로 하십시오.

Ultra의 두 등급이 각각 어느 Flow credits 수치에 해당하는지는 공식 페이지에 명확히 적혀 있지 않습니다.

Pro에는 추가로 1M token 윈도우, Deep Research, Veo 3.1 Lite 제한 체험, YouTube Premium Lite, Antigravity의 기본 agent 모델 접근, Notebook 오디오 요약 등의 할당량 5배가 포함됩니다. Ultra에는 추가로 YouTube Premium 개인용, Project Genie, Antigravity의 5배 또는 20배 할당량, Tasks in Gemini의 얼리 액세스(특정 국가 한정)가 포함됩니다.

미국 공식 가격

요금제는 언제든 취소할 수 있으며, 일부 청구 주기는 환불되지 않습니다(법규상 요구되는 경우 제외). 학생 요금제 조건은 2026-08-19 release note를 참고하십시오.

대만에서 구매할 수 있는가

공식 “Gemini Apps limits & feature availability”의 국가 목록에서 Taiwan은 AI Plus와 AI Pro, Ultra의 이용 가능 목록에 모두 포함되어 있습니다.

사용량 계산 방식

• 사용량은 고정된 횟수가 아니라 연산량입니다.
• 5시간마다 초기화되며, 주간 상한에 도달할 때까지 적용됩니다.
• 동영상 생성이 사용량을 가장 많이 소모하고, 그다음이 Deep Research이며, 일반 채팅이 가장 적게 듭니다.
• AI credits를 구매해 한도를 늘릴 수 있으며, Settings의 Usage Limits에서 현재 사용량을 확인할 수 있습니다.
• 사용량을 모두 소진한 뒤에도 Flash-Lite는 계속 사용할 수 있습니다.
• 공식 설명에 따르면 한도는 용량에 따라 별도 공지 없이 조정될 수 있습니다.

Context 윈도우(Gemini app)

기업 및 팀 요금제

Google Workspace의 요금제 페이지에도 Gemini가 포함된 요금제(AI 채팅, Notebook, Gmail, Drive, Sheets, Meet의 AI 기능)가 나열되어 있으며, Enterprise는 문의 방식입니다. 대만 달러 가격은 공식 미공개입니다.

Antigravity의 요금제

모든 요금제에 Gemini 3.8 Flash와 무제한 Tab completion이 포함됩니다. Pro는 5시간마다 초기화되는 할당량과 주간 상한이 있고, Ultra가 가장 높습니다. Pro, Ultra는 AI credits를 구매해 초과 사용할 수 있습니다(Never 또는 Always로 설정 가능). 자체 API key 사용(BYOK)은 지원하지 않습니다. 구체적인 할당량 수치는 공식적으로 공개되지 않았으며 “더 높음”이라고만 적혀 있습니다.

출처: Gemini 구독 요금제(대만), Gemini 구독 요금제(미국), Gemini Apps limits & feature availability, Antigravity Plans, Google Workspace AI (2026-11-06 조회)

모델 패밀리

Gemini는 2026년에 4세대로 접어들었습니다. API에서 사용 가능한 모델과 상태는 다음과 같으며, 아래 표는 공식 models 페이지(2026-11-06)에서 가져왔습니다.

Gemini API의 사용 가능 모델

특수 용도 모델: Nano Banana 2.1(gemini-nano-banana-2.1), Nano Banana 2(gemini-3.1-flash-image), Nano Banana 2 Lite, Nano Banana Pro(gemini-3-pro-image), Gemini Omni Flash, Gemini 3.8 Live, 3.5 Transcribe, 각종 TTS, 그리고 Gemini Embedding 2(gemini-embedding-2).

Gemini 4 Argon

공식 포지셔닝은 플래그십 추론 모델이며, 복잡한 소프트웨어 엔지니어링, 수학·과학, 자율적인 다단계 agent, 긴 decode에 적합합니다.

출시 일정:

• 2026-09-30: 사이버 보안 방어 담당자 등을 위한 Fairwind Program에 우선 제공.
• 2026-10-13: Gemini app에서 AI Pro, Ultra에 공개(Google 공식 블로그).
• API: 유료 티어에서 사용 가능하며, 무료 티어에서는 사용할 수 없음.

가격(미국 달러, 100만 token당):

즉 현행 가격은 단계적 가격이며, 12월부터 조정됩니다.

그 밖의 주력 모델

Gemini 3.8 Flash: 공식 포지셔닝은 가장 강력한 Flash이며, 장시간 소프트웨어 엔지니어링, agent, 기업 워크플로에 사용합니다. 입력 1,048,576, 출력 65,536이며, thinking은 low, medium, high이고 minimal은 지원하지 않아 설정하면 오류가 발생합니다. 가격은 $0.75/$3.75이고 2027-01-01부터 $1.50/$7.50입니다. 무료 티어에서 사용할 수 있습니다.

Gemini 3.5 Flash-Lite: 낮은 지연 시간과 낮은 비용이 특징이며, 서브 agent와 문서 파싱에 사용합니다. 가격은 $0.30/$2.50이고, 무료 티어에서 사용할 수 있습니다(cache 없음).

Gemini 3.1 Pro Preview: 입력은 200k 이하 $2, 초과 $4이고, 출력은 200k 이하 $12, 초과 $18입니다. 무료 티어에서는 사용할 수 없습니다.

Gemini 4 Carbon

DeepMind 페이지는 Gemini 4 Carbon을 next frontier model로 소개합니다. 작성 시점에는 일반 사용자에게 공개되지 않았고, API 가격 페이지에도 없으며, 세부 사항은 공식 미공개입니다.

Thinking 설정

사고 token은 출력 token과 함께 과금됩니다. API는 사고 요약만 반환하지만(thinking_summaries: "auto"), 전체 사고량을 기준으로 과금합니다. 공식 권장 사항은 모든 등급에서 자체 평가를 한 번씩 실행해 보고, 기준을 충족하는 가장 낮은 등급을 고르라는 것입니다.

파라미터 변경

Gemini 3.6 이후와 Gemini 4에서는 요청에서 temperature, top_p, top_k를 제거하십시오. 이 파라미터들은 현재 무시되며, 이후에는 오류로 바뀔 예정입니다.

Antigravity에서 선택 가능한 모델

Claude Sonnet 4.6, Opus 4.6과 GPT-OSS-120b는 2026-11-18에 제거될 예정입니다. 추론 강도는 Low, Medium, High의 세 단계가 있습니다.

Gemini app에서 선택할 수 있는 것

공식 support 페이지는 요금제별로 모델을 나열하지 않는다고 명시합니다. 구독 페이지의 표기는 무료 버전은 Flash-Lite, Plus는 Flash, Pro는 Argon, Pro, Flash를 포함합니다. 페이지마다 설명이 조금씩 다르므로, 실제로는 여러분 계정의 모델 선택 메뉴를 기준으로 하십시오.

출처: Gemini API Models, Gemini 4 Argon, Gemini 3.8 Flash, Gemini 3.5 Flash-Lite, Pricing, Thinking, Gemini 3 개발 가이드, DeepMind Gemini 모델 페이지, Gemini 4 availability, Antigravity Models (2026-11-06 조회)

일상 대화와 파일: Canvas, Notebook, Deep Research

이 장에서는 Gemini app에서 가장 자주 쓰는 워크플로와 각각의 제한 사항을 다룹니다.

Canvas

Canvas는 Gemini와 함께 결과물을 편집하는 작업 공간으로, 다음을 만들 수 있습니다.

• 글쓰기와 문서
• 코드
• app과 게임
• 웹 페이지
• 인포그래픽
• 퀴즈
• 음성 요약

모든 Gemini 사용자가 쓸 수 있으며, Pro, Ultra는 1M 윈도우를 제공합니다. 프로젝트는 링크로 공유할 수 있습니다. 모바일에서도 프로젝트를 볼 수 있지만, 텍스트 서식 편집은 데스크톱 웹 버전에서만 가능합니다.

Deep Research

Deep Research는 먼저 편집 가능한 연구 계획을 만들고, 확인한 뒤에야 조사를 시작합니다.

Gemini Notebook

2026-04-08부터 Gemini 안에 “Notebooks”가 있으며 NotebookLM과 양방향으로 동기화됩니다. 어느 한쪽에 출처를 추가하면 다른 쪽에서도 보입니다. 사용자 지정 지침과 파일을 추가할 수 있습니다. 공지 당시에는 만 18세 미만과 Workspace, Education 계정을 지원하지 않았습니다. Pro 요금제에서는 Notebook 오디오 요약 등의 할당량이 5배입니다.

공식적으로 Notebook의 출처 수와 무료 할당량에 대한 수치는 공개되지 않았습니다.

Google Workspace 연결

Gemini에서 Google Workspace app을 연결하면 다음을 할 수 있습니다.

• Gmail, Docs, Drive 검색 및 요약
• Tasks, Keep, Calendar 관리

사용 방법은 @를 입력해 서비스를 선택하는 것입니다. 전제 조건은 다음과 같습니다.

• 반드시 Keep Activity를 켜야 합니다(12장 참조).
• 업무용 또는 학교 계정은 관리자의 허용이 필요합니다.
• Gmail의 스마트 기능을 켜야 합니다.

현재 할 수 없는 일: Docs, Gmail 안의 댓글과 이미지 읽기, Drive 관리(폴더 만들기, 파일 이동), 저장 공간 계산 또는 보고.

참고 사항

• 모델 선택과 사용량 한도는 3장, 4장을 참조하십시오.
• Guided Learning(단계별 안내 학습)은 2025-08에 출시되었으나 2026년 공식 개요 페이지에서는 더 이상 확인되지 않아, 이 가이드에서는 핵심 기능으로 다루지 않습니다.

출처: Canvas, Deep Research 도움말, Deep Research 개요, Google Workspace app 연결, Notebooks 공지 (2026-11-06 조회)

Skills와 Gems

Gemini는 “한 번 저장해 두고 반복해서 쓰는 지침”을 Gems에서 Skills로 바꾸고 있습니다. 지금은 전환기여서 두 가지가 공존하므로, 이 장은 Skills를 중심으로 하고 Gems는 종료 일정과 이전 방법만 설명합니다.

Skills란 무엇인가

2026-09-30에 공식 블로그에서 Skills를 발표했습니다.

• 자주 쓰는 지침을 한 번 저장해 두면, 이후 /와 이름을 입력해서 실행할 수 있습니다.
• 기존 대화에서 바로 만들 수 있습니다.
• 여러 skill을 겹쳐서 사용할 수 있습니다.
• 참조 파일을 지원합니다: 텍스트, PDF, 이미지.
• 모든 Google AI 구독 티어에서 사용할 수 있습니다.
• 현재는 만 18세 이상으로 제한됩니다.
• Gemini Spark는 이미 Skills를 지원합니다.

Skills는 곧 Gems를 대체합니다. 공식 설명에 따르면 Gems가 원래 갖고 있던 공유 기능과 Drive, Notebook 파일 지원이 나중에 추가될 예정입니다.

Gems 종료 일정

• 중단 시 Gems는 자동으로 skills로 변환됩니다.
• Opal도 11월에 종료됩니다.
• Google Labs의 Gems는 종료되며, 이전되지 않습니다.
• 조회 당일 공식 페이지는 여전히 Gems를 무료 요금제 기능에 나열하고 있으며, 즉 전환기 동안 두 가지가 공존합니다.

해야 할 일

1. 기존 Gems의 내용(지침과 참조 파일)을 직접 백업해 둡니다.
2. 대화에서 /를 시도해 보고 skill의 이름과 내용이 기대와 맞는지 확인합니다.
3. 다른 사람에게 공유해야 하는 Gem은 새 Skills에 공유 기능이 추가되었는지 먼저 확인한 뒤, 다시 만들지 결정합니다.

명령줄 개발 도구의 skills

Antigravity에도 자체 skills 메커니즘이 있으며 agentskills.io 오픈 표준을 따르고, 형식은 위의 app 버전 Skills와 다릅니다. 이 부분은 11장을 참조하십시오.

출처: Skills 공식 블로그, Gems 개요 (2026-11-06 조회)

개인화와 메모리

Gemini가 “나를 더 잘 알도록” 하는 방법은 세 가지입니다. Google 데이터 연결(Personal Intelligence), 대화 간 메모리, 그리고 다른 AI에서 가져오기입니다.

Personal Intelligence

2026-01-14에 beta로 출시되었습니다.

현행 공식 개요 페이지에는 글로벌 beta라고 적혀 있으며, 유럽 경제 지역, 스위스, 영국, 나이지리아는 제외됩니다. 페이지에 대만이 개별적으로 나열되어 있지는 않지만 대만은 제외 목록에 없습니다. 다만 페이지가 “자격 요건 충족”을 요구하므로, 실제로 켤 수 있는지는 여러분 계정의 설정을 기준으로 하십시오.

메모리와 가져오기

2026-03-26에 가져오기 기능이 출시되었습니다.

1. Settings에서 가져오기를 선택합니다.
2. Gemini가 제공하는 프롬프트를 복사해 기존 AI app에 붙여 넣습니다.
3. 기존 AI가 반환한 요약을 Gemini에 다시 붙여 넣습니다.
4. ZIP을 직접 업로드해서 채팅 기록을 가져올 수도 있습니다.

제한: 모든 소비자 계정에서 사용할 수 있으나 Business, Enterprise, 만 18세 미만은 지원하지 않으며, 유럽 경제 지역, 영국, 스위스에서는 아직 열려 있지 않습니다. 기존의 “past chats”는 “memory”로 이름이 바뀌었습니다.

Gemini Live도 식단 선호, 중요한 날짜처럼 대화 간의 세부 사항을 기억할 수 있습니다.

개인정보 보호와의 관련성

메모리, Workspace 연결, Keep Activity의 설정은 서로 연관되어 있으며, 자세한 내용은 12장을 참조하십시오. Keep Activity를 끌 계획이라면, 끈 뒤에는 Gemini가 Google Workspace에 연결할 수 없게 된다는 점을 미리 알아 두어야 합니다.

출처: Personal Intelligence 공지, Personal Intelligence 개요, 메모리 가져오기 공지, Gemini Live (2026-11-06 조회)

Tasks와 Chrome 속의 Gemini

이 장은 Gemini의 에이전트형 기능, 즉 여러분이 조작하지 않는 동안 Gemini가 대신 일을 처리하게 하는 기능을 다룹니다. 현재 변동이 가장 크고 공식 페이지마다 설명이 가장 일치하지 않는 영역이므로, 사용하기 전에 자신의 계정 화면을 기준으로 하십시오.

Tasks mode

2026-10-13 공식 공지의 내용입니다.

• 메인 채팅 창에 전환 버튼이 있어 채팅에서 Tasks로 전환할 수 있습니다.
• Gemini는 여러분이 컴퓨터 앞에 없을 때에도 Google 애플리케이션을 넘나들며 작업을 처리할 수 있습니다.
• Gemini는 “40개 이상의 app”과 연결되며, 예로 Instacart, OpenTable, Adobe, Shopify가 있습니다.
• Pro, Ultra 구독자는 “작업을 할당”할 수 있습니다.

요금제와 지역: 페이지마다 설명이 다름

대만에서 이미 사용할 수 있는지, Pro에 포함되는지는 공식적으로 일관된 설명이 없습니다.

Spark

Spark는 Google I/O 2026(2026-05-19)에서 발표된 백그라운드 agent로, 5월 말부터 미국의 Ultra, 만 18세 이상에게 공개되었습니다. 2026-09-30의 Skills 공지에는 여전히 “Gemini Spark는 이미 Skills를 지원합니다”라고 적혀 있지만, 현재 공식 페이지에서는 대부분 Tasks만 언급합니다. Spark와 Tasks의 명칭 관계는 공식적으로 명확히 밝히지 않았습니다.

Gemini in Chrome

• 탭 요약, 여러 탭 비교, Gemini Live 사용.
• 자동 탐색(auto browse): 현재는 미국 프리뷰 버전에 한정되며 Pro, Ultra 전용.
• Android는 화면 내용을 처리할 수 있고, iOS는 Chrome에 내장되어 있음.
• 대만: 공식 지역 메뉴에 대만이 있지만 페이지에서 대만에서 이미 사용 가능하다고 명확히 설명하지는 않으며, 대만 언론은 2026-04-21부터 대만에서 사용 가능하다고 보도했습니다.

연결된 app

2026-08-12 Made by Google 행사에서 새로 추가된 연결 app입니다(단계적 출시). Granola, Otter.ai, Wix, Fever, GetYourGuide, Localiza, OpenTable(영국), Ticketmaster, iHeartRadio, Pandora, Angi, Thumbtack, Zocdoc.

사용 권장 사항

• 에이전트형 기능은 여러분 대신 계정을 조작하거나 주문을 넣으므로, 처음 쓸 때는 위험이 낮은 작업(자료 조사, 일정 정리)부터 시작하십시오.
• 새 app을 연결하기 전에 그 app이 어떤 데이터에 접근할 수 있는지 먼저 확인하십시오.

출처: Gemini 4 availability(Tasks mode 포함), Gemini 구독 요금제, Gemini Apps limits & feature availability, Gemini in Chrome, 새로 연결된 app, Skills 공지, 대만 언론 보도(technews) (2026-11-06 조회)

음성, 이미지, 동영상

Gemini Live

Live 아이콘을 누르면 음성으로 Gemini와 대화할 수 있습니다.

• 언제든 끼어들거나 주제를 바꿀 수 있습니다.
• 음성과 텍스트가 같은 대화 스레드에 이어집니다.
• 지도, 날씨 카드, 사진을 표시할 수 있습니다.
• Gmail, Drive, Calendar, Tasks, Keep, Maps, YouTube, 스마트 홈과 연결할 수 있습니다.
• 카메라로 촬영해서 보여 줄 수 있습니다.
• 대화 간의 세부 사항을 기억할 수 있습니다.

제한: Live에서는 Gems, Notebook을 사용할 수 없고 Omni, Lyria도 지원하지 않습니다. 공식 페이지에는 지원 언어와 화면 공유가 나열되어 있지 않으며, 번체 중국어 지원 여부는 공식 페이지에 적혀 있지 않습니다.

이미지 생성

생성된 모든 이미지에는 보이지 않는 SynthID와 눈에 보이는 워터마크가 포함됩니다. 파일을 업로드하여 Google AI가 생성한 것인지 Gemini에게 검증해 달라고 요청할 수 있습니다. 사용하려면 만 18세 이상이어야 합니다.

동영상 생성

• app 내 동영상 생성은 Gemini Omni 1.1 Flash로 바뀌어 Veo 3.1을 대체합니다.
• 10초 동영상, 내장 음성.
• 이미지에서 동영상 생성(참조 이미지 최대 5장), 동영상 편집, 장면 연장, AI avatar를 지원합니다.
• 구독이 필요합니다.
• 해상도와 일일 한도는 공식적으로 적혀 있지 않습니다.
• 동영상에도 SynthID가 포함됩니다.

동영상은 사용량을 가장 많이 소모하는 기능이므로(3장), 구독하기 전에 자신의 사용 빈도를 먼저 가늠해 보십시오.

API 쪽

이미지와 동영상 모델의 model ID는 4장을 참조하십시오. 이 모델들의 API 가격은 이 가이드의 범위에 포함되지 않으며, 공식 pricing 페이지를 참조하십시오.

출처: Gemini Live(대만), 이미지 생성, 동영상 생성 (2026-11-06 조회)

Google AI Studio와 Gemini API

API key 발급

aistudio.google.com/apikey에서 만듭니다. SDK가 읽는 환경 변수는 GEMINI_API_KEY 또는 GOOGLE_API_KEY이며, 두 가지가 동시에 있으면 GOOGLE_API_KEY가 우선합니다.

2026-05-28부터 새로 만드는 key는 모두 auth key(service account에 바인딩)입니다. 제한이 없는 standard key는 거부되며, 명확한 제한이 있는 standard key는 계속 사용할 수 있습니다.

SDK와 첫 번째 요청

pip install -U google-genai
npm install @google/genai

주요 인터페이스는 Interactions API로 바뀌었습니다.

from google import genai

client = genai.Client()
interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words",
)
print(interaction.output_text)

• 서버 측 상태는 previous_interaction_id로 이어 붙입니다.
• REST는 Api-Revision: 2026-05-20 header를 포함해야 합니다.
• 공식적으로 gemini-api CLI도 별도로 제공합니다.
• 공식 quickstart는 Interactions API가 기존 generate-content 방식을 대체한다고 설명합니다. 기존 인터페이스가 언제 폐기되는지는 공식 페이지에 명확히 적혀 있지 않으므로, 기존 코드는 먼저 공식 문서에서 확인하십시오.

무료 티어와 유료 티어

공식 pricing 페이지에서 무료로 쓸 수 있다고 표시한 텍스트 모델은 3.8 Flash, 3.6 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite, 3 Flash Preview, 2.5 시리즈입니다. Gemini 4 Argon과 3.1 Pro Preview는 사용할 수 없습니다.

무료 티어의 구체적인 RPM, RPD는 공식 공개 페이지에 직접적인 수치가 없으며, AI Studio에 로그인해서 rate-limit 페이지에서 확인해야 합니다.

• 한도는 key가 아니라 프로젝트 단위로 계산됩니다.
• RPD는 태평양 시간 자정에 초기화됩니다.
• Search grounding은 기본적으로 프로젝트당 1,500 RPD입니다.

선결제와 과금

가격(표준 티어, 미국 달러/100만 token, 입력/출력)

Batch 가격은 표준 가격의 약 절반입니다(Argon의 경우 현재 가격 기준 Batch는 $1/$5). 오디오, 이미지, TTS, embedding 등 다른 모델의 가격은 이 가이드에 수록하지 않았으므로 공식 pricing 페이지를 참조하십시오.

Argon의 API 실무

• temperature, top_p, top_k를 제거합니다.
• max_output_tokens에는 사고가 포함됩니다. 기존 app이 32K 이하로 설정되어 있다면 최소 32,768 이상으로 높이십시오.
• 어려운 문제의 HTTP timeout은 최소 15분으로 설정합니다.
• 긴 출력에는 background: true를 사용해야 하며, 명시적 cache는 지원하지 않습니다.

그 밖의 API 도구

Search grounding, Google Maps grounding, code execution, computer use, file search, URL context, function calling, structured outputs, Batch, Flex 및 Priority inference.

긴 context 활용법

• 질문은 context 뒤에 둡니다.
• 반복해서 쓰는 내용은 cache를 사용합니다.
• 여러 대상을 동시에 검색하면 정확도가 떨어집니다.
• 1M token은 대략 코드 5만 줄, 또는 소설 8권 분량입니다.

AI Studio의 Build mode

공식 문서 페이지에 Build mode의 세부 사항이 설명되어 있지 않아, 이 가이드에는 수록하지 않습니다.

출처: API key, Quickstart, Pricing, Rate limits, Billing, Gemini 3 개발 가이드, Long context (2026-11-06 조회)

Antigravity와 Antigravity CLI

Google의 agent 개발 도구는 2026년에 Google Antigravity로 통합되었습니다. Gemini CLI는 Antigravity CLI(명령 agy)로 넘어갔고, Jules는 종료가 발표되었습니다. 이 장은 agy를 중심으로 하며, Gemini CLI와 Jules는 뒤에서 설명합니다.

Antigravity의 네 가지 surface

데스크톱 App(v2.5 이상), CLI agy(v1.2 이상), IDE 확장 프로그램(VS Code, JetBrains, Visual Studio, Zed, Xcode, Eclipse), Antigravity SDK(Python). 요금제와 할당량은 3장, 선택 가능한 모델은 4장을 참조하십시오.

agy 설치

# macOS / Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex

# Verify
agy --version

기본 설치 위치는 ~/.local/bin/agy입니다.

인증 방식은 세 가지입니다.

SSH 같은 headless 환경에서는 인증 URL과 6자리 OTP가 출력됩니다. API key를 사용할 때 공식 설정 페이지의 표기는 modelProvider: "gemini"와 GEMINI_API_KEY를 함께 쓰는 것입니다.

자주 쓰는 명령

대화 중에 사용할 수 있는 슬래시 명령에는 /model, /usage, /fast, /resume, /permissions, /mcp, /skills, /agents, /statusline, /goal, /grill-me, /schedule, /browser, /plugin이 있습니다. 실제 목록은 버전에 따라 달라지므로, /를 입력했을 때 보이는 것을 기준으로 하십시오.

Shift+Tab으로 auto, plan, default, accept-edits 모드를 전환하고, Ctrl+R로 artifact를 확인합니다.

설정 파일

위치는 ~/.gemini/antigravity-cli/settings.json(권한 0600)입니다.

• 권한 규칙은 allow, ask, deny로 나뉘며, 우선순위는 deny > ask > allow이고 형식은 command(git status)와 같습니다.
• 그 밖의 자주 쓰는 key: model, modelProvider, agentMode, toolPermission, enableTerminalSandbox, allowNonWorkspaceAccess.
• Hooks, MCP, plugins는 ~/.gemini/config/ 또는 <workspace>/.agents/에 둡니다.
• 텔레메트리 옵션은 설정 파일이 아니라 계정에 저장되며, 비즈니스 계정에서는 항상 꺼집니다.

규칙 파일: GEMINI.md와 AGENTS.md

Antigravity는 모든 계층의 디렉터리에서 AGENTS.md 또는 GEMINI.md를 찾고, .agents/AGENTS.md, .agents/GEMINI.md, .agents/rules/*.md도 읽습니다.

주의 사항:

• 규칙은 덮어쓰기가 아니라 누적됩니다.
• rules/ 안의 각 .md에는 frontmatter와 trigger가 필요하며, 사용할 수 있는 값은 always_on, model_decision, glob, manual입니다. 형식이 맞지 않으면 조용히 버려집니다.
• 파일 하나가 24,000 bytes를 넘으면 잘립니다.
• 전역 규칙과 always_on은 20,000 token 예산을 공유합니다.

MCP

전역 설정은 ~/.gemini/config/mcp_config.json, 워크스페이스 설정은 <workspace>/.agents/mcp_config.json입니다.

{
  "mcpServers": {
    "sqlite-explorer": {
      "command": "node",
      "args": ["/path/server.js"],
      "env": { "K": "V" }
    },
    "my-remote-server": {
      "serverUrl": "https://api.example.com/mcp/",
      "headers": { "Authorization": "Bearer TOKEN" },
      "timeoutSeconds": 600
    }
  }
}

• 원격은 반드시 Streamable HTTP여야 하며, url로 serverUrl을 대신할 수 있습니다.
• 이전의 HTTP+SSE와 httpUrl은 지원하지 않습니다.
• 기본 연결 및 도구 목록 조회 타임아웃은 300초이고, 도구 호출은 180초입니다.
• /mcp로 관리 패널을 엽니다.

Skills

Antigravity의 Skills는 agentskills.io 오픈 표준을 따릅니다.

• 폴더 하나에 SKILL.md 하나를 두며, frontmatter의 description은 필수이고 name은 선택입니다.
• 워크스페이스는 .agents/skills/, 전역은 ~/.gemini/config/skills/에 둡니다.
• CLI는 ~/.gemini/antigravity-cli/skills/와 ~/.gemini/skills/도 추가로 읽습니다.
• 각 skill은 CLI에서 슬래시 명령 하나가 되며, 파일을 고친 뒤에는 /skills reload로 다시 불러옵니다.

Gemini CLI의 결말

공식 developers blog(2026-05-19)에서 Gemini CLI가 Antigravity CLI로 넘어간다고 발표했습니다.

• 2026-06-18부터 Gemini CLI와 Gemini Code Assist IDE 확장은 Google AI Pro, Ultra 및 무료 Code Assist 개인 사용자에게 더 이상 서비스되지 않습니다.
• Gemini Code Assist Standard 또는 Enterprise 라이선스를 보유한 조직은 영향을 받지 않습니다.
• Gemini CLI는 유료 Gemini 또는 Enterprise Agent Platform의 API key로 계속 사용할 수 있습니다.
• 공식적으로도 둘이 1:1 기능 동등은 아니라고 인정합니다.
• 유지되는 개념: Agent Skills, Hooks, Subagents, Extensions(Antigravity plugins로 명칭 변경).

Gemini CLI의 GitHub 페이지에는 현재 “Enterprise Code Assist 전용”이라고 표시되어 있으며, Gemini 4에 최적화되어 있지 않으므로 모델 benchmark 실행에 사용하지 말라고 명시되어 있습니다. 여전히 npm install -g @google/gemini-cli 또는 brew install gemini-cli로 설치할 수 있고, gemini -p와 --output-format json을 지원하며, MCP는 ~/.gemini/settings.json에 설정합니다. 기업 사용자이거나 기존 프로젝트가 있다면 계속 써도 되지만, 새 프로젝트는 agy로 시작하는 것을 권장합니다.

Gemini CLI에서 마이그레이션

agy를 처음 실행하면 이전 설정을 감지하여 선택 목록을 제공하며, agy plugin import gemini를 직접 실행할 수도 있습니다.

Jules

공식 changelog는 2026-10-29에 Jules가 2026-12-31에 서비스를 종료한다고 공지했습니다. 2026-11-11 이전에 진행 중인 session을 마무리하십시오. 이후에는 읽기 전용이 됩니다.

• Jules Tools(CLI)로 설정, 환경 변수(값 포함), 예약된 작업, 연결된 repo, memories, setup scripts, 모든 sessions를 내보낼 수 있습니다.
• 코드와 PR은 원래 GitHub에 있습니다.
• 공지에서는 Jules의 경험이 Antigravity에 활용될 것이라고 하지만, 마이그레이션 경로는 설명하지 않았습니다.

따라서 이 가이드는 Jules를 새로 시작할 수 있는 도구로 다루지 않습니다.

출처: Antigravity 시작하기, Settings, Rules, MCP, Skills, Gemini CLI에서 마이그레이션, Gemini CLI의 Antigravity CLI 전환 공지, Gemini CLI GitHub, Jules changelog (2026-11-06 조회)

개인정보 보호와 데이터 제어

Gemini의 데이터 처리는 “어떤 제품을 쓰는지, 유료인지, 특정 설정을 켰는지”에 따라 달라집니다. 이 장은 소비자 app, API, Workspace, Antigravity의 네 부분으로 나누어 설명합니다.

Gemini app(소비자)

핵심 설정은 Keep Activity입니다.

• 기본 자동 삭제는 18개월이며, 3개월, 36개월 또는 무기한으로 바꿀 수 있습니다.
• 사람 검토: 일부 채팅은 사람 검토자(교육을 받은 서비스 제공업체 포함)가 검토하며, 검토 전에 계정과의 연결이 분리됩니다. 검토 대상이 된 채팅은 최대 3년간 보관되며, 활동을 삭제해도 지워지지 않습니다.
• Keep Activity가 꺼져 있으면 Gemini가 Google Workspace에 연결할 수 없고, Deep Research의 과거 보고서도 볼 수 없습니다.
• Personal Intelligence는 기본적으로 꺼져 있으며 app별로 개별 설정할 수 있습니다(7장).

Gemini API와 AI Studio

또한 유럽 경제 지역, 스위스, 영국의 사용자에게 API client를 제공할 때는 유료 서비스만 사용할 수 있습니다.

따라서 고객 데이터나 내부 문서를 처리할 때 무료 티어는 적합하지 않으며, 결제 계정을 연결해야 합니다.

Google Workspace

공식 페이지에는 귀사의 데이터는 전적으로 귀사의 것이며 모델 학습에 사용되지 않고, Gemini는 사용자에게 접근 권한이 있는 콘텐츠만 가져온다고 적혀 있습니다. 공식적으로 ISO 42001과 SOC 1, 2, 3도 나열합니다.

Antigravity

CLI에는 Enable Telemetry 옵션이 있으며, 켜면 사용 데이터를 수집합니다. 비즈니스 계정에서는 항상 꺼져 있습니다.

권장 설정

1. Gemini의 Activity 설정 페이지를 열어 Keep Activity의 상태와 자동 삭제 기간을 확인합니다.
2. 민감한 내용을 다룰 때는 임시 채팅을 사용합니다.
3. Workspace를 연결하거나 Deep Research 기록을 보려면, 이 두 가지가 Keep Activity에 의존한다는 점을 알아 두십시오.
4. API로 비공개 데이터를 처리할 때는 유료 티어를 사용합니다.

출처: Gemini Apps 개인정보 보호 및 Activity 도움말, Google Workspace app 연결, Deep Research 도움말, Gemini API 약관, Billing, Google Workspace AI, Antigravity Settings (2026-11-06 조회)

자주 묻는 질문, 제한 사항, 프롬프트 팁

제한 사항과 흔한 함정

공식 프롬프트 권장 사항

아래는 Gemini API의 prompting strategies와 Gemini 3 개발 가이드를 정리한 것입니다.

기본 작성법

• 작업을 직접 말합니다. 길이, 형식, 피해야 할 항목을 지정합니다.
• 복잡한 JSON 출력은 텍스트로 설명하지 말고 구조화된 출력 기능을 사용합니다.
• Few-shot: 적은 수의 다양한 예시를 주되 형식을 완전히 일치시킵니다. 예시가 너무 많으면 과적합됩니다.
• 참조 자료를 주고 “제공된 내용만 근거로 답하라”고 요구합니다.
• 최신 사실에는 Search grounding을, 계산에는 code execution을 켭니다.

구조

• XML 태그나 Markdown 제목으로 역할, 제약, 맥락, 작업을 구분하되, 한 가지 스타일만 고르면 됩니다.
• 긴 입력은 모든 맥락을 앞에 두고 질문을 마지막에 두며, 중간에 “위 정보를 바탕으로”와 같은 연결 문구를 넣습니다.
• 핵심 제약과 페르소나는 system instruction 또는 맨 앞에 둡니다.

스타일과 사고

• Gemini 3 이후에는 기본적으로 직접적이고 간결하게 답합니다. 대화체이거나 자세한 답을 원하면 명시해야 합니다.
• 2.5, 3 이후의 모델은 내부적으로 추론하므로 “단계별로 생각하라”고 요구할 필요가 없습니다. 아주 어려운 문제에만 “신중하게 생각하라”를 추가하며, 그 대가로 사고 token이 더 늘어납니다.
• Thinking 등급: 세 등급 모두 평가를 돌려 보고, 기준을 충족하는 가장 낮은 등급을 고릅니다.

Agent

• 계획 방식, 위험(읽기와 쓰기의 차이), 사용자에게 언제 물어야 하는지, 재시도 규칙을 명확히 적습니다.

예시: 공식 권장 사항을 하나의 프롬프트에 적용하기

<role>당신은 기술 문서 편집자입니다.</role>

<constraints>
- <context>의 내용만 근거로 답하고, 찾을 수 없으면 "자료에 없습니다"라고 말한다
- 출력은 5개 이내의 글머리 기호 목록이며, 각 항목은 40자를 넘지 않는다
</constraints>

<context>
(문서 내용을 붙여 넣기)
</context>

위 정보를 바탕으로 환불 절차와 관련된 규칙을 정리해 주세요.

출처: Prompting strategies, Gemini 3 개발 가이드, Gemini 구독 요금제(미국), Gemini 구독 요금제(대만), Antigravity Models (2026-11-06 조회)

ChatGPT, Claude와의 포지셔닝 차이

이 장은 공식 페이지에 근거가 있는 항목만 비교합니다. ChatGPT와 Claude의 내용은 요금제 페이지 수준까지만 확인했고, 각 사의 도움말 센터까지는 들어가지 않았으므로 가격 비교는 싣지 않으며 어느 모델이 더 강한지도 판단하지 않습니다.

요금제 구조

ChatGPT 요금제 페이지는 조회 시점에 미국 달러 가격 수치를 표시하지 않았으므로 위 표에는 싣지 않았습니다.

Gemini의 세 가지 차별점

1. Google 계정과 저장 공간에 묶인 통합 패키지입니다. 하나의 구독에 400 GB부터 20 TB 이상의 저장 공간, YouTube Premium Lite 또는 Premium, Flow credits, 그리고 Gmail, Docs에 내장된 Gemini가 포함됩니다. ChatGPT와 Claude의 개인 요금제 페이지에는 이런 묶음이 없습니다(조회한 페이지 기준).

2. 개발 도구가 Antigravity라는 하나의 진입점에 집중되어 있고 Claude 모델도 선택할 수 있습니다. Antigravity에서는 Claude Opus 5.5, Sonnet 5.5(Pro 유료 요금제 이상)를 선택할 수 있어, Gemini 모델만 있는 것이 아닙니다(4장).

3. API에 무료 티어가 있지만 데이터 처리 약관이 다릅니다. 무료 티어는 일부 Flash 시리즈로 제한되며 Argon과 3.1 Pro에는 무료 티어가 없습니다. 무료 티어의 데이터는 제품 개선에 사용되고 사람 검토가 있지만, 유료 티어는 그렇지 않습니다(12장).

데이터 정책

ChatGPT의 데이터 정책은 이번에 확인하지 않았으므로 적지 않습니다.

비교하지 않는 것

• 모델 품질: Google DeepMind 페이지의 benchmark는 Google이 직접 발표한 것이며, 다른 회사도 마찬가지입니다. 각 사가 스스로 발표한 benchmark는 서로 비교할 수 없으므로, 여러분의 작업으로 직접 테스트하시기 바랍니다.
• 어느 쪽이 더 저렴한가: 세 회사의 사용량 메커니즘이 다릅니다. Google은 연산량에 5시간 및 주간 초기화를 더한 방식이고, Claude도 5시간 및 주간 제한이 있으며, ChatGPT는 모델별 메시지 상한이 있습니다. 월 요금으로 직접 비교할 수 없습니다.

어떻게 고를까

가장 자주 머무는 환경을 고르십시오. 매일 Gmail, Docs, Drive에서 일한다면 Gemini의 통합이 가장 매끄럽고, 개발할 때 어떤 도구를 쓸지는 여러분의 프로젝트와 팀의 현재 습관에 달려 있습니다. 각 사의 요금제와 사용량 메커니즘이 모두 바뀌고 있으므로, 구독하기 전에 무료 버전이나 단기 요금제로 자신의 작업을 먼저 시험해 보십시오.

출처: Gemini 구독 요금제(미국), ChatGPT Pricing, Claude Pricing, Antigravity Models, Gemini API 약관, DeepMind Gemini 모델 페이지 (2026-11-06 조회)