Google Gemini 모델 API 사용 가이드
Google I/O 2026 기조연설이 하루 앞으로 다가왔지만, 구글은 더 이상 비밀을 지키지 못했습니다. 지난 5월 5일, 개발자들이 iOS Gemini 앱과 Google AI Studio에서 Gemini 3.2 Flash를 찾아냈고, 웹 버전의 새로운 "Liquid Glass(액체 유리)" 인터페이스까지 미리 공개되었습니다. 해외 테스터들이 확인한 가장 놀라운 사례로는 단일 프롬프트로 2,200줄의 실행 가능한 코드를 생성하거나, 프롬프트 하나로 상호작용이 가능한 Windows 98…
Stable Diffusion이나 Midjourney에서 Nano Banana Pro로 넘어온 개발자라면 API를 처음 호출할 때 다음과 같은 당혹스러운 400 에러를 마주한 적이 있을 겁니다: Invalid JSON payload received. Unknown name "negativePrompt" at 'generation_config.image_config': Cannot find field. 에러 메시지는 직설적이지만, 정작 필드 이름이 틀린 건지, 위치가 잘못된 건지, 아니면 이 모델이 아예 부정 프롬프트(negative prompt)를 지원하지 않는 건지 명확히…
2026년 5월 4일, 구글은 공식 블로그를 통해 "Gemini API에서 이벤트 기반 웹훅(Event-driven webhooks)을 사용할 수 있게 되었다"고 발표했습니다. 이틀 뒤인 5월 6일 오전 10시(베이징 시간), 전 세계 개발자들의 수신함에 Google AI Studio로부터 메일이 도착하며 Gemini API 웹훅이 모든 사용자에게 정식으로 오픈되었음을 알렸습니다. Deep Research, 긴 영상 생성, 혹은 대규모 배치(Batch) 추론을 다루는 많은 팀에게 이번…
작성자 주: gemini-3-pro-image-preview를 호출할 때 Base64 decoding failed 400 오류가 발생하시나요? 본 글에서는 원본 오류 메시지를 바탕으로 6가지 주요 원인을 분석하고, Python, JavaScript, curl 세 가지 언어의 올바른 예제 코드와 5단계 문제 해결 가이드를 제공합니다. gemini-3-pro-image-preview 인터페이스 호출 시 다음과 같은 400 오류를 마주하셨나요? { "status_code": 400, "error": { "message": "Invalid value at 'contents[0].parts[0].inline_data.data' (TYPE_BYTES),…
Nano Banana 2 API 이미지 생성 실패 시 비용이 청구될까요? 이는 최근 Google Gemini 3.1 Flash Image(Nano Banana 2)를 연동하는 많은 개발자가 가장 먼저 겪는 '지갑 관련 고민'입니다. 특히 finishReason: IMAGE_SAFETY, blockReason: OTHER와 같은 응답을 받거나, "제공하신 이미지가 신분증으로 보여 수정할 수 없습니다"와 같은 콘텐츠 안전 정책에 따른 거절 메시지가 뜰 때, 많은 분이 **"이미지는…
Gemini 3 Pro Image 인터페이스를 호출해 이미지를 생성할 때, 응답으로 받은 첫 번째 이미지를 그대로 사용자에게 보여주면 문제가 생길 수 있습니다. 구도가 이상하거나, 디테일이 뭉개지거나, 심지어 화면 일부가 잘린 결과물이 나오는 경우죠. 이는 모델의 성능이 떨어진 것이 아니라, 잘못된 이미지를 선택했기 때문일 가능성이 큽니다. 응답에 포함된 첫 번째 이미지는 모델의 '사고 초안'일 확률이 높으며, 진짜…
작성자 주: 2026년 4월 Google Gemini API 무료 티어의 주요 변경 사항을 상세히 설명해 드립니다. Pro 모델의 유료 전환, 강제 월간 지출 한도 도입, 그리고 여전히 무료로 사용 가능한 Flash 모델에 대한 내용과 함께 3가지 실용적인 대응 전략을 정리했습니다. 2026년 4월 1일부터 Google은 Gemini API 무료 티어의 정책을 대폭 강화했습니다. 가장 핵심적인 변화는 Pro 시리즈…
기업 고객들이 Gemini나 Nano Banana Pro와 같은 구글 모델의 연동 방안을 문의할 때, **"Provisioned Throughput (PT)"**는 자주 언급되면서도 가장 흔하게 오해받는 용어 중 하나입니다. 흔한 오해로는 "PT가 AI Studio의 기업용 버전인가요?", "PT는 Gemini API의 우선순위를 구매하는 것인가요?", "PT를 구매하면 단가가 할인되나요?" 등이 있습니다. 이 질문들에 대한 답은 직관적이지 않을 수 있습니다. 본 글에서는 Google Cloud…
최근 Google Nano Banana Pro( gemini-3-pro-image-preview 모델)를 사용하면서 많은 개발자가 다음과 같은 오류를 겪고 있습니다. { "status_code": 503, "error": { "message": "Deadline expired before operation could complete. (request id: 2026…)", "type": "", "code": 503 } } 언뜻 보면 "요청 시간 초과"처럼 보이지만, HTTP 503 상태 코드의 본질적인 의미는 클라이언트 측의 시간 초과가 아니라 **Service Unavailable(서비스…
작성자 주: Gemini 3.1 Pro API의 429 Quota Exceeded 오류 원인과 이를 해결할 5가지 실전 방법을 상세히 설명합니다. 여기에는 여러 AI Studio 계정의 API 키를 순환 사용하는 방법, API 중계 서비스를 통한 고성능 무제한 호출, 지수 백오프(Exponential Backoff) 재시도 전략 등이 포함되어 있습니다. Gemini 3.1 Pro API를 사용하다 보면 429 속도 제한 오류를 자주 마주하게…
