KO ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
API 키 받기

LLM API 오류 401: 인증 실패 해결

llm api 오류 401은 서버가 요청을 인증하지 못했음을 의미합니다. 거의 모든 경우 원인은 클라이언트 측에 있습니다: 오타가 있는 헤더, 이상한 문자가 포함된 키 또는 잘못된 호스트로 보낸 요청입니다. 이 가이드는 문제를 가장 빠르게 찾는 순서로 확인 사항을 안내합니다.

업데이트됨

빛나는 자물쇠에 맞지 않는 키, LLM API 호출 시 인증 실패를 나타내는 그림

주요 포인트

  1. 401은 속도 제한이나 청구 오류가 아닌 인증 실패입니다.
  2. 헤더는 Authorization: Bearer YOUR_KEY여야 하며, 공백은 하나만 있고 따옴표는 없어야 합니다.
  3. 잘못된 Base URL로 보낸 키는 잘못된 키와 마찬가지로 실패합니다.
  4. 먼저 curl로 테스트하세요. curl이 작동하면 버그는 앱의 구성에 있습니다.

먼저 이 curl 테스트를 실행하세요

코드를 변경하기 전에 앱을 제외하세요. 이 명령어는 API에 최소 유효 요청을 보냅니다:

curl -i https://api.unrestrictedaiapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

GET /v1/models은 비용이 들지 않으므로 키를 테스트하는 안전한 방법입니다. -i 플래그는 상태 줄과 헤더를 출력합니다.

  • 200 및 모델 목록: 키는 정상입니다. 앱이 다른 것을 보내고 있으므로 환경 변수 및 Base URL 섹션으로 이동하세요.
  • 401: 키 또는 헤더가 잘못되었습니다. 다음 섹션으로 계속 진행하세요.
  • 연결 또는 DNS 오류: Base URL이 잘못되었습니다. 이는 401과 다른 문제입니다.

변수를 통해가 아니라 수동으로 이 테스트에 키를 붙여넣으세요. 이렇게 하면 환경 변수를 의심 목록에서 제외할 수 있습니다.

원인 1: 헤더가 정확하지 않음

API는 Authorization: Bearer <key>를 기대합니다. 작은 편차도 모두 llm api 오류 401을 생성합니다:

  • Authorization: YOUR_KEY에서 Bearer가 누락되었습니다.
  • Authorization: Bearer: YOUR_KEY 불필요한 콜론 추가됨.
  • Authorization: Bearer "YOUR_KEY"에서 값 내에 따옴표가 있습니다.
  • Authorization: Bearer YOUR_KEY에서 두 개의 공백이 있습니다.
  • X-API-Key 또는 api-key라는 이름의 헤더를 Authorization 대신 사용함. 이는 다른 서비스의 관례입니다.

OpenAI SDK를 사용하는 경우 헤더를 직접 작성하지 않습니다. SDK는 api_key 인수에서 헤더를 생성합니다. 여전히 401이 표시되면 SDK에 전달된 값이 문제이며 헤더 형식이 아닙니다.

원인 2: 키 자체 손상

키는 긴 무작위 문자열이므로 복사 실수가 흔하고 눈으로 확인하기 어렵습니다.

  • 마지막 줄바꿈 또는 공백. 터미널이나 텍스트 파일에서 복사하면 이런 문자가 추가되곤 합니다. 많은 HTTP 라이브러리에서는 그런 경우 유효하지 않은 헤더나 일치하지 않는 키를 전송합니다.
  • 절단된 키. 키에 단어 선택을 깨뜨리는 문자가 포함된 경우 더블 클릭하면 문자열의 일부만 선택됩니다. API 키 페이지의 복사 버튼을 대신 사용하세요.
  • 스마트 따옴표. 워드 프로세서나 채팅 앱을 통해 붙여넣으면 직선 따옴표가 굽은 따옴표로 바뀔 수 있습니다.
  • 오래되거나 회전된 키. 새 키를 생성한 경우 이전 키는 더 이상 사용 중인 키가 아닐 수 있습니다.

Python에서 보이지 않는 문자를 확인하려면 값의 repr을 출력하세요:

import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))

두 번째 줄이 False를 출력하면 키 주변에 공백이 있습니다. 읽을 때 .strip()을 호출하세요.

원인 3: 잘못된 Base URL

기존 앱을 새 제공업체로 전환할 때 가장 흔한 실수입니다. 키는 발급한 호스트에서만 유효합니다. 이 사이트의 Base URL은 다음과 같습니다:

{"base_url": "https://api.unrestrictedaiapi.com/v1"}

두 가지 실패 패턴이 반복적으로 나타납니다:

  • 새 키를 설정했지만 이전 Base URL을 그대로 두었습니다. 요청이 이전 제공업체로 보내지며, 해당 제공업체는 본 적이 없는 키를 거부하고 401을 반환합니다. 오류 텍스트에는 이전 제공업체가 언급되어 있어 유용한 단서가 됩니다.
  • 새 Base URL을 설정했지만 환경에 이전 키를 그대로 두었습니다. 요청이 우리에게 도달하고 우리는 다른 제공업체의 키를 거부합니다.

경로도 확인하세요. Base URL은 이미 /v1로 끝나므로 SDK는 /chat/completions을 추가합니다. URL을 직접 빌드하는 경우 전체 경로는 /v1/chat/completions이며, /v1/v1/chat/completions이 아닙니다.

원인 4: 환경 변수 및 구성 파일

curl은 작동하지만 앱이 실패한다면, 앱이 생각한 키와 다른 키를 전달하고 있는 것입니다.

  • 변수가 export되지 않음. 셸에서는 API_KEY=abc python app.py는 작동하지만, API_KEY=abc를 별도 줄로 입력하면 자식 프로세스에 전달되지 않습니다. export를 사용하세요.
  • 다른 값에 의해 가려짐. 라이브러리는 OPENAI_API_KEY을 자동으로 읽을 수 있습니다. 셸 프로필에 이전 키가 설정되어 있으면 의도한 값을 덮어쓸 수 있습니다.
  • .env 파일의 따옴표. 일부 로더는 따옴표를 값의 일부로 유지합니다. 키가 따옴표 문자로 감싸져 있는 경우 제거하거나 위의 repr 확인으로 테스트하세요.
  • 재시작하지 않음. 서버 및 노트북은 시작 시 환경 변수를 읽습니다. 편집 후 재시작하세요.
  • 프로덕션의 다른 환경. 컨테이너, CI 및 호스팅 대시보드에는 각각 고유한 변수 저장소가 있습니다. 키 자체 대신 키 길이를 로그에 출력하세요.

구성을 증명하는 최소 Python 확인

이 스크립트는 OpenAI SDK를 사용하며 인증 실패가 발생하면 명확하게 보고합니다:

import os
from openai import OpenAI, AuthenticationError

client = OpenAI(
    base_url="https://api.unrestrictedaiapi.com/v1",
    api_key=os.environ["API_KEY"].strip(),
)

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Reply with the word ok."}],
        max_tokens=5,
    )
    print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
    print("401:", e.status_code, e.response.headers.get("X-Request-Id"))

이것이 X-Request-Id를 출력한다면, 팀이 요청을 찾을 수 있도록 지원팀에 작성할 때 포함하세요. 다른 언어의 동일한 확인 방법은 다섯 언어에 대한 빠른 시작에 있습니다.

401 및 기타 오류와의 차이

오류가 다른 것이라면 인증에 시간을 낭비하지 마세요. 간단한 참고:

코드일반적인 의미확인할 위치
401누락되거나 유효하지 않은 키헤더, 키, Base URL
429속도 제한 또는 일시적 과부하백오프 후 재시도하세요. 제한 사항에 대한 문서를 참조하세요.
400잘못된 요청 본문JSON, 모델 이름, 매개변수
404잘못된 경로Base URL 및 엔드포인트

모델 이름도 확인하세요. uncensored를 정확히 사용하세요. 잘못된 모델 ID는 401이 아닌 요청 오류입니다. API가 허용하는 엔드포인트 및 헤더를 포함한 상세 내용은 OpenAI 호환 API 사양 페이지에서 확인할 수 있습니다.

프록시, 브라우저 및 마지막 수단

401 오류를 혼란스럽게 만드는 두 가지 설정이 있습니다.

프록시 및 게이트웨이

앱과 API 사이의 리버스 프록시, API 게이트웨이 또는 서버리스 래퍼가 Authorization 헤더를 삭제하거나 수정할 수 있습니다. curl을 사용하여 동일한 머신에서 테스트하고 비교하십시오. 일부 프레임워크는 헤더를 동일 출처 호스트로만 전달하므로, 커스텀 fetch 래퍼가 교차 출처 호출 시 이를 조용히 잃을 수 있습니다.

프론트엔드 코드의 키

브라우저 JavaScript에서 직접 API를 호출하면 키가 개발자 도구를 여는 모든 사람에게 노출되며, 브라우저는 인증 오류처럼 보이는 교차 출처 이유로 요청을 차단할 수도 있습니다. 키를 서버에 보관하고 프론트엔드가 자체 엔드포인트를 호출하게 하세요. 해당 엔드포인트는 키를 첨부하여 API를 호출합니다. 키가 공개 코드나 스크린샷에 붙여진 적이 있다면 교체하세요.

여전히 막혔다면

새로 복사한 키로 curl 테스트에서 여전히 401이 반환되면 API 키 페이지에서 키를 다시 생성하고 명령어에 그대로 붙여넣은 후 다시 시도하세요. 실패할 경우 요청 시간, 엔드포인트 및 X-Request-Id 응답 헤더를 지원팀에 보내세요. 전체 키를 메시지에 보내지 마세요; 처음과 마지막 네 문자만 식별에 충분합니다.

질문과 답변

401은 크레딧이 부족하다는 의미인가요?

아닙니다. 401은 인증 관련 문제입니다: 키가 누락되었거나 잘못되었거나 알려지지 않았습니다. 크레딧이 부족하는 것은 별개의 상태입니다.

같은 키가 curl에서는 작동하지만 내 앱에서는 작동하지 않는 이유는 무엇입니까?

앱이 다른 값을 읽고 있을 가능성이 높습니다. 예를 들어 오래된 환경 변수, 따옴표로 감싼 .env 항목 또는 후행 공백이 있는 키입니다. 코드가 실제로 사용하는 키의 길이와 repr을 출력하세요.

OpenAI 키를 이 API에 사용할 수 있습니까?

아닙니다. 각 키는 발급된 호스트에서만 작동합니다. API 키 페이지의 키를 이 사이트의 Base URL과 함께 사용하세요.

401 오류에도 요금이 부과됩니까?

아닙니다. 실패하거나 거부된 요청에는 요금이 부과되지 않습니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.

API 키 받기