KO ▾
API 키 받기

Janitor AI API 네트워크 오류: 원인 및 해결 방법

커스텀 OpenAI 호환 프록시를 사용한 Janitor AI API 네트워크 오류는 거의 항상 다음 다섯 가지 중 하나에서 비롯됩니다: URL, 키, 모델 이름, 제한 사항 또는 컨텍스트 크기입니다. 이 페이지는 오류를 가장 빠르게 찾는 순서대로 이를 설명합니다.

케이블로 연결된 두 정육면체 중 끊긴 부분이 수리되는 모습으로 연결 오류 해결을 설명합니다
키에서 클라우드 노드를 거쳐 채팅 말풍선으로 흐르는 빛나는 파티클의 흐름

업데이트

주요 포인트

  • 먼저 curl로 엔드포인트를 테스트하세요. curl이 작동한다면 서비스 문제가 아니라 설정에 문제가 있습니다.
  • 전체 채팅 완료 URL, 정확한 모델 ID인 uncensored, 그리고 공백 없는 키를 사용하세요.
  • 429는 제한을 의미합니다: 분당 허용 요청 수 초과, 동시 요청 수 초과, 또는 일시적 과부하입니다.
  • 컨텍스트 설정을 100,000-토큰 창보다 낮게 유지하고, 크레딧을 아끼려면 더 낮게 설정하세요.

0단계: 어떤 쪽이 고장 났는지 확인하세요

"네트워크 오류"는 일반적인 메시지입니다. 앱이 사용 가능한 응답을 받지 못했다는 뜻이지, 그 이유를 알려주지는 않습니다. 설정을 무작위로 변경하기 전에 터미널에서 동일한 요청을 직접 보내세요. 거기가 작동하면 엔드포인트와 키가 정상이며 문제는 Janitor이 보내는 데이터에 있습니다. 실패하면 실제 오류 코드를 읽을 수 있습니다.

curl -i https://api.unrestrictedaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello."}],"max_tokens":20}'

출력의 첫 줄을 확인하세요. 200 상태와 JSON 응답은 서비스가 작동함을 의미합니다. 다른 숫자는 아래 섹션을 가리킵니다. -i 플래그는 잔액인 X-Balance-USD를 포함한 헤더도 보여줍니다. 클릭을 선호한다면 docs에 동일한 요청 형식이 나열되어 있습니다.

입력한 세 필드 확인하기

Janitor AI의 API 설정에서 프록시 또는 사용자 지정 API 옵션을 선택하고 몇 가지 필드를 채웁니다. 메뉴 이름은 버전마다 다르므로 레이블보다는 의미로 일치하세요.

필드올바른 값일반적인 실수
프록시 / API URLhttps://api.unrestrictedaimodels.com/v1/chat/completions베이스 /v1, 누락된 https://, 또는 후행 공백만 해당됩니다
API 키대시보드에서 복사한 키 그대로 붙여넣기불필요한 공백, 줄바꿈 또는 키 입력란에 "Bearer" 입력
모델 이름uncensoredgpt-4 또는 벤더 모델과 같은 이름 입력

Janitor은 일반적으로 프록시 필드에 전체 채팅 completions URL이 필요하지만, SillyTavern과 같은 다른 앱은 베이스 URL만 필요로 합니다. 필드 힌트에 /chat/completions로 끝나는 예시가 표시되면 이를 따르세요. 베이스 URL은 https://api.unrestrictedaimodels.com/v1이며 경로는 여기에 추가됩니다.

이 모델은 벤더 간 라우터가 아닙니다. 단일 모델이며 그 ID는 uncensored입니다. 다른 모든 이름은 잘못된 값입니다. 두 앱의 설정 차이를 보고 싶다면 SillyTavern과 Janitor AI 비교를 읽으세요.

상태 코드 읽기

curl이 200이 아닌 값을 반환했다면 이 표를 사용하세요.

상태의미해결 방법
401키가 누락되었거나 잘못됨대시보드에서 키를 다시 복사하세요. 끝에 공백이 있는지 확인하세요.
404잘못된 경로URL을 위의 표와 문자 단위로 비교하세요
400잘못된 요청 본문보통 요청의 잘못된 필드입니다. 모델 이름과 컨텍스트 설정을 확인하세요
429제한에 도달함다음 섹션 참조
연결 오류, 상태 없음호스트 이름 오타 또는 네트워크 차단철자를 확인하고 다른 네트워크를 시도하거나 VPN 및 광고 차단기를 끄세요

실패한 요청은 요금이 부과되지 않으므로 디버깅 중 재시도해도 비용이 들지 않습니다. curl에서 200을 받지만 Janitor에서 여전히 오류가 표시되면 컨텍스트 및 제한 섹션으로 넘어가세요.

429: 속도 제한 및 동시성

HTTP 429는 여기서 세 가지 형태로 나타납니다. 본문에는 어떤 형태인지 알려주는 오류 코드가 포함되어 있습니다:

  • rate_limited: 분당 허용 요청 수를 초과했습니다. 전체 키는 300개를 허용하고, 체험 키는 60개를 허용합니다.
  • concurrency: 동시에 너무 많은 요청. 전체 키는 8개를 허용하고, 체험 키는 2개를 허용합니다.
  • 일시적 과부하: Retry-After: 5 헤더가 있는 429입니다. 5초 기다렸다가 다시 시도하세요.

롤플레이 앱은 생각보다 쉽게 동시 요청 한도에 도달합니다. 재생성을 빠르게 누르거나 채팅을 두 개의 탭으로 열어두거나 휴대폰에서 두 번째 채팅을 실행하면 각각 다른 요청이 열립니다. 스트리밍된 응답은 완료될 때까지 슬롯을 유지합니다. 체험용 키에서는 두 개의 슬롯이 빠르게 채워지므로, 응답이 한 번 멈추고 재생성 한 번만으로도 오류가 발생할 수 있습니다. 몇 초 기다렸다가 불필요한 탭을 닫고 다시 시도하세요.

모든 호출이 즉시 429로 실패하고 다른 실행 중인 것이 없음을 확신한다면, 동일한 키가 다른 앱, 스크립트 또는 친구의 설정에서도 사용되지 않는지 확인하세요.

컨텍스트 크기: 조용한 원인

Janitor은 캐릭터 카드, 사용자 페르소나, 채팅 기록 및 메모리 노트에서 프롬프트를 구성하며, 설정한 컨텍스트 크기까지 허용합니다. 이 API는 프롬프트와 응답을 합쳐 100,000 토큰까지 허용합니다. 컨텍스트 설정이 이를 초과하거나, 응답 길이를 너무 크게 설정하여 총량이 창을 초과하면 요청이 실패할 수 있습니다.

컨텍스트를 16,000~32,000 토큰으로, 응답 길이를 수백 토큰으로 설정하고 다시 테스트하세요. 더 길다고 항상 좋은 것은 아닙니다: 모델이 더 많은 기록을 보지만, 모든 메시지가 이를 모두 다시 전송하며, 당신은 그것에 대해 비용을 지불합니다.

간단한 계산입니다. 컨텍스트가 20,000 토큰이고 응답이 300 토큰일 때, 한 메시지당 비용은 20,000 x 0.15 / 1,000,000 + 300 x 0.50 / 1,000,000 = $0.003 + $0.00015 = $0.00315입니다. $20 충전으로 해당 크기의 메시지를 약 6,300개 구매할 수 있습니다. 컨텍스트가 8,000 토큰일 때 같은 메시지 비용은 $0.00135로, 달러당 구매 가능한 메시지 수가 두 배 이상 늘어납니다. 상세 요금과 보너스는 요금제 페이지에서 확인하세요.

안전한 설정 시작

문제를 잘 모르겠다면 기본 구성으로 초기화하고 작동하는지 확인한 후 한 번에 하나씩 설정을 높이세요. 이렇게 하면 문제를 일으키는 설정이 명확해집니다.

  • 컨텍스트 크기: 16,000 토큰.
  • 최대 응답 길이: 300~500 토큰.
  • Temperature: 0.8. 1.2 초과 값은 이상한 텍스트를 생성하며, 이는 네트워크 오류가 아닙니다. 하지만 이는 흔한 오해의 원인입니다.
  • 스트리밍: 앱에 옵션이 있다면 켜고 끌 때 모두 시도하세요. 이벤트 스트림을 끊는 프록시나 광고 차단기는 켜기 설정은 실패하게 하지만 끄기 설정은 작동하게 할 수 있습니다.
  • 커스텀 프롬프트 또는 재일브레이크 상자: 테스트를 위해 비워두세요. 매우 긴 붙여넣기 프롬프트는 채팅 기록이 추가되기 전에 컨텍스트의 대부분을 차지할 수 있습니다.

문제를 해결한 변경 사항을 메모해 두세요. 롤플레이 앱의 오류는 업데이트나 새로운 캐릭터 카드 추가 후 다시 나타나는 경향이 있으며, 작동하는 값들의 기록된 목록을 만들어 두면 전체 과정을 반복하지 않아도 됩니다. 커뮤니티에서 도움을 요청할 때 스크린샷에 키를 공유하지 마세요. 만약 공유했다면 키를 교체하세요.

짧은 메시지에 응답이 오면 실제 캐릭터 카드와 페르소나를 다시 붙여 넣으세요. 그 시점에서 오류가 다시 발생하면 카드나 메모리 노트가 선택한 컨텍스트 창에 비해 너무 큽니다.

잔액, 키 상태 및 기타 확인 사항

키가 올바르고 URL이 정확하지만 요청이 여전히 실패하는 경우 계정 상태를 확인하세요.

  1. 크레딧을 확인하세요: curl https://api.unrestrictedaimodels.com/v1/balance -H "Authorization: Bearer YOUR_KEY". 잔액이 0이면 다음 충전이 필요합니다. 크레딧은 만료되지 않으므로 사용하지 않은 크레딧이 그대로 유지됩니다.
  2. 체험 크레딧이 다 떨어지지 않았는지 확인하세요. 금액은 $0.50이며 7일 동안 유효합니다.
  3. 확장 프로그램을 끄고 시크릿 창에서 앱을 엽니다. 광고 차단기 및 개인 정보 보호 확장 프로그램은 익숙하지 않은 API 호스트로의 호출을 차단할 수 있습니다.
  4. 다른 기기나 네트워크를 시도하세요. 학교, 직장 또는 호텔 네트워크는 익숙하지 않은 호스트를 차단할 수 있으며, 모바일 핫스팟은 이를 배제하는 빠른 방법입니다.
  5. 실패한 curl 호출에서 X-Request-Id 헤더를 저장하세요. 지원팀에 연락하면 해당 ID로 정확한 요청을 찾을 수 있습니다.

지불은 암호화폐(TRC20의 USDT, Base의 USDC)로 $20부터 가능합니다. 아직 키를 생성하지 않았다면 여기서 생성하세요. 이 모델로 채팅 설정에 대한 일반적인 개요는 채팅봇 가이드를 참조하세요.

질문과 답변

Janitor AI의 프록시 필드에 어떤 URL을 넣어야 하나요?

https://api.unrestrictedaimodels.com/v1/chat/completions. 앱을 사용하려면 베이스 URL만 요청한다면 https://api.unrestrictedaimodels.com/v1.

어떤 모델 이름을 입력해야 합니까?

모델 ID는 uncensored입니다. 단일 모델만 있으므로 다른 이름은 실패합니다.

curl 테스트는 성공했지만 Janitor에서 오류가 표시됩니다. 어떻게 해야 하나요?

컨텍스트 크기를 줄이고, 적당한 응답 길이를 설정하며, 중복된 탭을 닫고, 확장 프로그램이 없는 시크릿 창을 사용해보세요. 그런 다음 키에 불필요한 공백이 없는지 확인하세요.

실패한 요청은 크레딧을 소모합니까?

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

키 발급까지 단 한 단계만 더 남았습니다

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

API 키 받기