백엔드에 ChatGPT, Claude, Gemini API를 붙였을 때 가장 흔히 터지는 건 모델이 별로라서가 아니라 API 키 오류, 네트워크 연결 불가, 지역 정책에 막히는 경우다. Midjourney는 API 키 체계를 쓰진 않지만 Discord에서도 권한·쿼터 안내를 만나는데, 본질은 같은 부류다: 너는 “허용되지” 않았다.
1분 자가 점검: API 오류의 90%는 여기서 나온다
- 키를 잘못 붙여넣음: 공백이나 줄바꿈이 더 복사됐거나, “프로젝트 키”를 “개인 키”처럼 사용함
- 키 권한 부족: 과금 미개통/카드 미연동/조직 또는 프로젝트가 해당 모델에 대한 권한을 부여받지 못함
- 환경 변수가 적용되지 않음: 서비스를 재시작했는가? 컨테이너와 로컬이 서로 다른 설정을 쓰고 있진 않은가
- 프록시에 발목 잡힘: 웹페이지가 열린다고 해서 백엔드가 API 도메인에 직접 붙는다는 뜻은 아니다. 많은 사람이 여기서 막힘
에러 메시지에 맞춰 처방하기
Unauthorized 또는 Invalid API key
플랫폼 탓부터 하지 말고, 먼저 콘솔에서 키를 다시 생성하고 기존 키는 바로 폐기하라. 그리고 요청 헤더에서 올바른 필드를 쓰고 있는지 확인하라. 봇이나 플러그인을 만들 때, Koishi 플러그인 같은 경우도 키 필드명이나 붙여넣기 형식 때문에 오류가 자주 난다.
Rate limit 또는 Quota exceeded
이건 “고장”이 아니라 네가 너무 세게 쓴 거다. 동시성을 낮추고, 재시도 백오프를 넣어라. 안정적으로 쓰려면 더 높은 쿼터의 요금제로 올려라. Midjourney도 fast가 소진됐을 때 같은 이치다. 느린 큐로 줄 서면 되니 너무 열받지 마라.
