제미나이 API, 요청 저장 기본값 켜짐: 바뀐 점과 끄는 법

제미나이 API 요청 저장 기본값(store)은 2026년 10월 26일부터 유료 티어에서 새로 만든 프로젝트는 generateContent 요청을 기본으로 저장(store=true)하고, 기존 프로젝트는 현재 설정을 그대로 유지한다. 구글 제미나이 API 변경 기록에 올라온 내용이다.

제미나이 API 요청 저장, 무엇이 바뀌었나

택배 상자를 보낼 때 송장 사본이 자동으로 남는 서비스를 새로 계약했다고 생각해 보자. 사본이 있으면 나중에 문제를 추적하기 쉽지만, 상자에 개인 연락처가 들어 있었다면 사본이 남는다는 사실을 미리 알아야 한다. 제미나이 API도 이제 새 유료 프로젝트에서는 요청을 로그에 사본으로 남기는 방식이 기본이다. 다만 이 변경은 새 프로젝트에만 적용되고, 이미 쓰던 프로젝트가 갑자기 저장을 시작하지는 않는다.

구글 변경 기록에 따르면 generateContent, streamGenerateContent, batchGenerateContent를 쓰는 유료 티어 신규 프로젝트의 요청은 이제 기본으로 저장되며, 이는 Interactions API와 같은 방식이다. 로그와 데이터셋 문서는 기준일을 10월 26일로 정확히 적고 있다. 이 날 이후 만든 새 프로젝트만 기본 저장하고, 그 이전 프로젝트는 AI 스튜디오에서 직접 켜지 않으면 저장하지 않는다.

구분	저장 기본값
10월 26일 이후 만든 유료 티어 프로젝트	켜짐(store=true)
10월 26일 이전 프로젝트	직접 켜지 않으면 저장 안 함
Interactions API	기본 저장(store=true)
무료 티어 프로젝트	로그 저장 불가(유료 티어에서만 지원)

저장된 요청은 어디에 얼마나 남나

저장된 요청은 AI 스튜디오의 로그 대시보드에서 볼 수 있다. 로그와 데이터셋 문서에 따르면 기본 보관 기간은 55일이고 7일, 14일, 28일, 55일 중에서 고를 수 있다. 로그를 데이터셋에 담아 두면 만료되지 않으며 CSV, JSONL, 구글 시트로 내보낼 수 있다. 로그를 보려면 프로젝트에 활성 API 키가 하나 이상 있어야 한다.

모든 호출이 저장되는 것은 아니다. 같은 문서는 이미지 생성 모델 Imagen, 영상 모델 Veo, 임베딩 모델, 동영상·GIF·PDF가 들어간 입력은 로깅을 지원하지 않는다고 적는다. 반대로 OpenAI 호환 엔드포인트로 보낸 호출은 저장 대상에 포함된다.

저장과 학습 사용은 별개의 문제다. 제미나이 API 추가 약관은 유료 서비스의 프롬프트와 응답을 제품 개선에 쓰지 않는다고 밝힌다. 무료 서비스는 입력과 응답을 제품 개선에 쓰고 사람이 검토할 수 있으므로, 민감한 개인정보나 기밀은 보내지 말라고 권고한다. 유료 서비스인지 여부는 결제 계정이 연결됐는지로 결정된다. 이번 변경으로 약관상 학습 사용 여부가 바뀐다는 내용은 변경 기록에 없다.

제미나이 API 요청 저장 끄는 법

저장을 막는 방법은 두 가지이고, 요청 단위 설정이 프로젝트 설정보다 우선한다. 개인정보나 고객 문의처럼 남기고 싶지 않은 요청에는 요청마다 store=false를 넣는다. 프로젝트 전체를 끄려면 AI 스튜디오 로그 대시보드의 설정 패널에서 Generate Content API 로깅을 끈다. 로그와 데이터셋 문서에 따르면 Generate Content와 Interactions는 각각 따로 설정한다.

1. AI 스튜디오에서 해당 프로젝트의 로그 대시보드(Logs and Datasets)를 연다.
2. 설정(Settings) 패널을 연다.
3. Generate Content API 로깅을 끈다. Interactions API도 쓰면 그것도 따로 끈다.
4. 반영됐는지 확인하려면 테스트 요청을 하나 보낸 뒤 로그 목록에 새 항목이 생기지 않는지 본다.

요청 단위로 store를 쓰려면 SDK 버전이 맞아야 한다. 로그와 데이터셋 문서는 최소 버전으로 파이썬 google-genai 2.33.0, 자바스크립트 @google/genai 2.31.0을 안내한다. 이 버전보다 낮으면 store 설정을 보낼 수 없으니 먼저 올려야 한다.

Interactions API는 저장을 끄면 쓰임이 달라진다. Interactions 문서에 따르면 store=false는 백그라운드 실행과 함께 쓸 수 없고, 다음 턴에서 previous_interaction_id로 이전 대화를 이어 받을 수 없다. 이때는 매 요청마다 전체 대화를 직접 보내야 한다. 이미 저장된 상호작용은 delete 메서드로 지울 수 있고, 유료 티어 보관 기간은 55일, 무료 티어는 1일이다.

내 프로젝트도 해당되나, 지금 할 일

해당 여부는 프로젝트를 만든 날짜와 티어로 판단한다. 변경 기록 기준으로 10월 26일 이후 만든 유료 티어 프로젝트라면 해당되고, 그 전에 만든 프로젝트는 로그와 데이터셋 문서대로 직접 켜지 않는 한 저장하지 않으며, 로그 저장은 유료 티어 프로젝트에서만 지원된다. 팀 계정에서는 프로젝트 목록의 생성일을 확인하면 된다.

새 프로젝트를 만들 때 먼저 확인할 순서는 다음과 같다.

1. 고객 이름, 연락처, 계약서처럼 개인정보나 기밀이 오가는 서비스인지 정한다.
2. 그렇다면 첫 요청을 보내기 전에 로깅을 끄거나 요청마다 store=false를 넣는다.
3. 로그가 필요한 서비스(품질 점검, 평가용 데이터 모으기)라면 보관 기간을 짧게 정하고, 로그를 보는 사람 범위를 정한다.
4. 이미 저장된 요청이 있다면 로그 대시보드에서 보관 기간 안에 있는 항목을 확인한다.

개인정보가 오가는 서비스라면 끄는 쪽이 안전하다. 유료 서비스의 프롬프트와 응답은 추가 약관상 제품 개선에 쓰이지 않지만, 로그에 저장되면 보관 기간 동안 로그 대시보드에 그대로 남는다. 반대로 요청 내용을 일부러 남겨서 응답 품질을 비교하거나 평가용 데이터를 만들 목적이면 저장은 오히려 도움이 된다. 이 경우 어떤 데이터를 보낼지 먼저 정해 두면 된다. 구글은 이번 변경 기록에서 기존 프로젝트에도 적용될지, 다른 티어로 넓힐지 밝히지 않았다. 모델 지원 중단 같은 다른 API 변경은 제미나이 API 모델 변경 정리에서 볼 수 있다.

자주 묻는 질문

기존 프로젝트의 요청도 저장되나요?

아니요. 10월 26일 이전에 만든 프로젝트는 AI 스튜디오에서 직접 켜지 않으면 저장하지 않는다.

저장된 로그를 구글이 학습에 쓰나요?

추가 약관은 유료 서비스의 프롬프트와 응답을 제품 개선에 쓰지 않는다고 밝힌다. 무료 서비스는 제품 개선에 쓰일 수 있다.

저장된 로그는 언제 지워지나요?

기본 보관 기간 55일이 지나면 삭제 대상이 된다. 7일, 14일, 28일 중에서 줄일 수 있고, 데이터셋에 담은 로그는 만료되지 않는다.