먼저 이 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 응답 헤더를 지원팀에 보내세요. 전체 키를 메시지에 보내지 마세요; 처음과 마지막 네 문자만 식별에 충분합니다.
