코드는 다 짰고 프롬프트도 설정했는데, 실행하자마자 오류가 납니다: Invalid API key, 401, 403, Access denied…… 정말 “난 분명 뭘 잘못한 게 없는데” 같은 느낌이죠. 이런 문제는 ChatGPT, Claude, Gemini의 API 호출에서 가장 흔하고, Midjourney도 서드파티 인터페이스로 중계해 쓰면 마찬가지로 함정에 걸리기 쉽습니다.
1 키를 붙여넣는 위치가 틀렸거나 공백이 섞인 경우
가장 많이 당하는 케이스입니다: 복사할 때 줄바꿈, 앞뒤 공백까지 같이 딸려오거나, Key를 Base URL 자리에 넣어버리는 경우. Key를 다시 한 번 복사하고, 앞뒤 문자를 수동으로 확인하는 것을 권합니다.
2 환경 변수가 적용되지 않음
export 했다고 생각했지만 실제로는 서비스가 재시작되지 않았거나, 로컬에서는 되는데 서버에 배포하면 터지는 경우가 있습니다. 눈치로 추측하기보다, 프로그램 시작 시 “KEY 길이를 읽었는지” 한 줄 로그를 찍어보는 게 훨씬 빠릅니다.
3 잘못된 프로젝트 또는 계정 권한을 사용함
일부 플랫폼은 Key가 “프로젝트/조직”에 묶여 있어 프로젝트를 바꾸면 바로 401이 뜹니다. 또 어떤 경우에는 Key를 실수로 삭제했거나 비활성화해 둔 상태일 수도 있습니다. 콘솔에서 상태를 확인하고, 혼자서 억지로 버티지 마세요.
