SpringAI - OpenAI API 활용 중 Aggregation Error - 401 Unauthorized Error 해결 방법

 

필자는 SpringBoot를 활용하여 OpenAI로 'Gpt-4o-mini' 모델을 사용하고 있습니다. 간단하게 AI를 활용한 Chat 서비스를 만들기 위해 Chat Model API를 활용하고 있습니다. ChatModel 객체를 이용하여 시스템 메시지 및 사용자 메시지를 만들고 프롬프트 객체 생성 후, call()을 실행했는데 "Aggregation Error - 401 Unauthorize from POST {endPoint}" 에러가 발생했습니다. 대표적으로 OpenAI를 연동하게 되면 401, 429 에러를 가장 많이 보게 된다고들 합니다. 필자 역시도 401 에러를 보게되었습니다.

 

 

발생된 에러 Log

SpringAI 'Aggregation Error - 401 Unauthorize'

 

 

 

 

 

OpenAI Platform 공식 Docs

 

 

OpenAI Platform Document에서 'erorr-codes' 항목을 참고해보면 '401 - Invalid Authentication' 에러에 대해서 설명하고 있습니다. OpenAI에서의 401 에러는 인증 정보가 잘못되어서, API 키가 없거나 틀렸거나 형식이 잘못됐을 때 발생한다고 설명합니다. 

 

 

📢 401에러가 발생하는 대표적인 이유

• API Key를 넣지 않았거나 헤더 형식이 틀렸을 때
  - Authorization : Bearer {API_KEY}로 정확히 보내야 합니다.
• 환경 변수나 설정에서 키가 누락되었을 때
  - 실행 환경이 키를 제대로 읽고 있는지 확인합니다.
• 잘못되거나 만료되었거나 폐기된 API Key 일 때
  - OpenAI Platform Dashboard에서 새로운 키를 발급 후 사용합니다.
• 조직 권한 문제
  - 일부 API는 조직 멤버만 접근 가능하기 때문에 조직 구성원을 확인합니다.
• IP 허용 목록 제한
  - 허용되지 않은 IP에서 요청하면 401 에러가 발생할 수 있습니다.

 

 

 

 

 

에러 해결 방법

 

API KEY 재발급하기

기존에 발급받았던 키가 잘못되었거나 만료되었기 때문에 발생하는 에러이므로 새로운 키로 재발급을 진행합니다.

 

1.  OpenAI Platform에 접속 후, 왼쪽 상단 검색란에 'API Key'를 검색 후 페이지로 이동합니다.

 

 

OpenAI Platform API Key 발급

 

 

 

 

 

2.  'Create new secret key' 버튼을 클릭합니다. Secret key 생성 모달이 열리고 Name을 입력 후 Project는 'Default project'를 선택하고 Create secret key 버튼을 눌러 키를 생성합니다.

 

 

 

 

 

 

SpringBoot 설정 수정하기

SpringBoot에서 'API KEY' 인식에 문제가 발생되면 KEY를 제대로 인식하지 못해서 발생하는 에러이므로 설정을 다시 진행합니다.

 

1.  application.properties 파일에 '${OPENAI_API_KEY}' 로 설정하고 있는 부분을 정확한 API KEY로 설정합니다. 

 

 

필자는 OS 환경변수에 'OPENAI_API_KEY'로 등록 후, application.properties 파일에서 환경변수 값을 당겨다가 사용하고 있습니다. 이와 같은 방법으로 진행할 때 문제가 된다면, openai.api-key의 값을 API_KEY로 직접 입력하여 사용합니다.

 

 

 

 

 

@Junesker

---