Gemini 프리뷰 TTS 종료 대비: 12월 18일 전에 확인할 마이그레이션 체크리스트
Gemini 프리뷰 TTS 3종의 종료 가능일과 3.8 대체 모델을 확인하고, API 호출 방식과 WAV·PCM 스트리밍 출력까지 전환 전에 점검한다.
새 음성 생성 경로로 전환하는 과정을 표현한 AI 생성 개념 이미지. 실제 제품 화면이 아니다.
Gemini 프리뷰 TTS를 자동 음성 생성에 쓰고 있다면 2026년 12월 18일 이전에 대체 모델로 전환을 마칠 계획을 잡는 편이 안전하다. 모델 ID만 바꾸고 끝내지 않는다. 기존 호출 방식이 새 모델을 지원하는지, 새 응답을 기존 재생기나 인코더가 처리하는지 각각 확인해야 한다.
어떤 모델을 먼저 바꿔야 하나
Google의 Gemini 종료 일정은 아래 세 모델의 종료 가능일을 2026년 12월 18일로 표시한다.
gemini-3.1-flash-tts-preview
gemini-2.5-flash-preview-tts
gemini-2.5-pro-preview-tts
권장 대체 ID는 gemini-3.8-flash-tts 또는 **gemini-3.8-flash-lite-tts**다. 공식 표의 날짜는 가장 이른 종료 가능일이다. 확정 시각이나 그날까지의 동작 보장으로 읽지 말고, 최신 표를 다시 확인하되 전환은 그 전에 끝낸다.
1. 모델 ID가 실제로 쓰이는 위치를 찾는다
코드뿐 아니라 환경변수, 배포 템플릿, 배치 작업과 실패 시 사용하는 대체 설정을 확인한다. 예를 들어 프로젝트 루트에서 다음 명령으로 버전 관리 중인 파일에서 기존 모델 ID가 들어간 파일명만 찾을 수 있다.
검색 결과가 없어도 저장소 밖 설정이나 추적하지 않는 로컬 파일에는 값이 남을 수 있다. 인벤토리에는 실제 배포 설정을 별도로 포함한다.
2. 모델 선택, 호출 방식, 오디오 형식을 분리해 검증한다
현재 공식 음성 생성 가이드는 두 대체 모델을 안내하고 Python 예제에서 client.interactions.create를 사용한다. 기존에 generate_content 등 다른 메서드를 썼다면 현재 SDK와 해당 API가 새 ID를 지원하는지 먼저 확인한다. 가이드의 호출 방식으로 옮길 경우에는 입력 구조, 화자·스타일 설정, 응답에서 오디오를 꺼내는 위치도 함께 맞춘다.
Interactions API 가이드에 따르면 출력 형식을 지정하지 않은 단건 요청은 WAV, 스트리밍 요청은 기본적으로 헤더 없는 PCM 청크를 반환한다. 문서의 기본 오디오 사양은 24 kHz·모노·16비트다. 같은 음성을 돌려받더라도 WAV 헤더를 기대하는 파일 저장 코드와 PCM 바이트를 기대하는 재생 코드는 바꿔 끼울 수 없다. 요청에서 형식을 별도로 지정한 경우에는 실제 응답과 디코더 설정을 다시 대조한다.
3. 대표 샘플을 통과한 뒤 전환한다
아래는 공식 호환성 보장이 아닌 전환 확인용 체크리스트다.
- 짧은 문장, 긴 내레이션, 숫자·영문이 섞인 한국어 대본을 고른다. 기존과 새 결과의 발음, 속도, 무음이나 잘림을 비교한다.
- 저장형과 스트리밍을 따로 확인한다. 저장형은 파일 재생과 길이, 스트리밍은 첫 재생 시점과 청크 연결, 종료 처리를 본다.
- 타임아웃과 실패 응답이 음성 파일로 잘못 저장되지 않는지 확인한다. 작업 큐와 자동 재시도의 동작도 본다.
- 검증이 끝난 설정부터 전환하고, 종료되는 프리뷰 ID가 예비 경로에 남지 않게 한다. 모델 간 지연과 비용이 같다고 가정하지 말고 자기 요청 패턴 기준으로 비교한다.
실시간 대화용 Live는 일정이 다르다
같은 종료 일정에서 gemini-2.5-flash-native-audio-preview-12-2025의 가장 이른 종료 가능일은 2027년 3월 31일, 권장 대체 ID는 gemini-3.8-live다. 이 일정은 위 TTS 3종과 별개다. 양방향 대화 세션은 TTS 파일이나 오디오 청크 생성 테스트로 대체하지 않는다.
공식 종료표와 음성 생성 가이드를 November 20, 2026 기준 대조했다. 실제 음성 합성, 성능 측정, 유료 API 호출은 하지 않았다.