요약: Vertex AI release notes에는 2026년 3월 24일 기준 이미지 생성과 비디오 생성 GA endpoint deprecation 공지가 올라와 있습니다. 특히 여러 Imagen 3/4, imagegeneration, imagetext endpoint는 gemini-2.5-flash-image로, Veo 2/3 일부 endpoint는 veo-3.1-generate-001 또는 veo-3.1-fast-generate-001로 교체가 권장됩니다. Google은 2026년 6월 30일 전 업데이트를 권장했습니다. 이미지·영상 생성 기능을 운영 중이라면 지금 코드와 설정을 점검해야 합니다.
Google Cloud Vertex AI release notes의 2026년 3월 24일 항목은 image generation GA endpoints deprecation과 video generation GA endpoints deprecation을 함께 공지했습니다. 이미지 쪽에서는 imagegeneration@002부터 imagegeneration@006, imagetext@001, imagen-3.0-*, imagen-4.0-* 계열의 여러 endpoint가 교체 대상입니다. 권장 대상은 대부분 gemini-2.5-flash-image입니다.
비디오 쪽에서는 veo-3.0-generate-001, veo-3.0-fast-generate-001, veo-2.0-generate-001 등이 대상입니다. 권장 교체는 veo-3.1-generate-001 또는 veo-3.1-fast-generate-001입니다. Google은 서비스 중단을 피하려면 2026년 6월 30일 전 업데이트하라고 안내했습니다.
이 글을 쓰는 시점이 6월 28일이라면 사실상 마지막 점검 구간입니다. 이미 마이그레이션했다면 설정 누락을 확인하고, 아직이라면 영향 범위를 빠르게 줄여야 합니다.
모델 endpoint 이름만 바꾸면 끝이라고 생각하기 쉽습니다. 하지만 이미지·영상 생성 모델은 출력 품질, latency, 비용, 입력 파라미터, safety behavior, seed 또는 aspect ratio 지원, batch 처리 방식이 달라질 수 있습니다. 특히 제품 이미지, 광고 소재, 썸네일, 쇼핑몰 상세 이미지처럼 결과물 품질이 매출과 연결되는 기능은 단순 교체 후 바로 production에 넣으면 위험합니다.
예를 들어 기존 imagen-4.0-ultra-generate-001을 쓰던 워크플로우와 gemini-2.5-flash-image는 속도와 비용 면에서 유리할 수 있지만, 특정 스타일 재현이나 텍스트 렌더링 품질이 다르게 보일 수 있습니다. 비디오도 마찬가지입니다. veo-3.1-fast-generate-001은 빠른 생성에 유리할 수 있지만, 고품질 최종 렌더와는 목적이 다를 수 있습니다.
따라서 교체 작업은 “호출 성공”과 “비즈니스 품질”을 분리해서 봐야 합니다. API가 200을 반환해도 운영 품질이 떨어지면 실패입니다.
가장 빠른 시작점은 저장소 전체 검색입니다. 다음 계열 문자열을 찾으세요. imagegeneration@, imagetext@001, imagen-3.0, imagen-4.0, veo-2.0, veo-3.0-generate-001, veo-3.0-fast-generate-001입니다. 애플리케이션 코드뿐 아니라 환경변수, Terraform, Helm chart, Cloud Run env, Secret Manager, workflow YAML, 노코드 설정 문서까지 봐야 합니다.
팀에 따라 모델 이름이 DB나 admin 화면에 저장되어 있을 수도 있습니다. 예를 들어 “사용자가 모델을 선택하는 기능”이 있다면 코드 검색으로는 전부 찾지 못합니다. 생성 작업 로그에서 실제 호출된 model endpoint를 집계하는 것도 좋습니다.
검색 결과는 세 그룹으로 나눕니다. 첫째, production active path. 둘째, staging 또는 실험 path. 셋째, dead code. production active path부터 교체하고, dead code는 삭제하거나 명시적으로 deprecated 상태를 표시합니다.
이미지 생성은 release notes 기준으로 많은 deprecated endpoint의 권장 대체가 gemini-2.5-flash-image입니다. 다만 모든 워크로드가 같은 선택을 해야 하는 것은 아닙니다. 빠른 반복, 초안 생성, 앱 내부 자동 생성에는 Flash 계열이 적합할 가능성이 큽니다. 반면 최종 마케팅 소재나 고해상도 품질이 중요한 워크로드는 별도 품질 평가가 필요합니다.
비디오는 veo-3.1-generate-001과 veo-3.1-fast-generate-001를 구분해야 합니다. 사용자에게 즉시 미리보기를 제공하는 기능은 fast endpoint를 검토할 수 있습니다. 최종 다운로드나 유료 크레딧 차감 작업은 일반 generate endpoint를 기본으로 두는 것이 안전합니다. 단, 실제 비용과 latency는 조직의 리전, quota, 요청 옵션에 따라 달라질 수 있으므로 내부 로그로 확인해야 합니다.
마이그레이션 PR에는 단순히 “모델명 변경”이라고 쓰지 말고 선택 이유를 적으세요. 예: “썸네일 초안 생성은 latency 우선이라 gemini-2.5-flash-image로 전환”, “최종 영상 생성은 품질 우선이라 veo-3.1-generate-001로 전환”처럼 남기면 나중에 품질 이슈가 생겼을 때 판단 근거가 됩니다.
모델 교체 테스트에서 가장 흔한 실수는 샘플 프롬프트 한두 개로만 확인하는 것입니다. 실제 사용자는 훨씬 지저분한 입력을 넣습니다. 제품명, 한국어와 영어 혼합, 숫자, 브랜드 컬러, 금지어 근처 표현, 사람 얼굴, 음식, UI 스크린샷, 긴 설명, 짧은 명령이 모두 섞입니다.
테스트 세트는 최근 30일 production prompt에서 개인정보와 민감정보를 제거해 30~50개 정도 뽑는 것이 좋습니다. 이미지라면 생성 성공률, 평균 latency, 비용, safety block 비율, 사람이 본 품질 점수, 텍스트 렌더링 품질을 봅니다. 비디오라면 생성 성공률, 처리 시간, 모션 안정성, 프레임 깨짐, prompt adherence, 재시도율을 봅니다.
가능하다면 기존 endpoint와 새 endpoint를 같은 프롬프트로 비교하세요. 종료 전 시간이 부족해도 최소 10개 대표 프롬프트는 비교해야 합니다. 품질이 바뀌는 경우 prompt template을 같이 조정해야 할 수 있습니다.
6월 30일 전 마감이 촉박하다면 feature flag를 두고 전환하세요. 모델명을 코드에 하드코딩하지 말고 설정값으로 뺍니다. 먼저 내부 사용자 또는 5% 트래픽에 새 endpoint를 적용하고, 실패율과 latency를 봅니다. 문제가 없으면 점진적으로 늘립니다.
fallback도 현실적으로 준비해야 합니다. deprecated endpoint로 돌아가는 fallback은 장기적으로 의미가 없으므로, 같은 신규 계열 안에서 fast/quality fallback을 설계하는 편이 낫습니다. 예를 들어 비디오 preview 생성은 fast endpoint 실패 시 일반 endpoint로 재시도하거나, 반대로 일반 endpoint가 quota에 걸리면 사용자에게 지연 안내를 제공하는 식입니다.
사용자에게 보이는 기능이라면 에러 메시지도 바꾸세요. “모델 호출 실패” 대신 “이미지 생성 모델 업데이트 중 일시적으로 실패했습니다. 잠시 후 다시 시도해 주세요”처럼 실제 상황에 맞는 메시지가 필요합니다. 유료 크레딧을 차감한다면 실패 시 환불 또는 미차감 로직을 반드시 확인해야 합니다.
imagegeneration@, imagetext@001, imagen-3.0, imagen-4.0, veo-2.0, veo-3.0 문자열을 검색합니다.gemini-2.5-flash-image 대체 가능성을 검토합니다.veo-3.1-generate-001과 veo-3.1-fast-generate-001 중 목적에 맞게 고릅니다.이번 변경은 날짜가 가까워서 빠른 조치가 필요합니다. 하지만 빠르다고 무작정 문자열만 바꾸면 품질 사고가 날 수 있습니다. 최소한 검색, 매핑, 대표 프롬프트 테스트, 점진 배포 네 단계는 지키는 것이 안전합니다.