Janitor AI 프록시 설정: URL 형식, 모델, 429 해결법

빠른 답변: JanitorAI가 요구하는 세 가지 항목

JanitorAI의 프록시 설정은 정확히 세 가지 값을 요구합니다: 프록시 URL, 모델 이름, API 키. 프록시 URL은 base URL이 아니라 전체 chat completions 엔드포인트여야 합니다. 프로바이더가 /v1으로 끝나는 base URL을 줬다면, JanitorAI에 붙여넣기 전에 /chat/completions를 덧붙이세요. 이 한 가지 디테일이 다른 모든 원인을 합친 것보다 더 많은 설정 실패를 일으킵니다. 모델 ID는 프로바이더가 표기한 그대로, 소문자와 하이픈까지 정확히 입력한 뒤 저장하고 짧은 테스트 메시지를 보내세요. 응답이 돌아오면 끝입니다. 대신 오류 코드가 뜬다면 아래 오류 표로 건너뛰세요. 흔한 코드마다 구체적인 원인과 구체적인 해결법이 있습니다.

Proxy URL:  https://api.apisrouter.com/v1/chat/completions
Model:      deepseek-v4-flash
API Key:    sk-...   (따옴표나 앞뒤 공백 없이 정확히 붙여넣기)

JanitorAI 커뮤니티에서 "프록시"가 뜻하는 것

이 단어는 오해의 소지가 있습니다. JanitorAI 은어에서 프록시는 네트워크 프록시나 VPN이 아닙니다. 사이트가 기본 백엔드 대신 채팅 요청을 보내는 아무 OpenAI 호환 API 엔드포인트를 뜻합니다. 이 용어는 몇 년 전 사람들이 프로바이더 API의 리버스 프록시를 통해 채팅을 라우팅하기 시작하면서 커뮤니티에 자리 잡았고, 오늘날 대부분의 설정이 프로바이더나 게이트웨이와 직접 통신함에도 이름은 그대로 남았습니다. 사람들이 프록시를 쓰는 이유는 세 가지입니다. 첫째, 모델 선택입니다. 사이트가 기본으로 제공하는 모델을 그대로 받아들이는 대신 캐릭터를 쓸 LLM을 정확히 고를 수 있습니다. 둘째, 품질입니다. DeepSeek V4나 Claude 같은 모델은 무료 내장 티어보다 더 길고 일관된 장면을 씁니다. 셋째, 비용 통제입니다. 토큰당 과금되는 키를 쓰면 다 쓰지 못할 수도 있는 구독료를 내는 대신 채팅 하나하나가 얼마인지 정확히 볼 수 있습니다. 커뮤니티에서 공유되는 엔드포인트는 세 종류입니다. 공식 프로바이더 API(OpenAI, Anthropic, xAI, DeepSeek)는 각 벤더별 계정이 필요합니다. 게이트웨이는 여러 모델을 하나의 OpenAI 호환 URL과 하나의 키 뒤로 묶어줍니다. 커뮤니티의 "무료 프록시"는 다른 누군가가 비용을 대는 공유 키이며, 그래서 불안정하고 강하게 레이트 리밋이 걸립니다. 한 가지 분명히 짚어둘 점은 이렇습니다: 어떤 엔드포인트를 쓰든 업스트림 모델 프로바이더의 콘텐츠 정책은 모든 응답에 그대로 적용되고, JanitorAI 자체의 약관, 그중에서도 성인 전용 요건 역시 플랫폼을 계속 지배합니다. 모델을 고르기 전에 두 정책을 모두 알아두면 장면 도중 거부당하는 일을 피할 수 있습니다.

전체 설정: API 키부터 첫 응답까지

DeepSeek, GLM, Kimi, Claude, Gemini, Grok을 한 번에 다루는 키 하나를 원한다면, APIsRouter 같은 OpenAI 호환 게이트웨이가 마찰이 적은 경로입니다: /topup에서의 결제는 계정 가입이 필요 없고, 키는 이메일로 도착하며, JanitorAI용 프록시 URL은 https://api.apisrouter.com/v1/chat/completions입니다. SillyTavern도 함께 쓴다면 한 가지 짚어둘 부분이 있습니다: SillyTavern은 /v1으로 끝나는 base URL을 원하고 키를 이용해 /v1/models에서 모델 목록을 자동으로 채우는 반면, JanitorAI는 /chat/completions를 포함한 전체 경로를 원합니다. 같은 엔드포인트인데 URL의 길이만 다른 셈입니다. 이 두 형식을 헷갈리는 것이 두 앱 모두에서 404 오류가 나는 가장 흔한 원인입니다.

• OpenAI 호환 프로바이더나 게이트웨이에서 API 키를 받으세요. 키 문자열과 문서화된 엔드포인트 URL이 필요합니다.
• JanitorAI에서 아무 캐릭터 채팅을 열고 API Settings를 연 뒤 Proxy 옵션을 선택하세요.
• /chat/completions로 끝나는 전체 엔드포인트 URL을 proxy URL 필드에 붙여넣으세요.
• 모델 ID를 문서화된 그대로 정확히 입력하세요. 예를 들어 deepseek-v4-flash나 glm-5처럼요.
• API 키를 붙여넣고 설정을 저장한 뒤, 저장이 반영되지 않으면 페이지를 새로고침하세요.
• 한 줄짜리 테스트 메시지를 보내세요. 정상적인 응답이 오면 전체 체인이 작동하는 것입니다.

JanitorAI를 탓하기 전에 curl로 엔드포인트를 먼저 테스트하세요

프록시가 오작동할 때는 JanitorAI 밖에서 먼저 엔드포인트를 테스트하세요. 10초짜리 curl 호출이면 문제가 엔드포인트인지, 키인지, 사이트에 설정한 방식인지 알 수 있습니다. 자신의 키와 모델로 아무 터미널에서나 실행해보세요:

curl https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Reply with one short sentence."}]
  }'

오류 429: 무료 프록시가 피크 시간대에 레이트 리밋에 걸리는 이유

429 응답은 "요청이 너무 많다"는 뜻입니다. JanitorAI 커뮤니티에서 가장 많이 보고되는 프록시 오류이고, 그 뒤에 있는 패턴은 예측 가능합니다. 무료 또는 공유 프록시는 하나의 API 키가 수백에서 수천 명의 사용자에게 서비스를 제공합니다. 프로바이더는 분당 요청 수와 분당 토큰 수에 대해 키별 한도를 강제하므로, 미국 저녁 시간대 트래픽이 몰리면 모두가 같은 쿼터로 몰려들고 키가 요청을 거절하기 시작합니다. 개인이 특별히 지목당하는 것이 아닙니다. 버킷이 단순히 비어 있는 것이고, 가장 많은 사람이 채팅하고 싶어 하는 바로 그 시간에 가장 느리게 다시 채워집니다. 무료 프록시에는 두 번째 실패 모드도 있습니다: 키 자체가 죽는 것입니다. 공유 키는 정책 위반이나 잔액 소진으로 폐기되고, 이 시점부터 같은 URL은 종종 아무 예고 없이 401이나 404를 반환하기 시작합니다. 유료 엔드포인트는 구조적으로 피크 시간대 벽을 피해갑니다. 본인의 키는 군중과 하나의 버킷을 공유하지 않고 자신만의 쿼터를 가지며, 토큰당 과금이므로 프로바이더가 구독 등급으로 밀어 넣기 위해 스로틀할 이유가 없고, 유료 트래픽을 위한 용량이 별도로 준비되어 있습니다. 개인 유료 키에서 429가 보인다면 거의 항상 짧은 버스트 한도이니, 몇 초 기다렸다가 다시 시도하거나 빠른 연속 재생성을 늦추세요. 개인 키에서 지속되는 429는 우회책이 아니라 지원 티켓을 낼 만한 문제입니다.

JanitorAI 프록시 오류 표: 429, 401, 404, 타임아웃

JanitorAI가 보여주는 코드를 이 표와 대조하세요. 해결법 칸은 위의 curl 테스트로 엔드포인트가 이미 작동한다고 확인했다는 것을 전제로 합니다. curl도 똑같이 실패한다면 문제는 JanitorAI가 아니라 엔드포인트 쪽에 있는 것입니다.

Janitor AI 프록시 뒤에서 어떤 모델을 돌릴지

생성 설정을 아무리 조정해도 모델 선택이 더 중요합니다. 커뮤니티 의견은 안정적입니다: DeepSeek V4 계열은 비용이 더 이상 고려 대상이 아닐 만큼 저렴한 가격에 길고 캐릭터에 충실한 응답을 쓰기 때문에 롤플레이에서 가장 선호됩니다. GLM-5, Kimi K2.6, MiMo는 다른 목소리를 원할 때 돌아가며 써볼 만한 가성비 선택지입니다. Grok 4.5는 xAI가 공개한 정책이 성인 사용자를 대상으로 명백히 허구적인 설정에서 성숙한 주제를 허용하기 때문에 유연한 정책 옵션으로 꼽힙니다. Claude Sonnet 4.6은 카탈로그에서 가장 강한 문장을 쓰고 SFW 크리에이티브 라이팅에 잘 맞습니다. Anthropic 정책이 노골적인 콘텐츠를 금지하므로 스토리 중심의 노골적이지 않은 채팅에 두세요. 아래의 모든 카탈로그 가격은 구독 없는 종량제입니다. 글로벌 모델은 공식 요율보다 20% 저렴하고 중국 모델은 공식 가격보다 낮으며, 첫 충전은 시작 잔액을 두 배로 만들어줍니다.

자주 묻는 질문