코드로 ChatGPT/Claude/Gemini API를 붙이거나 Midjourney에서 한참 생성하다 보면, 제일 짜증나는 건 못 쓰는 게 아니라 에러가 “사람 말”로 말해놓고 끝까지 안 알려준다는 거다. 내가 가장 흔한 함정을 증상별로 정리해 점검 체크리스트로 만들어뒀는데, 그대로 따라 하면 대부분 문제를 찾아낼 수 있다.
에러 1 Invalid API key 401 인증 실패
이런 건 대개 네가 손이 미끄러져서가 아니라 “열쇠구멍”을 잘못 쓴 거다.
- 플랫폼에 맞는 Key를 가져왔는지 확인: OpenAI, Anthropic, Google은 각각 자기 Key를 쓰니 섞어 쓰지 말 것.
- 공백과 줄바꿈 제거: 환경 변수에 복사할 때 엔터가 붙는 경우가 가장 흔하다.
- 요청 주소와 Header 점검: base_url을 틀리게 쓰거나 Authorization에서 Bearer를 빼먹으면 가차 없이 튕긴다.
- 권한과 한도: 일부 모델은 별도 활성화가 필요하고, 계정 미납/결제수단 미등록도 “Key 무효”처럼 보일 수 있다.
에러 2 403 429 접근 제한 또는 호출 빈도 초과
나는 보통 먼저 네트워크와 지역을 의심하고, 그다음에 내가 무한 루프를 짰는지 의심한다.
- 403 지역/리스크 제어: 안정적인 네트워크 환경으로 바꾸고 IP를 자주 바꾸는 건 피하자. 회사망/학교망도 차단되기 쉽다.
- 429 너무 빠름: 재시도와 백오프(예: 1초, 2초, 4초 대기)를 넣고, 동시 요청을 과도하게 올리지 말 것.
에러 3 플러그인 설치 중 ETARGET ERESOLVE ENOTEMPTY
많은 사람이 봇이나 워크플로 연동을 위해 의존성을 설치하다가 패키지 매니저에서 막혀서 키보드를 부수고 싶어진다.
- ETARGET: 존재하지 않는 버전 번호다. 실제로 배포된 버전으로 바꾸거나 npm/yarn을 업그레이드하자.
- ERESOLVE: 의존성 충돌이다. lock 파일을 지워보고, 필요하면 legacy-peer-deps를 사용하자.
- ENOTEMPTY: 디렉터리가 깔끔하게 삭제되지 않았다. node_modules를 지우고 다시 설치하면 얌전해진다.
Midjourney 자주 발생하는 문제: Interaction failed 또는 대기열이 너무 김
- Interaction failed: 네트워크 흔들림이나 Discord 지연에서 자주 발생한다. 명령을 다시 보내거나 채널을 바꿔서 시도해 보자.
- 대기열/속도 제한: 피크 시간에는 무리하게 밀어붙이지 말고, 동시 실행을 낮추거나 더 “느슨한” 생성 템포로 쓰자.
아직도 계정 환경, 구독 경로, 도구 진입점 때문에 여기저기 링크를 뒤지고 있다면, Titikey에 한 번 들러서 자주 쓰는 AI 도구와 해결책을 한 번에 정리해 두는 걸 추천한다. 아낀 시간으로 그림 두 장은 더 뽑는다.
