문제 해결
자주 겪는 문제 5가지를 모았어요. 항목을 누르면 해결 방법이 펼쳐집니다. 대부분은 1~2분 안에 해결돼요.
API 키가 잘못됐다는 오류가 나요
거의 다 복사 과정에서 생기는 문제예요. 위에서부터 확인해 보세요.
- 키 앞뒤에 공백이나 줄바꿈이 딸려 오지 않았는지 — 다시 복사해서 붙여넣는 게 가장 빨라요.
- AIza로 시작하는 전체 문자열인지 — 일부만 복사되는 경우가 많아요.
- Google AI Studio에서 해당 키가 활성 상태인지 — 삭제했거나 프로젝트가 바뀌면 키가 무효가 돼요.
- 그래도 안 되면 새 키를 발급해서 교체하는 게 확실해요.
키는 스튜디오 왼쪽 맨 위 버튼에서 언제든 바꿀 수 있어요 — 지금 쓰는 엔진 이름과 상태가 「Gemini 연결됨」 처럼 적혀 있어요. 연결 확인이 실패한 뒤라면 그 자리가 「Gemini 확인 필요」로 바뀌어요. 눌러서 열리는 창에서 「연결 다시 확인」을 누르면 지금 상태를 그 자리에서 볼 수 있어요. 발급 방법은 시작하기 1단계를 참고하세요.
429 오류(요청이 너무 많음)가 떠요
429는 고장이 아니라 잠깐 한도를 넘었다는 신호예요. 쓰시는 엔진(Gemini 등)은 등급별로 분당·일일 요청 한도가 있어서, 짧은 시간에 여러 번 생성하면 이 신호가 나올 수 있어요.
- 1~2분 기다렸다가 다시 시도하면 대부분 풀려요.
- 여러 글을 연달아 만들 때는 생성 사이에 간격을 조금 두세요.
- 자주 겪는다면 Google AI Studio에서 내 키의 사용량과 등급(무료/유료)을 확인해 보세요. 무료 등급은 한도가 넉넉하지 않은 편이에요.
참고로 무료 등급 키는 한도를 넘어도 요금이 나오지 않고 요청만 잠시 막혀요. 후불 계정이라면 지출 한도 설정을 잊지 마세요.
글 생성이 중간에 실패해요
대부분 일시적인 네트워크 끊김이나 모델 응답 지연이 원인이에요. 이렇게 해 보세요.
- 같은 조건으로 한 번 더 생성 — 일시 오류면 바로 성공해요.
- 인터넷 연결 확인 — 와이파이가 불안정하면 응답 중간에 끊겨요.
- 주제나 키워드가 아주 길다면 조금 줄여서 — 요청이 가벼울수록 안정적이에요.
- 브라우저 새로고침 후 재시도.
작성 중이던 초안은 브라우저에 저장되니 새로고침해도 사라지지 않아요. 같은 오류가 반복되면 429 항목도 함께 확인해 보세요.
데이터가 날아갈까 불안해요 — 백업은 어떻게 하나요?
초안·설정·발행 예약 같은 모든 데이터는 서버가 아니라 내 브라우저(localStorage)에 저장돼요. localStorage는 브라우저가 사이트별로 제공하는 작은 저장 공간이에요. 서버에 없으니 프라이버시에는 장점이지만, 브라우저 데이터를 지우거나 시크릿 모드를 쓰면 사라질 수 있어요.
- 데이터 페이지에서 백업 파일을 내려받아 두세요. 복원도 같은 곳에서 해요.
- 브라우저나 컴퓨터를 바꿀 때도 백업 파일로 옮기면 돼요. API 키는 보안상 백업에 포함되지 않으니 새 브라우저에서 다시 입력해 주세요.
- 브라우저 방문 기록·사이트 데이터 일괄 삭제 전에는 꼭 백업부터.
예약 발행이 안 돌아가요 / 탭을 닫으면 멈추나요?
네, 멈춰요. 발행 예약은 브라우저 탭이 열려 있는 동안 동작하는 방식이에요. 서버가 대신 눌러 주는 구조가 아니라서, 탭을 닫거나 컴퓨터가 꺼지면 예약이 진행되지 않아요.
- 발행이 진행되는 동안 SGI Workspace 탭을 열어 두세요.
- 노트북 절전 모드와 브라우저의 탭 절전(메모리 절약) 기능도 중단 원인이에요. 발행 시간대에는 꺼 두는 걸 권해요.
- 장시간 자리를 비울 예약이라면, 돌아왔을 때 예약 목록 상태(대기/완료/실패)를 한 번 확인해 주세요.
이 한계는 설치형 상주 프로그램과 다른, 웹앱의 구조적인 차이예요. 자세한 비교는 설치형에서 갈아타기에 정리해 뒀어요.
읽는 것보다 한 번 만들어 보는 게 빨라요
API 키만 있으면 몇 분 안에 첫 글 초안이 나옵니다. 제품이 어떤 물건인지부터 보고 싶다면 소개 페이지를 먼저 봐도 좋아요.