Gemini 3 Pro Image — Google의 프리미엄 이미지 모델을 API 호출 한 번으로
Gemini 3 Pro Image는 Google의 프로급 이미지 작업용 모델입니다. 1K~4K 출력, 내장 사고 기능, 참조 이미지 최대 14장을 지원합니다. 이미 익숙한 generateContent 본문을 그대로 보내세요. 장당 $0.03부터.
- 텍스트로 이미지 생성
- 이미지 편집
- 1K~4K
- 내장 사고 기능
- 참조 이미지 최대 14장
- generateContent 본문
코드를 쓰기 전에 Gemini 3 Pro Image를 먼저 사용해 보세요
코드가 보낼 JSON 그대로 Gemini 3 Pro Image를 실행합니다. 엔드포인트가 받는 모든 generateContent 필드가 여기에 있습니다.
gemini-3-pro-image-official$90.00 / 1M image output tokens
만들 이미지를 설명하고, 참조 이미지가 있으면 추가한 뒤 한 번 제출하세요. 태스크가 완료되면 결과가 표시됩니다.
만들거나 바꿀 내용입니다. 피사체, 배경, 조명, 스타일을 적으세요.
모델이 따라야 할 참조 이미지입니다. 파일은 업로드된 뒤 URL로 전송됩니다.
최대 14개, fileData URL로 전송됩니다.
기본값은 첫 번째 참조 이미지를 따르며, 없으면 1:1입니다.
출력 해상도입니다. 기본값은 1K입니다.
이미지만, 또는 짧은 텍스트 답변이 포함된 이미지.
하우스 스타일처럼 모델이 늘 따라야 할 규칙입니다.
이 카테고리의 차단 기준입니다.
회색 옵션은 콘텐츠 필터링을 완화하므로 Playground에서는 선택할 수 없고 API로만 사용할 수 있습니다.
이 카테고리의 차단 기준입니다.
회색 옵션은 콘텐츠 필터링을 완화하므로 Playground에서는 선택할 수 없고 API로만 사용할 수 있습니다.
이 카테고리의 차단 기준입니다.
회색 옵션은 콘텐츠 필터링을 완화하므로 Playground에서는 선택할 수 없고 API로만 사용할 수 있습니다.
이 카테고리의 차단 기준입니다.
회색 옵션은 콘텐츠 필터링을 완화하므로 Playground에서는 선택할 수 없고 API로만 사용할 수 있습니다.
0–2. 모델 기본값을 쓰려면 비워 두세요.
0–1. 모델 기본값을 쓰려면 비워 두세요.
1 이상의 정수입니다.
정수입니다. 같은 값을 다시 쓰면 결과를 더 가깝게 재현할 수 있습니다.
텍스트와 사고 출력의 상한입니다.
한 줄에 하나씩, 최대 5개.
1만 가능합니다. 요청 하나에 이미지 한 장이 반환됩니다.
참조 파일 하나가 사용하는 토큰 수입니다. 낮을수록 저렴합니다.
이미지와 함께 모델의 사고 요약을 반환합니다.
문서화된 값은 IMAGE_JPEG 하나입니다.
위의 화면비가 '기본값'일 때만 적용됩니다. 둘 다 설정하면 화면비가 우선합니다.
위의 이미지 크기가 '기본값'일 때만 적용됩니다. 둘 다 설정하면 이미지 크기가 우선합니다.
선택한 크기의 이미지 토큰에 텍스트·사고 토큰 실측 샘플을 더해 현재 요율로 계산한 예상치입니다. Official에서는 참조 입력에 따라 비용이 조금 늘어납니다.
이 프롬프트들을 사용해 보세요
이 API로 Gemini 3 Pro Image에서 생성한 샘플 이미지
Gemini 3 Pro Image 가격
Gemini 3 Pro Image의 결제 방식은 두 가지입니다. Standard는 크기와 관계없이 장당 고정 요금입니다. Official은 렌더링마다 보고되는 토큰으로 과금하며, 1K와 2K는 같은 가격이고 4K는 더 비쌉니다.
- Official
- $0.10304/장
- Standard
- $0.03/장
- Official
- 194장
- Standard
- 666장
두 가격 모두 계정에 실제로 과금되는 요율에서 가져옵니다. 실패한 요청은 과금되지 않습니다.
Official 예상치는 Google이 크기별로 공개한 이미지 토큰에, 텍스트·사고 토큰 246개와 프롬프트 토큰 14개의 실측 샘플을 더해 계산합니다.
이미지 크기별 Gemini 3 Pro Image 비용
Google은 Gemini 3 Pro Image의 크기별 이미지 토큰을 공개합니다. 1K와 2K는 1,120개, 4K는 2,000개입니다. 아래 Official 가격에는 사고 토큰 실측 샘플이 더해져 있습니다.
| 이미지 크기 | 이미지 토큰 | 가격 · Official | 가격 · Standard |
|---|---|---|---|
| 1K | 1,120 | $0.10304 | $0.03 |
| 2K | 1,120 | $0.10304 | $0.03 |
| 4K | 2,000 | $0.18224 | $0.03 |
Standard는 모든 크기에서 장당 고정 요금입니다. Official은 이미지 토큰을 따르므로 크기가 클수록 비쌉니다.
내 Gemini 3 Pro Image 요청 가격 계산하기
크기를 고르면 금액이 바로 바뀝니다. 실시간 요율과 Google이 크기별로 공개한 이미지 토큰으로 계산하므로, 가격이 바뀌면 이 수치도 함께 바뀝니다.
제출 전 예상치입니다. Standard는 전달된 이미지마다 과금하고, Official은 이미지 출력, 텍스트·사고 출력, 입력을 각각의 요율로 과금합니다.
| 항목 | 측정 방식 | 요율 | 과금 |
|---|---|---|---|
| Official · 이미지 출력 | 렌더링에서 보고된 이미지 토큰 | $90.00 / 1M$120.00 / 1M | 실제 사용량으로 과금 |
| Official · 텍스트·사고 출력 | 렌더링에서 보고된 텍스트·사고 토큰 | $9.00 / 1M$12.00 / 1M | 실제 사용량으로 과금 |
| Official · 입력 | 프롬프트와 참조 파일의 토큰 | $1.50 / 1M$2.00 / 1M | 실제 사용량으로 과금 |
| Standard · 이미지 1장당 | 전달된 이미지 한 장마다, 크기 무관 | $0.03 /장$0.04 /장 | 이미지가 전달될 때 과금 |
| 실패한 요청 | 실패로 끝난 모든 태스크 | 무료 | 과금되지 않음 |
Gemini 3 Pro Image란?
Gemini 3 Pro Image는 Google의 이미지 생성·편집 모델로, Nano Banana Pro라는 이름으로 제공됩니다. Google은 이 모델을 가장 복잡한 시각 작업을 위한 프리미엄 선택지라고 부르며, 프로급 에셋 제작을 위해 설계했습니다.
SeedRouter에서는 Google의 generateContent 요청 본문에 model 필드만 더해 Gemini 3 Pro Image를 호출합니다. 한 번 제출하고 태스크 ID를 보관한 뒤, 태스크가 완료되면 호스팅된 이미지 URL을 읽어 오세요.
모델 ID: gemini-3-pro-image · 토큰 과금 ID: gemini-3-pro-image-official · 입력 한도: 65,536 토큰.
Gemini 3 Pro Image를 쓰는 두 가지 방법
백엔드에서 API를 호출하거나, 코딩 에이전트에 작업을 맡기세요.
API 호출하기
서버에서 Gemini 3 Pro Image 요청을 보내고 태스크 ID를 보관한 뒤, 태스크에서 완성된 이미지를 읽어 오세요.
- 1API 키 생성
- 2요청 본문을 POST합니다
- 3완료될 때까지 태스크를 폴링합니다
에이전트에게 맡기기
준비된 프롬프트를 Claude Code, Codex 또는 Cursor에 복사하세요. 비용을 쓰기 전에 확인을 요청하고 결과를 다운로드합니다.
- 1프롬프트를 복사합니다
- 2원하는 내용을 채웁니다
- 3요청을 승인합니다
개발자가 Gemini 3 Pro Image를 고르는 이유
복잡한 지시를 정확히 반영한 렌더링이 필요할 때 쓰는 Gemini 모델입니다.
Google의 요청 본문 그대로
Gemini 3 Pro Image는 Google에 보내던 contents와 generationConfig를 그대로 받습니다. model 필드만 추가하면 끝입니다.
그리기 전에 사고
Gemini 3 Pro Image는 레이아웃을 먼저 추론합니다. 이유가 궁금하다면 includeThoughts로 사고 요약을 요청하세요.
읽기 쉬운 텍스트
Google은 인포그래픽, 메뉴, 다이어그램용의 읽기 쉽고 스타일이 살아 있는 텍스트를 Gemini 3 이미지 모델의 강점으로 꼽습니다.
4K 출력
Gemini 3 Pro Image는 1K, 2K, 4K로 렌더링합니다. 토큰 과금에서는 2K가 1K와 같은 가격입니다.
참조 이미지 14장
Gemini 3 Pro Image 요청 하나에 참조 이미지를 최대 14장까지 fileData URL로 조합하세요.
태스크 기반
오래 걸리는 Gemini 3 Pro Image 렌더링도 연결을 붙잡아 두지 않습니다. 태스크를 폴링해 URL을 받으면 됩니다.
팀들이 Gemini 3 Pro Image로 만드는 것
인포그래픽과 다이어그램
Gemini 3 Pro Image는 메모를 라벨이 달린 설명 이미지로 바꿉니다.
브랜드 일관성 있는 세트
Google은 정확한 브랜드 일관성을 Gemini 3 Pro Image의 강점으로 꼽으며, 이는 캠페인 세트에 유용합니다.
인쇄용 아트워크
Gemini 3 Pro Image로 만드는 4K 포스터와 패키지.
현지화 에셋
Google은 고급 현지화 기능을 강조합니다. Gemini 3 Pro Image 디자인 하나에 여러 언어의 텍스트를 담을 수 있습니다.
제품 연출 장면
참조 사진 속 제품을 Gemini 3 Pro Image의 새로운 장면에 배치하세요.
정밀한 편집
Gemini 3 Pro Image로 이미지의 요소 하나만 바꾸고 나머지는 유지하세요.
4단계로 Gemini 3 Pro Image 시작하기
- 01
키 생성
로그인해 원하는 금액을 충전하고 API 키를 만드세요. 크레딧은 만료되지 않습니다.
- 02
요청 한 번 보내기
프롬프트와 참조 URL을 담은 Gemini 3 Pro Image 본문을 /v1/images/generations로 POST합니다.
- 03
태스크 폴링
태스크 ID를 보관하고 상태가 completed가 될 때까지 몇 초마다 확인합니다.
- 04
이미지 다운로드
태스크 출력의 호스팅된 이미지 URL을 자체 스토리지에 저장합니다.
Gemini 3 Pro Image 한눈에 보기
Gemini 3 Pro Image가 작업에 맞는지 판단하는 핵심 사실.
| 항목 | Gemini 3 Pro Image |
|---|---|
| 모델 ID | gemini-3-pro-image |
| 출력 크기 | 1K, 2K, 4K |
| 화면비 | 10가지(9:16~21:9) |
| 참조 파일 | 최대 14장 |
| 사고 | 항상 켜짐, 사고 요약은 선택 |
| 과금 | 장당(Standard) 또는 토큰당(Official) |
512px 초안, 극단적인 화면비, 동영상 입력이 필요하신가요? Gemini 3.1 Flash Image를 보세요.
Gemini 3 Pro Image 코드를 옮기기 전에
preview ID도 계속 동작합니다
Google은 2026년 6월 25일에 gemini-3-pro-image-preview를 종료했습니다. 여기서는 gemini-3-pro-image가 처리하므로 계속 실행됩니다.
inlineData가 아닌 URL
Gemini 3 Pro Image 참조 파일은 fileData URL로 보내세요. Base64 inlineData는 과금 전에 거부됩니다.
검색 그라운딩은 아직 미지원
tools가 포함된 Gemini 3 Pro Image 요청은 현재 거부됩니다.
요청당 이미지 1장
candidateCount는 1입니다. 여러 장이 필요하면 Gemini 3 Pro Image 요청을 여러 번 보내세요.
SeedRouter에서 Gemini 3 Pro Image를 쓰는 이유
두 가지 결제 방식
Gemini 3 Pro Image 이미지 장당 고정 요금인 Standard, 또는 렌더링마다 보고된 토큰만큼 내는 Official 중에서 고르세요. 같은 키, 같은 요청 본문입니다.
실패한 요청은 무료
태스크가 실패로 끝나면 과금되지 않습니다. 전달된 이미지에 대해서만 비용을 냅니다.
크레딧은 만료되지 않습니다
한 번 충전하고 필요할 때 잔액을 쓰세요. 구독은 없습니다.
호스팅된 결과
완성된 이미지는 당사 CDN의 URL로 반환됩니다. 오래 보관할 파일은 사본을 저장해 두세요.
모든 모델에 키 하나
같은 키와 잔액으로 카탈로그의 다른 이미지 모델도 사용할 수 있습니다.
SeedRouter의 다른 이미지 모델
같은 키, 같은 잔액, 같은 태스크 API.
SeedRouter에서 GPT Image 2로 이미지를 생성하고 편집하세요. 텍스트 프롬프트, 참조 이미지, 투명 배경을 지원하며, Playground에서 바로 시험해 볼 수 있고 사용한 만큼만 과금됩니다.
가격 보기SeedRouter에서 GPT Image 2.5 Flare 또는 Sunburst로 이미지를 생성하고 편집하세요. max까지 6단계 품질, 투명 배경, 바로 시험해 볼 수 있는 Playground, 사용한 만큼만 내는 요금제를 지원합니다.
가격 보기Google의 generateContent 본문 그대로 Gemini 3.1 Flash Image(gemini-3.1-flash-image)를 사용하세요. 512px~4K, 14가지 화면비, 참조 이미지 14장. 장당 요금.
가격 보기Google에서 가장 빠르고 저렴한 이미지 모델 Gemini 3.1 Flash Lite Image(gemini-3.1-flash-lite-image)를 generateContent 본문 그대로 사용하세요. 1K 출력.
가격 보기Gemini 3 Pro Image 가이드
모델 선택, 가격, 연동에 관한 실용 가이드.
Nano Banana는 무료인가요? Gemini 앱과 Gemini API에서 Nano Banana 2와 Nano Banana Pro를 무료로 쓸 수 있는 범위와 비용이 발생하는 시점을 정리합니다.
Nano Banana 2 API를 단계별로 사용하는 방법: API 키 발급, generateContent 요청 전송, 작업 폴링, 참조 이미지 추가, 코딩 에이전트로 실행하기까지 정리합니다.
Nano Banana 2, Nano Banana Pro, Nano Banana 2 Lite를 이미지 크기, 가로세로 비율, 참조 이미지, 사고 기능, 과금 방식으로 비교하고 작업별 선택 기준을 정리합니다.
Nano Banana 2, Pro, 2 Lite의 현재 Nano Banana API 가격을 정리합니다. 장당 고정 요금과 토큰 과금, 해상도별 비용, 과금 방식별로 맞는 작업을 설명합니다.
Gemini 3 Pro Image 자주 묻는 질문
Gemini 3 Pro Image와 Nano Banana Pro는 같은 모델인가요?+
네. Nano Banana Pro는 Google이 Gemini 3 Pro Image에 붙인 제품명이며, 모델 ID는 gemini-3-pro-image입니다. Nano Banana Pro 페이지는 같은 모델을 제품 관점에서 다룹니다.
gemini-3-pro-image-preview는 아직 쓸 수 있나요?+
Google은 2026년 6월 25일에 preview ID를 종료했습니다. SeedRouter에서는 gemini-3-pro-image-preview를 계속 받아 gemini-3-pro-image로 실행하므로, ID를 바꾸는 동안에도 기존 코드가 그대로 동작합니다.
Gemini 3 Pro Image 가격은 얼마인가요?+
이미지 한 장은 크기와 관계없이 Standard 기준 $0.03입니다. Official에서는 렌더링마다 보고된 토큰만큼 내며, 일반적인 1K나 2K 렌더링은 약 $0.10304입니다. 가격 섹션에서 모든 크기의 실시간 요금을 확인할 수 있습니다.
Gemini 3 Pro Image는 무료인가요?+
Google 가격 페이지에는 Gemini API의 Gemini 3 Pro Image 무료 등급이 없습니다. SeedRouter는 한 번 충전하면 크레딧이 만료되지 않으며, 실패한 요청은 과금되지 않습니다.
Gemini 요청을 바꿔야 하나요?+
contents, systemInstruction, safetySettings, generationConfig는 그대로 두세요. model 필드를 추가해 /v1/images/generations로 보내고, 태스크에서 Gemini 3 Pro Image 결과를 읽으면 됩니다.
Gemini 3 Pro Image API 키는 어떻게 발급받나요?+
로그인해 원하는 금액을 충전하고 API 키 페이지에서 키를 만드세요. 같은 키로 Gemini 3 Pro Image와 여기 있는 다른 모든 모델을 쓸 수 있습니다.
Gemini 3 Pro Image에서 사고 기능을 끌 수 있나요?+
아니요. Gemini 3 Pro Image는 항상 그리기 전에 사고합니다. includeThoughts로 사고 요약을 요청할 수 있으며, 사고 토큰은 Official에서만 과금됩니다.
Gemini 3 Pro Image와 Gemini 3.1 Flash Image, 어느 쪽인가요?+
복잡한 지시와 프로급 에셋에는 Gemini 3 Pro Image를 쓰세요. Gemini 3.1 Flash Image는 더 빠르고, 512px 출력과 극단적인 화면비를 추가로 지원하며, 동영상과 PDF 참조 파일도 읽습니다.
첫 Gemini 3 Pro Image 요청을 보내 보세요
Playground에서 Gemini 3 Pro Image를 시험해 보고, 같은 JSON을 그대로 코드에 붙여 넣으세요.