HowtoAI
ai-tools2026-08-21 5 min read

제미나이 모델 지원 종료 확인 — 폐지 문서 65행 중 종료일 지난 38개, 그중 3개는 목록에 남아 있었어요

🤖
HowtoAI 편집팀AI 전문 에디터

AI 기술을 누구나 쉽게 활용할 수 있도록 실전 가이드를 작성합니다. ChatGPT, Claude, AI 자동화, SEO 분야를 전문으로 다룹니다.

📅 2026-08-21⏱️ 5 min read🌐 how-toai.com
목차 보기

쓰던 제미나이 모델이 어느 날 갑자기 404를 뱉으면 당황스럽죠. 코드를 안 건드렸는데 어제까지 되던 게 안 되니까요. 그래서 "이 모델 아직 살아 있나"를 확인할 방법이 필요해요.

결론부터 적을게요. 구글 공식 폐지 문서의 종료일 칸 하나만 보면 답이 안 나와요. 문서 자체가 그 날짜를 "은퇴할 수 있는 가장 이른 날"이라고 못박아 뒀거든요. 실제로 표의 모델 행 65개를 세어 보니 종료일이 이미 지난 것이 38개였는데, 그중 3개는 조회 시각에도 모델 목록에 그대로 남아 있었어요.

그리고 반대 방향으로 어긋나는 자리도 있었어요. gemini-2.0-flash는 목록에서 빠졌고 생성 호출은 404인데, 개별 메타데이터 조회만 200을 돌려줬어요. 아래에서 세는 방법부터 하나씩 보여 드릴게요.

먼저 잰 범위부터 밝힐게요. 이 글의 숫자는 전부 Gemini Developer API의 v1beta를 기준으로, 2026년 8월 21일 낮 12시 20분에서 12시 22분 사이(한국 시각) 에 공식 문서 HTML과 API 응답을 직접 받아 센 값이에요. 404 문구가 갈리는 자리와 가격 문서 경고문은 같은 날 오후 1시 51분에 한 번 더 쳐서 확인했고, 그때 나온 값은 시각을 따로 밝혔어요. Vertex AI 쪽 모델 수명은 이번에 확인하지 않았어요.

크림색 정사각 타일이 여러 줄로 가지런히 놓여 격자를 이루고 있고 격자 바깥 아래쪽 흰 바닥에는 짙은 색 작은 사각 조각들이 흩어져 있는 모습을 정면에서 찍은 사진

제미나이 모델 지원 종료, 어디서 확인하나요

바로 답부터 드릴게요. 출발점은 구글의 공식 폐지 문서 한 쪽이에요. 주소는 ai.google.dev/gemini-api/docs/deprecations이고, 모델별로 출시일과 종료일과 권장 대체 모델이 표로 정리돼 있어요.

다만 그 표의 종료일 칸 하나로 판정하면 어긋나요. 문서가 표 바로 위에 이렇게 적어 뒀거든요.

Note: The shutdown dates listed in the table indicate the earliest possible dates on which a model might be retired.

표에 적힌 날짜는 그 모델이 은퇴할 수 있는 가장 이른 날이라는 뜻이에요. 그러니까 날짜가 지났다는 사실만으로는 꺼졌는지 알 수 없어요.

그럼 문서는 꺼진 모델을 어떻게 표시할까요. 그 Note 바로 앞 문단의 마지막 문장에 답이 있어요.

Already-shutdown models are indicated with gray backgrounds.

이미 종료된 모델은 회색 배경으로 표시한다는 거예요. 즉 날짜 칸과 회색 표시는 서로 다른 신호예요. 여기에 실제 API 응답까지 더하면 확인해야 할 곳이 셋이 돼요. 이 글은 그 셋을 전부 세어 대조한 기록이에요.

어떤 조건에서 쟀는지 먼저 못박을게요

숫자보다 조건이 먼저예요. 조회 시점이 바뀌면 값도 바뀌는 종류의 측정이거든요.

항목
문서ai.google.dev/gemini-api/docs/deprecations · 가격 문서 · 한도 문서
문서 받는 법curl로 HTML 원본을 받아 table, tr, td 태그를 직접 파싱
APIgenerativelanguage.googleapis.com 의 v1beta
호출 3종모델 목록 조회 · 개별 모델 메타데이터 조회 · 생성 호출
인증개인 API 키 1개 (프로젝트 사용 티어는 확인하지 못함)
조회 일시2026년 8월 21일 12시 20분에서 12시 22분 사이 (한국 시각)
재확인 일시같은 날 오후 1시 51분 (404 문구 유형·가격 문서 경고문)
기준일종료일이 지났는지는 2026년 8월 21일과 비교

한 가지 더 밝혀 둘게요. 문서 HTML을 받을 때 텍스트만 벗겨 내면 표가 뭉개져서 행을 셀 수 없어요. 여러 표의 칸이 한 줄로 붙어 버리거든요. 그래서 태그 구조를 남긴 채로 표 단위로 잘라 세었어요.

종료 예고 문서를 표째로 세어 봤어요 — 모델 행 65개

먼저 문서의 크기를 재야 나머지 숫자가 의미를 가져요. 세는 방법까지 적을게요.

세려는 것세는 방법결과
표 개수HTML의 table 태그 수11개
모델 데이터 행각 표의 tr 중 헤더행과 구분행을 뺀 나머지65행
종료일 미공지종료일 칸이 "종료일 미공지"인 행23행
앞으로 종료 예정종료일이 기준일 이후인 행4행
종료일이 이미 지남종료일이 기준일 이전인 행38행

검산하면 23 더하기 4 더하기 38이 65예요. 날짜 파싱에 실패한 행은 없었어요.

표 11개는 모델 종류별로 나뉘어 있어요. Gemini 3 계열 13행, Gemini 2.5 Pro 4행, Gemini 2.5 Flash 7행, Gemini 2.0 7행, Live API 4행, 오디오 3행, 임베딩 8행, Imagen 6행, Veo 8행, Lyria 3행, 로보틱스 2행이에요. 합이 65행이고요.

여기서 가장 흔한 오해 하나를 먼저 걷어 낼게요. 버전 번호가 낮다고 은퇴한 게 아니에요. gemini-2.5-progemini-2.5-flashgemini-2.5-flash-lite는 셋 다 종료일 칸이 "종료일 미공지"였고 조회 시각 모델 목록에도 그대로 있었어요. 반대로 세대가 더 높은 gemini-3-pro-preview는 종료일이 지났고 회색으로 칠해져 있고 목록에도 없었어요.

문서가 회색으로 칠한 행은 31개, 날짜가 지난 행은 38개예요

여기가 이 글에서 가장 중요한 자리예요. 문서 안에서 이미 두 신호가 갈려요.

회색 표시는 눈으로 세면 놓치니까 HTML 속성으로 셌어요. 표의 행 태그에 회색 표시용 클래스가 붙어 있고, 그 클래스가 붙은 행은 31개였어요. 그런데 종료일이 지난 행은 38개고요. 일곱 개 차이가 나요.

두 집합을 겹쳐 보면 이렇게 갈려요.

상태개수
회색이면서 종료일도 지남30개문서와 날짜가 같은 말을 하는 자리
회색인데 종료일 칸은 미공지1개날짜만 보면 못 잡는 자리
종료일은 지났는데 회색이 아님8개날짜만 보면 과잉 판정하는 자리

회색인데 종료일이 없는 1개는 gemini-2.5-pro-preview-tts예요. 날짜 칸만 훑었다면 "아직 예고도 없네"로 지나쳤을 행이죠. 다만 이 행도 조회 시각 모델 목록에는 그대로 있었고, 오후 1시 51분에 넣어 본 개별 조회도 200이었어요. 회색이 곧 목록에서 빠졌다는 뜻은 아니에요. 뒤에서 말씀드릴 "회색인데 목록에 남은 2개"가 이 모델과 gemini-3.1-flash-lite-preview예요.

반대쪽 8개는 더 흥미로워요. 종료일이 지났는데 회색이 안 붙은 행들인데, 그중 6개는 이미 API 목록에서 사라져 있었어요. Imagen 4 계열 세 개와 Veo 옛 세대 세 개예요. 나머지 2개는 이미지 생성 프리뷰 두 개인데 목록에 그대로 있었고요.

회색 표시와 실제 API 상태도 완전히 같지는 않아요. 어느 쪽이 먼저 움직이는지는 자리마다 달랐어요. 다만 여기서 "구글이 갱신을 빠뜨렸다"로 넘어가지는 않을게요. 제가 확인한 건 두 신호가 다르다는 사실까지예요. 이런 상태 변화를 운영 중에 어떻게 감지하느냐는 문제는 제미나이 API에서 자주 만나는 오류를 정리한 글에 따로 적어 뒀어요.

종료일이 지난 38개 중 35개는 목록에서 빠졌어요

이제 문서와 API를 맞춰 볼 차례예요. 모델 목록을 받아 이름을 뽑고, 폐지 문서 행 이름과 완전일치로 대조했어요.

모델 목록 조회는 HTTP 200이었고 배열 길이는 50개였어요. 처음엔 딱 50이라 페이지 상한을 의심했는데, 페이지 크기를 지정하지 않았을 때와 200으로 줬을 때와 1000으로 줬을 때 모두 50개였고 다음 페이지 토큰 필드도 응답에 없었어요. 그래서 50개가 전부라고 판단했어요.

대조 결과예요.

  • 종료일이 지난 38개 중 35개는 목록에서 빠졌어요.
  • 3개는 그대로 남아 있었어요.
  • 회색행 31개 기준으로 보면 29개가 빠졌고 2개가 남았어요.
  • 종료일 미공지 23개 중에서는 22개가 목록에 있었고 1개만 없었어요. 없는 하나는 lyria-realtime-exp인데, 개별 조회에서도 404였어요.

남아 있던 3개를 전부 적을게요.

모델문서의 종료일문서 회색 표시문서가 적은 대체
gemini-3.1-flash-lite-preview2026년 5월 25일회색gemini-3.1-flash-lite
gemini-3.1-flash-image-preview2026년 6월 25일회색 아님gemini-3.1-flash-image
gemini-3-pro-image-preview2026년 6월 25일회색 아님gemini-3-pro-image

세 개 다 개별 메타데이터 조회는 200이었어요. 이름과 토큰 한도가 전부 정상으로 돌아왔고요.

목록에 남은 3개 중 하나는 조회 시각에도 200을 돌려줬어요

문서가 회색까지 칠해 둔 모델이 목록에 남아 있다면, 실제로 부르면 어떻게 될까요. 궁금해서 직접 쳐 봤어요.

대상은 gemini-3.1-flash-lite-preview예요. 종료 예고일이 2026년 5월 25일이니까 조회일 기준으로 석 달 가까이 지난 모델이에요. 2026년 8월 21일 12시 21분(한국 시각) 에 생성 요청을 한 번 보냈어요. 입력은 "1+1" 한 줄이고 출력 한도는 8토큰으로 잡았어요.

결과는 HTTP 200이었어요. 응답 본문에 텍스트가 담겨 왔고 토큰 사용량도 정상으로 기록됐어요. 프롬프트 토큰 3개, 후보 토큰 4개, 합계 7개였어요.

여기서 오해하기 쉬운 자리가 하나 있어요. 응답의 종료 사유가 "출력 한도 도달"로 왔는데, 이건 제가 출력 한도를 8토큰으로 걸었기 때문이에요. 모델이 실패한 게 아니라 8토큰에서 끊긴 거예요.

또 하나 눈에 띈 게 있어요. 응답이 스스로 적은 모델 버전 필드값이 gemini-3.1-flash-lite였어요. 제가 부른 이름은 뒤에 프리뷰가 붙은 쪽인데, 응답에 적힌 이름은 폐지 문서가 대체로 지목한 정식 모델 이름이었던 거예요. 같은 날 오전 11시 51분에 돌린 첫 호출에서도 같은 값이 왔고요. 별칭 처리인지 다른 사정인지는 문서에서 확인하지 못해서, 응답에 그렇게 적혀 있었다는 사실까지만 적을게요.

그리고 이 결과를 "예고일이 지나도 계속 쓸 수 있다"로 넓히면 어긋나요. 목록에 남아 있던 3개 중 생성 호출까지 해 본 건 이 하나뿐이고, 나머지 2개는 이미지 생성 모델이라 목록에 있다는 것과 조회가 200이라는 것까지만 확인했어요. 게다가 이건 특정 시각 한 점의 관측이에요.

둥근 홈이 여러 줄로 파인 원형 원목 쟁반이 크림색 천 위에 놓여 있고 홈이 모두 비어 있는 모습을 비스듬히 내려다본 사진

2.0 플래시는 메타데이터 조회와 생성 호출의 답이 갈렸어요

이번엔 반대 방향이에요. 문서가 끝났다고 적었고 목록에서도 빠졌는데, 창구에 따라 답이 다른 경우예요.

gemini-2.0-flash는 폐지 문서에서 종료일이 2026년 6월 1일이고 회색으로 칠해져 있어요. 대체 모델은 gemini-3.6-flash로 적혀 있고요. 조회 시각 모델 목록에도 이 이름은 없었어요.

그런데 창구 셋의 답이 이렇게 갈렸어요.

창구결과
모델 목록 조회이름 없음
개별 메타데이터 조회HTTP 200, 메타데이터 전부 반환
생성 호출HTTP 404

개별 조회가 돌려준 값이 꽤 구체적이에요. 표시 이름, 입력 토큰 한도 1,048,576, 출력 토큰 한도 8,192, 지원 메서드 네 가지, 기본 온도 값까지 전부 있었어요. 이것만 보면 멀쩡히 살아 있는 모델처럼 보여요.

생성 호출을 넣으면 그때 404가 나요. 메시지는 이 모델을 더 이상 쓸 수 없으니 gemini-3.6-flash로 코드를 바꾸라는 취지였어요. gemini-2.0-flash-lite도 같은 패턴이었고, 그쪽 안내는 gemini-3.5-flash-lite를 가리켰어요.

여기서 얻을 실무 교훈은 하나예요. 배포 전 점검 스크립트에서 "모델 조회가 되니까 살아 있다"로 판정하면 안 돼요. 조회는 통과하고 실제 호출에서 터지니까요. 참고로 라이트 계열 모델을 실제로 써 보는 이야기는 3.1 플래시 라이트를 다룬 글에 정리해 뒀어요. 다만 그 글이 다루는 gemini-3.1-flash-lite는 이 안내가 가리킨 gemini-3.5-flash-lite와 다른 모델이고, 폐지 문서에는 2027년 5월 7일 종료가 예고돼 있어요.

404 메시지가 두 종류예요 — 은퇴형과 부재형

404를 받았을 때 그게 은퇴 때문인지 이름을 잘못 쓴 것인지 구분이 안 되면 곤란하죠. 그래서 존재한 적 없는 이름을 일부러 한 번 쳐서 대조군을 만들었어요.

두 문구가 확실히 달랐어요.

유형메시지 형태확인된 대상
은퇴형이 모델은 더 이상 사용할 수 없으니 코드를 이 모델로 바꾸라는 안내, 대체 모델 이름 포함gemini-2.0-flash, gemini-2.0-flash-lite, gemini-3-pro-preview
부재형해당 API 버전에서 찾을 수 없거나 그 창구를 지원하지 않는다는 안내, 대체 모델 없음존재한 적 없는 대조군 이름, imagen-4.0-generate-001, lyria-realtime-exp, veo-3.0-generate-001, text-embedding-004, gemini-1.5-pro

부재형에 옛 모델 이름들이 섞여 있는 게 눈에 띄어요. 다만 종료된 지 오래돼서 부재형이 되는 건 아니었어요. 종료일이 나흘 전에 지난 imagen-4.0-generate-001은 부재형이었고, 다섯 달 넘게 지난 gemini-3-pro-preview는 오후 1시 51분 생성 호출에서 은퇴형이었거든요. 무엇이 두 문구를 가르는지는 이 관측으로 알 수 없어서, 문구가 두 종류라는 사실까지만 적을게요.

한 가지 더 좁혀 둘게요. 부재형을 "이름이 틀렸다"로만 읽으면 어긋나요. 살아 있는 모델도 지원하지 않는 창구로 부르면 같은 문구가 와요. 같은 날 오후 1시 51분에 확인해 보니 gemini-embedding-001은 모델 목록에 있고 개별 조회도 200인데, 생성 호출에는 부재형 404가 왔어요. 폐지 문서에서 이 모델의 종료일은 2028년 5월 14일, 그러니까 아직 오지 않은 날짜고요.

창구도 함께 밝혀 둘게요. 위 표의 은퇴형 사례는 전부 생성 호출에서, 부재형 사례는 전부 개별 조회에서 받은 문구예요. 두 유형을 같은 창구에서 나란히 받아 본 건 아니라는 뜻이에요.

그래서 404 메시지 본문을 읽는 습관이 중요해요. 대체 모델 이름이 붙어 있으면 은퇴형이라 그대로 갈아타면 되고, 없으면 이름이 틀렸는지 아니면 그 창구를 지원하지 않는 모델인지를 함께 확인해야 해요.

앞으로 종료가 예고된 모델은 4개예요

과거만 보면 준비가 안 되니 앞도 볼게요. 조회일 기준으로 종료일이 아직 오지 않은 행은 4개였어요. 전부 조회 시각 모델 목록에 있었고요.

모델문서의 종료일조회일에서 센 남은 기간문서가 적은 대체
gemini-robotics-er-1.6-preview2026년 8월 31일10일gemini-robotics-er-2-preview
gemini-2.5-flash-image2026년 10월 2일42일gemini-3.1-flash-image-preview
gemini-3.1-flash-lite2027년 5월 7일해를 넘김gemini-3.5-flash-lite
gemini-embedding-0012028년 5월 14일해를 넘김gemini-embedding-2

두 가지를 덧붙일게요. 첫째, 남은 기간은 문서가 적은 값이 아니에요. 제가 조회일에서 뺀 값이라 읽는 시점이 다르면 달라져요. 둘째, 앞에서 인용한 대로 이 날짜는 가장 이른 날이라 그날 정확히 꺼진다는 뜻은 아니에요.

대체 모델로 적힌 자리가 이미 지난 곳이 4곳이에요

표를 세다가 재미있는 자리를 발견했어요. 어떤 행의 "권장 대체" 칸에 적힌 모델이, 같은 문서 안에서 이미 종료일이 지난 모델인 경우예요.

세는 방법은 이래요. 대체가 적힌 행이 46개인데, 각 행의 대체 이름을 같은 문서에서 다시 찾아 그 행의 종료일이 기준일 이전인지 봤어요. 그렇게 걸린 자리가 4곳이었어요.

이 행이 행의 종료일적힌 대체대체의 종료일
gemini-2.5-flash-image2026년 10월 2일gemini-3.1-flash-image-preview2026년 6월 25일
imagen-3.0-generate-0022025년 11월 10일imagen-4.0-generate-0012026년 8월 17일
imagen-4.0-generate-preview-06-062026년 2월 17일imagen-4.0-generate-0012026년 8월 17일
imagen-4.0-ultra-generate-preview-06-062026년 2월 17일imagen-4.0-ultra-generate-0012026년 8월 17일

첫 줄이 특히 눈에 띄어요. 아직 종료되지 않은 모델의 대체로 지목된 쪽이, 같은 문서에서는 예고일이 먼저 지난 모델이거든요. 다만 그 대체 모델은 조회 시각에 목록에 남아 있었고 개별 조회도 200이었어요. 그러니 이건 "문서가 틀렸다"가 아니라 "대체로 지목된 쪽의 예고일이 먼저 지났다"는 상태 서술이에요.

반면 아래 세 줄은 사정이 달라요. 여기 적힌 이름은 imagen-4.0-generate-001imagen-4.0-ultra-generate-001 둘인데, 둘 다 조회 시각에 404였어요. 그러니까 이 행을 보고 대체 모델로 갈아탄 사람은 다시 404를 만나게 돼요.

가격·한도 문서에는 이미 끝난 모델이 아직 남아 있어요

폐지 문서만 보면 되는 게 아니라는 걸 여기서 확인했어요. 가격 문서와 한도 문서도 함께 받아 봤거든요.

가격 문서부터요. 이 문서에 붙은 경고 상자는 평문 전수 검색으로 세어 보니 모두 다섯 개였어요. 그중 둘이 2.0 계열 자리예요. 가격표가 그대로 있고 각각 위에 경고문이 붙어 있는데, 두 경고문 다 과거형이에요. 이미 2026년 6월 1일에 종료됐으니 새 모델로 옮기라는 내용이고요. 그러니까 가격표가 남아 있어도 오해할 여지는 적어요.

문제는 나머지 셋이에요. 이 경고문들은 아직 미래형이거든요. Imagen 4 세 모델은 2026년 8월 17일에, Veo 3 두 모델과 Veo 2 한 모델은 2026년 6월 30일에 종료될 예정이니 옮기라고 적혀 있어요. 그런데 조회일인 8월 21일 기준으로 앞 날짜는 나흘 전에, 뒤 날짜는 쉰이틀 전에 이미 지났고, 오후 1시 51분에 여섯 모델을 하나씩 조회해 보니 전부 404였어요. 문장만 읽으면 아직 시간이 남은 것처럼 보이는데 실제로는 이미 끝난 상태인 거예요.

여기서 하나 더 갈리는 자리가 있어요. 폐지 문서와 가격 문서가 지목하는 대체 모델이 서로 달라요. 폐지 문서의 Imagen 4 세 행은 대체를 gemini-3.1-flash-image로 적는데, 가격 문서의 경고문은 Gemini 2.5 Flash Image로 옮기라고 적어요. 그리고 그 gemini-2.5-flash-image는 폐지 문서에서 2026년 10월 2일 종료가 예고된 모델이고요.

한도 문서는 또 달라요. 표가 다섯 개인데 앞 두 개는 티어별 지출 한도와 자격 조건이고, 뒤 세 개가 티어별 배치 큐 토큰 표예요. 그 세 표 전부에 2.0 계열 세 행이 그대로 남아 있어요.

모델 행Tier 1Tier 2Tier 3
Gemini 2.0 Flash10,000,0001,000,000,0005,000,000,000
Gemini 2.0 Flash Image3,000,000400,000,0001,000,000,000
Gemini 2.0 Flash Lite10,000,0001,000,000,0005,000,000,000

이쪽 표에는 종료 경고문이 붙어 있지 않아요. 가격 문서에는 붙어 있던 경고가 여기엔 없다는 뜻이에요. 그래서 한도 문서만 보고 모델을 고르면 이미 꺼진 이름을 고르게 돼요.

아이보리색 벽 앞 옅은 나무 선반 위에 흰 도자기 그릇이 나란히 놓여 있고 가운데 그릇에만 옅은 색 콩이 담겨 있으며 양옆 그릇은 비어 있는 모습을 정면에서 찍은 사진

내 코드가 위험한지 5분 자가진단

읽기만 하면 안 바뀌니 순서를 정해 둘게요. 위에서 갈린 자리를 그대로 뒤집은 순서예요.

  1. 코드에 박힌 모델 이름을 전부 뽑으세요. 설정 파일과 환경변수까지요. 이름이 하드코딩된 자리가 몇 곳인지부터 세는 게 먼저예요.
  2. 폐지 문서에서 그 이름을 찾으세요. 다만 없다고 안심하면 안 돼요. 오래전에 사라진 이름은 이 문서에서 아예 빠져 있어요. gemini-1.5-pro가 그런 경우인데, 폐지 문서 65행 어디에도 없고 문서 전문에 그 이름이 한 번도 나오지 않는데 조회는 404였어요. 이름이 있으면 종료일 칸과 회색 표시를 함께 보세요. 날짜 칸만 보면 위에서 본 여덟 개 자리에서 판정이 어긋나요.
  3. 모델 목록 API로 이름이 살아 있는지 대조하세요. 응답의 이름들과 완전일치로 비교하면 돼요. 목록에 없으면 그 자체로 경보예요.
  4. 목록에 있어도 생성 호출을 한 번 넣어 보세요. 개별 조회만으로는 부족해요. 2.0 계열처럼 조회는 200이고 호출은 404인 자리가 실제로 있었으니까요.
  5. 404가 나면 메시지 본문을 읽으세요. 대체 모델 이름이 붙어 있으면 은퇴형이라 그대로 갈아타면 되고, 없으면 이름이 틀렸는지 아니면 그 창구를 지원하지 않는 모델인지를 함께 확인해야 해요.
  6. 대체 모델을 그대로 믿지 말고 그 모델 행도 다시 보세요. 대체로 적힌 쪽이 이미 예고일을 넘긴 자리가 네 곳 있었어요.
  7. 가격·한도 문서를 모델 선택의 근거로 쓰지 마세요. 이미 종료된 모델의 행이 남아 있고, 한도 문서 배치 표에는 경고문도 없었어요.

특히 4번과 5번을 같이 하시면 오탐이 확 줄어요. 배포 파이프라인에 짧은 호출 한 번을 넣어 두는 것만으로도 "조회는 되는데 호출은 안 되는" 함정을 걸러 낼 수 있거든요.

확인하지 못한 것과 조심할 점

경계를 분명히 해 둘게요. 이 글이 못 한 것들이에요.

첫째, Vertex AI 쪽이에요. 이 글의 호출은 전부 Gemini Developer API의 v1beta예요. Veo 행의 대체 문구에 다른 플랫폼 이름이 나오지만 그쪽은 열어 보지 않았어요.

둘째, 키의 사용 티어예요. 개인 API 키 하나로 호출했는데 그 키가 속한 프로젝트의 티어를 확인하지 못했어요. 응답 유무가 티어에 따라 달라질 가능성을 배제하지 못하니 "무료 키로도 된다"로 읽으시면 어긋나요.

셋째, 이미지 생성 모델 두 개예요. 목록에 남아 있던 3개 중 두 개는 이미지 생성 모델이라 목록 잔존과 메타데이터 조회 200까지만 확인했어요. 생성 호출은 하지 않았어요.

넷째, 시점이에요. 전부 2026년 8월 21일 12시 20분에서 12시 22분 사이 한 점의 관측이에요. 예고일이 지난 3개가 언제 실제로 꺼지는지는 이 글이 알 수 없어요.

다섯째, 회색 표시가 갱신되는 주기예요. 폐지 문서의 표기상 최종 갱신일은 조회일보다 며칠 앞이었고, 회색이 안 붙은 채 API에서만 사라진 여섯 개가 왜 그런지는 문서가 설명하지 않아요. "구글이 갱신을 빠뜨렸다"로 단정하지 않을게요. 제가 확인한 건 두 신호가 다르다는 사실까지예요.

여섯째, 응답의 모델 버전 필드가 정식 이름으로 오는 이유예요. 두 번 다 같은 값이었지만 그게 별칭 처리인지 다른 사정인지는 문서에서 확인하지 못했어요.

일곱째, 메타데이터 조회만 살아 있는 이유예요. 왜 목록에서는 빼고 개별 조회는 남겨 뒀는지 문서에서 확인하지 못했어요. 관측한 사실만 적었어요.

여덟째, 두 404 문구를 가르는 기준이에요. 종료 뒤 흐른 시간으로는 갈리지 않았어요. 나흘 전에 종료일이 지난 모델이 부재형이고, 다섯 달 넘게 지난 모델이 은퇴형이었거든요. 무엇이 기준인지는 문서에서 확인하지 못했어요.

이건 조심하세요

폐지 문서의 종료일 칸만 보고 "이 모델은 끝났다" 또는 "아직 괜찮다"로 결론 내지 마세요. 문서 스스로 그 날짜를 은퇴할 수 있는 가장 이른 날이라고 적어 뒀고, 실제로 날짜가 지난 38개 중 3개는 조회 시각에 모델 목록에 남아 있었어요. 반대로 날짜가 지났는데 회색 표시가 없는 여덟 자리 중 여섯은 이미 API에서 사라져 있었고요. 판정은 날짜가 아니라 실제 호출로 하세요.

정리

  • 폐지 문서는 표 11개, 모델 데이터 행 65개였어요. 종료일 미공지가 23개, 앞으로 종료 예정이 4개, 이미 종료일이 지난 것이 38개였어요.
  • 문서는 종료일을 은퇴할 수 있는 가장 이른 날이라고 적고, 이미 꺼진 모델은 회색 배경으로 표시한다고 밝혀 뒀어요. 그래서 날짜 칸만 보면 안 돼요.
  • 회색행은 31개고 날짜가 지난 행은 38개예요. 회색인데 종료일이 없는 자리 1곳, 종료일은 지났는데 회색이 아닌 자리 8곳이 문서 안에서 갈렸어요.
  • 종료일이 지난 38개 중 35개는 모델 목록에서 빠졌고 3개는 남아 있었어요. 그중 gemini-3.1-flash-lite-preview는 2026년 8월 21일 12시 21분(한국 시각) 생성 호출에 HTTP 200으로 답했어요.
  • gemini-2.0-flash는 창구마다 답이 갈렸어요. 목록에는 없고, 개별 조회는 200이고, 생성 호출은 404였어요.
  • 404 메시지는 두 종류였어요. 대체 모델 이름이 붙는 은퇴형과 그냥 못 찾겠다는 부재형이에요. 다만 부재형은 이름이 틀렸을 때만 오는 게 아니라, 살아 있는 모델을 지원하지 않는 창구로 불러도 왔어요.
  • 대체 모델로 적힌 자리가 같은 문서에서 이미 예고일을 넘긴 곳이 4곳이었어요.
  • 가격 문서의 경고 상자 다섯 개 중 2.0 계열 둘은 과거형인데, Imagen 4·Veo 3·Veo 2 셋은 아직 미래형이고 그 날짜는 조회일 기준 각각 나흘 전과 쉰이틀 전에 지났어요. 한도 문서의 배치 표에는 2.0 계열 행이 경고 없이 남아 있었고요.

지금 화면에서 할 수 있는 가장 짧은 확인은 이거예요. 쓰시는 코드에서 모델 이름을 하나 꺼내 모델 목록 API로 대조해 보고, 이름이 있어도 짧은 생성 호출을 한 번 넣어 보세요. 두 단계가 갈리는 순간이 바로 이 글이 잡아낸 자리예요. 같은 API를 분량 지시 쪽으로 재 본 기록은 글자 수 지시를 실측한 글에 따로 있어요.

확인한 자료: 구글 Gemini API 공식 문서 「Gemini deprecations」(페이지 표기 최종 갱신 2026-08-13 UTC), 「Pricing」, 「Rate limits」. 전부 2026년 8월 21일 낮 12시 20분에서 12시 22분 사이(한국 시각)에 HTML 원본으로 직접 받아 표를 파싱했어요. 실측값은 같은 시각 generativelanguage.googleapis.com 의 v1beta 에 모델 목록 조회, 개별 메타데이터 조회, 생성 호출을 직접 넣어 받은 응답이에요. 같은 날 오후 1시 51분에 폐지 문서와 가격 문서를 한 번 더 받아 표를 다시 세었고(행 65개, 회색 31개로 값이 같았어요) API도 다시 쳤어요. 그때만 나온 값은 본문에 시각을 적어 뒀어요.

❓ 자주 묻는 질문 (FAQ)

제미나이 모델이 지원 종료됐는지 어디서 확인하나요?

구글 공식 폐지 문서(ai.google.dev/gemini-api/docs/deprecations)가 출발점이에요. 다만 그 문서의 종료일 칸 하나만 보면 안 돼요. 문서가 스스로 '표에 적힌 종료일은 모델이 은퇴할 수 있는 가장 이른 날'이라고 적어 뒀고, 이미 꺼진 모델은 날짜가 아니라 회색 배경으로 표시한다고 밝혀 뒀거든요. 그래서 저는 세 곳을 함께 봤어요. 문서의 회색 표시, 모델 목록 API 응답, 그리고 실제 생성 호출이에요. 이 세 신호가 서로 다른 자리가 실제로 있었어요.

종료일이 지나면 그날부터 못 쓰나요?

제가 잰 범위에서는 그렇지 않았어요. 폐지 문서의 모델 행 65개 중 종료일이 이미 지난 것이 38개였는데, 2026년 8월 21일 낮 12시 20분 한국 시각에 모델 목록을 받아 대조해 보니 그중 35개만 목록에서 빠져 있었어요. 남은 3개는 목록에 그대로 있었고요. 그중 gemini-3.1-flash-lite-preview에는 같은 날 12시 21분에 생성 요청을 넣어 봤는데 HTTP 200으로 답이 왔어요. 다만 이건 그 시각 한 점의 관측이라 내일도 같다는 뜻은 아니에요.

gemini-2.0-flash를 부르면 404가 나는데 왜 문서 조회는 되나요?

창구마다 답이 달라서예요. 2026년 8월 21일 12시 20분대 한국 시각 기준으로 모델 목록에는 이 이름이 없었고, 생성 호출은 404였어요. 그런데 개별 메타데이터 조회는 HTTP 200으로 입력 토큰 한도, 출력 토큰 한도, 지원 메서드 목록까지 전부 돌려줬어요. 그러니까 조회가 된다고 해서 호출이 된다는 뜻이 아니에요. 왜 메타데이터만 남겨 뒀는지는 문서에서 확인하지 못했고, 저는 관측한 사실만 적어요.

404 메시지만 보면 은퇴한 건지 이름을 잘못 쓴 건지 알 수 있나요?

문구가 갈려요. 은퇴한 모델은 '이 모델은 더 이상 사용할 수 없다, 코드를 이걸로 바꿔라'는 취지로 대체 모델 이름까지 붙여 줘요. 반대쪽 문구는 '해당 API 버전에서 찾을 수 없거나 그 창구를 지원하지 않는다'는 형태예요. 그래서 이 문구는 이름이 틀렸을 때뿐 아니라 살아 있는 모델을 지원하지 않는 창구로 불렀을 때도 와요. 실제로 같은 날 오후 1시 51분에 확인해 보니 gemini-embedding-001은 모델 목록에 있고 개별 조회도 200인데 생성 호출에는 이 문구가 왔어요. 404를 봤다면 메시지 본문을 먼저 읽고, 대체 모델 이름이 없으면 이름이 틀렸는지 창구가 맞는지를 함께 확인해 보세요.

버전 번호가 낮으면 곧 끝나는 건가요?

아니었어요. gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite는 셋 다 폐지 문서의 종료일 칸이 '종료일 미공지'였고 조회 시각 모델 목록에도 있었어요. 반대로 세대가 더 높은 gemini-3-pro-preview는 종료일이 이미 지났고 회색으로 칠해져 있고 목록에도 없었어요. 이름의 숫자가 아니라 그 모델 행의 종료일 칸과 회색 표시를 보셔야 해요.

앞으로 종료가 예고된 모델은 몇 개인가요?

2026년 8월 21일 조회 기준으로 4개였어요. gemini-robotics-er-1.6-preview가 8월 31일, gemini-2.5-flash-image가 10월 2일, gemini-3.1-flash-lite가 2027년 5월 7일, gemini-embedding-001이 2028년 5월 14일이에요. 다만 문서가 이 날짜를 '가장 이른 날'로 못박아 뒀으니 그날 정확히 꺼진다는 뜻은 아니에요. 남은 기간은 문서가 적은 값이 아니라 제가 조회일에서 뺀 값이고요.

가격 문서에 아직 있는 모델은 쓸 수 있다는 뜻인가요?

그렇게 읽으면 어긋나요. 가격 문서에는 이미 종료된 모델의 가격표가 남아 있는 자리가 있어요. 경고 상자는 모두 다섯 개인데, 2.0 계열 두 곳은 '이미 종료됐다'는 과거형이라 오해할 여지가 적어요. 문제는 아직 미래형으로 남은 나머지 세 자리예요. Imagen 4 세 모델과 Veo 3 두 모델, Veo 2 한 모델이 각각 특정 날짜에 종료될 예정이라고 적혀 있는데, 조회한 날 기준으로 두 날짜 다 이미 지났고 여섯 모델 전부 개별 조회는 404였어요. 한도 문서의 배치 표에는 2.0 계열 행이 경고 없이 그대로 남아 있고요.

📚 함께 읽으면 좋은 글 (Related Posts)

AI 도구 추천 더 보기 →
구글 AI 개요 끄는 법 — 공식 도움말은 '사용 중지할 수 없다'고 적어요, 대신 되는 세 가지
ai-tools2026-08-10

구글 AI 개요 끄는 법 — 공식 도움말은 '사용 중지할 수 없다'고 적어요, 대신 되는 세 가지

구글 AI 개요를 끄는 스위치를 찾다가 못 찾으셨다면 이유가 있어요. 구글 공식 도움말이 'AI 개요는 지식 패널과 같이 Google 검색의 핵심 기능'이고 '기능을 사용 중지할 수는 없'다고 직접 적거든요. 대신 되는 건 웹 필터와 Labs 스위치, 그리고 기록 삭제 세 가지인데 각각 하는 일이 달라요. 구글 한국어 도움말 원문을 그대로 열어 갈라 정리했어요.

터미널 AI 코딩 CLI 3종 비교 2026 — 클로드 코드·코덱스·제미나이 CLI, 무료로 어디까지 되나
ai-tools2026-08-06

터미널 AI 코딩 CLI 3종 비교 2026 — 클로드 코드·코덱스·제미나이 CLI, 무료로 어디까지 되나

터미널에서 쓰는 AI 코딩 CLI 세 가지의 무료 진입 경로와 한도를 각 도구의 공식 요금·문서 페이지에서 직접 확인해 정리했어요. 클로드 코드는 무료 플랜 접근이 없다고 문서가 못 박고, 코덱스 CLI는 무료 플랜에 포함되지만 그 한도 숫자가 요금 표에 없으며, 제미나이 CLI의 개인 구글 로그인은 2026년 6월 18일에 닫혔어요. 설치 요건과 데이터 정책까지 함께 봤어요.