ChatGPT Claude Gemini API 키가 무효이거나 403 접근 제한이 뜰 때 점검 체크리스트

자동화 스크립트, 봇, 워크플로 연동을 할 때 제일 멘붕인 건 코딩이 아니라 갑자기 API key invalid, 401, 403, 네트워크 타임아웃이 튀어나오는 것이다. 당황하지 말자. 이 글은 내가 직접 삽질했던 순서대로 “그대로 따라 점검하면 원인을 특정할 수 있는” 체크리스트를 정리한 것이고, ChatGPT, Claude, Gemini 모두 공통으로 적용된다.

먼저 오류 타입부터 확인하자. 시작부터 재설치부터 하지 말 것

많은 사람이 모든 문제를 “키가 틀렸다”로 몰아가서 헛수고를 한다.

• 401: 키가 무효, 누락, 형식 오타, 프로젝트 미개통
• 403: 권한 부족, 지역/리스크 통제 제한, 한도 정책 차단
• 429: 레이트 리밋 또는 크레딧/쿼터 소진
• 타임아웃/ENOTFOUND: 네트워크/DNS/프록시 문제로, 키와는 무관

API 키가 무효가 되는 흔한 원인

일부 플러그인 트러블슈팅에서 언급되는 “API 키 오류”와 의존성 설정 함정을 참고해, 내가 보기엔 가장 흔한 건 다음 몇 가지다:

• 공백이나 줄바꿈이 같이 복사됨: 특히 환경 변수에서 끝에 공백 하나만 있어도 사람 미치게 만든다
• 플랫폼 키를 잘못 사용: OpenAI, Anthropic, Google 키는 서로 호환되지 않는다. Gemini 키를 Claude 설정에 넣는 실수는 하지 말자
• 요청 헤더를 잘못 작성: Authorization 접두어, 헤더 필드명 대소문자, Bearer 누락
• 프로젝트에 결제/권한이 미개통: 키 자체는 진짜여도 계정에 해당 API 권한이 열려 있지 않으면 거부될 수 있다

403 접근 제한: 지역과 출구를 중점 점검

403이 제일 짜증나는 이유는 대개 “대체 뭐가 안 되는지”를 잘 안 알려주기 때문이다. 내 경험상 먼저 출구 IP와 프록시 규칙을 확인하고, 그다음 계정 권한을 확인한다.

• 같은 머신: 브라우저로 열린다고 서버도 접근 가능한 건 아니다. 서버의 출구가 차단된 경우가 많다
• 프록시 분기: 요청이 프록시를 탔는지 꼭 확인해야 한다. 흔한 현상은 로컬은 되는데 운영/온라인은 죽는 것
• 기업 네트워크: 회사 게이트웨이/보안 장비가 AI 도메인을 차단하기도 한다. 휴대폰 핫스팟으로 바꿔보는 게 가장 빠른 검증

Midjourney는 API를 쓰진 않지만 검증 실패의 작은 함정은 있다

Midjourney는 주로 Discord 쪽에서 문제가 난다: 계정이 인증을 완료하지 않았거나, 채널 권한이 맞지 않거나, 봇 명령을 사용할 수 없는 경우다. “생성 불가/사용 불가”를 만나면 먼저 Discord 계정 상태, 구독 유효 여부, 그리고 올바른 MJ 채널 또는 Bot과의 DM에서 명령을 보내고 있는지 확인하자.

삽질을 줄이고 싶다면 미들 레이어로 통합 관리

ChatGPT, Claude, Gemini를 동시에 쓴다면 키, 라우팅, 재시도 전략을 한곳에서 집중 관리하는 것을 권한다. 오픈소스 게이트웨이 방식(기존 API를 통일된 프로토콜로 변환해 접속하는 방식)은 “하나의 진입점으로 모든 모델을 관리”하기에 적합하고, 최소한 여러 스크립트에서 여기저기 키를 바꾸는 일은 줄어든다.

구독, 네트워크, 지역 가용성 같은 더 현실적인 문제를 처리 중이라면 Titikey도 한 번 둘러봐라. 나는 결제나 가용성 관련 골치 아픈 문제를 겪을 때 종종 거기서 해결책과 대조 체크리스트를 먼저 찾아본다.