OpenAI API 401 Unauthorized (인증 오류)
지금 장애가 있나요?
OpenAI API 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
OpenAI API의 가동 상태 보기 →오류의 의미
401은 인증 실패를 의미합니다. API 키가 잘못되었거나 만료·미설정이거나, 조직/프로젝트 지정이 잘못되었을 때 발생합니다.
자주 있는 원인
- •API 키가 틀렸거나 만료·삭제됨
- •Authorization 헤더 형식 오류(Bearer 누락)
- •환경 변수를 읽지 못함(미설정 / 오타)
- •조직(Organization)/프로젝트 지정 오류
- •키 권한 부족
해결 방법
- 1.API 키를 재발급하고 환경 변수에 올바르게 설정
- 2.헤더를 `Authorization: Bearer <KEY>` 형식으로
- 3.키를 하드코딩하지 말고 환경 변수에서 읽기
- 4.올바른 조직/프로젝트 지정
- 5.키의 권한(scope) 확인
기다리면 되는 경우 / 기다려도 안 되는 경우
401은 설정 문제이므로 기다려도 해결되지 않습니다. 키·헤더·환경 변수를 다시 확인하세요.
OpenAI API을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
401 Unauthorized은(는) 무엇인가요?
401은 인증 실패를 의미합니다. API 키가 잘못되었거나 만료·미설정이거나, 조직/프로젝트 지정이 잘못되었을 때 발생합니다.
401 Unauthorized은(는) 어떻게 해결하나요?
API 키를 재발급하고 환경 변수에 올바르게 설정 / 헤더를 `Authorization: Bearer <KEY>` 형식으로 / 키를 하드코딩하지 말고 환경 변수에서 읽기 / 올바른 조직/프로젝트 지정 / 키의 권한(scope) 확인