2.4.5 자주 발생하는 오류 확인하기
LLM 호출 코드를 실행할 때 오류가 발생하는 경우가 있습니다. 대부분은 코드 자체보다 API 키, 결제 상태, 모델 이름 같은 환경 설정이 문제입니다. 다음은 자주 발생하는 대표적인 오류 유형입니다.
표 2-4 LLM 호출 시 발생하는 주요 오류
|
오류 |
원인 |
해결 |
|
AuthenticationError |
API 키 문제 |
.env 파일과 API 키 확인 |
|
RateLimitError |
요청 한도 초과 또는 결제 문제 |
OpenAI 대시보드에서 결제 정보 확인 |
|
NotFoundError |
모델 이름 오류 |
모델 이름 오타 확인 |
AuthenticationError가 가장 자주 발생합니다. .env 파일을 만들었더라도 실제 파일명이 .env.txt로 저장되었거나 프로젝트 루트가 아닌 다른 폴더에 들어 있는 경우가 있습니다. 또한 API 키 앞뒤에 공백이 들어가도 인증 오류가 발생할 수 있으니 공백 여부를 확인합니다.
API 키 관련 오류가 발생하면 코드보다 환경 설정부터 확인하는 것이 좋습니다. .env 파일 위치, 환경 변수 이름, load_dotenv() 호출 위치, 현재 터미널 실행 경로를 차례대로 점검하면 대부분의 문제를 해결할 수 있습니다.