Janitor AI에서 DeepSeek를 설정할 때는 먼저 경로를 정해야 합니다. DeepSeek 공식 API로 직접 연결할지, OpenRouter 같은 공급자 프록시를 거칠지 결정한 뒤, Janitor AI에 넣는 프록시 URL, API Key, 모델명을 모두 같은 경로에서 가져와야 합니다. 2026년 5월 9일 기준으로 DeepSeek 직접 경로에서는 deepseek-v4-flash와 deepseek-v4-pro 같은 현재 모델 ID를 확인해야 하며, 오래된 튜토리얼에 남아 있는 deepseek-chat, deepseek-reasoner는 새 설정의 기본값이 아니라 과거 호환명으로 보는 편이 안전합니다.
가장 빠른 순서는 경로 선택, 필드 입력, 짧은 테스트입니다. 첫 테스트가 실패하면 캐릭터 카드, jailbreak, temperature, memory를 바꾸기 전에 오류 계층을 읽어야 합니다. 401은 보통 Key 또는 공급자 불일치, 404는 endpoint 또는 모델명, 429는 quota나 rate limit, network error는 URL, 브라우저, VPN, 확장 프로그램, 캐시 쪽 문제입니다.
빠른 설정 표
DeepSeek 자체가 막힌 것이 아니라 Janitor AI에 넣은 세 값이 섞여 실패하는 경우가 많습니다. OpenRouter endpoint, DeepSeek Key, 오래된 Reddit 모델명을 한 번에 넣으면 같은 API 경로가 아니므로 정상 응답을 기대하기 어렵습니다.
| 경로 | 프록시 URL | API Key 출처 | 모델명 | 언제 쓰나 |
|---|---|---|---|---|
| DeepSeek 공식 직접 연결 | DeepSeek OpenAI 호환 base URL은 https://api.deepseek.com이다. Janitor의 현재 입력란이 전체 proxy URL을 요구하면 해당 UI가 받는 chat-completions 형태를 쓴다. | DeepSeek Platform | DeepSeek 현재 모델 목록에서 확인한 deepseek-v4-flash, deepseek-v4-pro 등 | DeepSeek 공식 계정, 잔액, 모델 경계를 직접 관리하고 싶을 때 |
| OpenRouter 또는 다른 공급자 | OpenRouter endpoint는 https://openrouter.ai/api/v1/chat/completions | 해당 공급자 계정 | 공급자 대시보드에 표시되는 정확한 model slug | 여러 모델, 크레딧, 무료 풀, 라우팅을 공급자에서 관리하고 싶을 때 |
| 오래된 튜토리얼 값 | 예시로만 본다 | 그대로 복사하지 않는다 | deepseek-chat, deepseek-reasoner는 오래된 값일 수 있다 | 기존 설정이 왜 깨졌는지 추적할 때 |
Janitor AI가 base URL과 path를 분리한다면 base URL 칸에 전체 /chat/completions를 넣지 않습니다. 반대로 proxy URL 하나만 받고 전체 OpenAI 호환 endpoint를 요구하는 UI라면 현재 Janitor가 요구하는 전체 형태를 써야 합니다. 핵심은 URL 모양이 아니라 URL, Key, 모델명의 소유자가 같다는 점입니다.
직접 연결과 공급자 프록시의 차이
DeepSeek 직접 연결은 중간 공급자를 줄이고 DeepSeek 공식 계정으로 관리하고 싶을 때 적합합니다. 이 경로에서는 DeepSeek 계정, DeepSeek API Key, DeepSeek endpoint, DeepSeek 모델 ID, DeepSeek 잔액과 과금 규칙이 같은 경계에 있습니다. 문제가 생겨도 어디를 봐야 하는지 비교적 명확합니다.
OpenRouter나 다른 공급자를 쓰면 Janitor AI는 DeepSeek에 바로 보내는 것이 아니라 공급자의 chat-completions endpoint로 보냅니다. 모델 목록, slug, 무료 모델, 제한, 라우팅은 공급자가 정합니다. 따라서 DeepSeek 공식 문서의 이름을 그대로 쓰는 것이 아니라 공급자 화면에 표시된 정확한 slug를 써야 합니다.
두 경로를 섞으면 안 됩니다. DeepSeek Key를 OpenRouter endpoint에 쓰거나 OpenRouter Key를 DeepSeek endpoint에 쓰면 인증 오류가 납니다. 공급자 전용 slug를 DeepSeek 직접 endpoint에 넣으면 invalid model 또는 404가 날 수 있습니다.
Janitor AI에서 입력하는 순서
Janitor AI 공식 proxy 도움말은 UI 흐름을 확인하는 데 유용합니다. 채팅 또는 설정에서 API/Proxy 설정을 열고, configuration을 추가하고, model name, proxy URL, API Key를 입력한 뒤 저장하고 새로고침한 다음 테스트합니다. 다만 해당 예시의 DeepSeek 모델명은 오래되었을 수 있으므로 모델명은 현재 공급자에서 다시 확인해야 합니다.
권장 순서는 다음과 같습니다.
- DeepSeek를 테스트할 Janitor AI 채팅을 엽니다.
- API Settings, Proxy Settings 또는 현재 custom API 설정으로 이동합니다.
- 새 configuration을 추가합니다.
- OpenAI 호환 또는 custom proxy 모드를 선택합니다.
- 선택한 경로의 프록시 URL을 붙여 넣습니다.
- 같은 경로에서 발급한 API Key를 붙여 넣습니다.
- 같은 경로에 표시되는 모델명을 붙여 넣습니다.
- 저장합니다.
- 페이지 또는 채팅을 새로고침합니다.
- 한 문장만 답하게 하는 짧은 테스트를 보냅니다.
짧은 테스트는 roleplay 품질을 평가하기 위한 것이 아닙니다. API 연결 여부를 확인하기 위한 것입니다. 짧은 테스트도 실패한다면 아직 캐릭터 카드나 말투 문제가 아닙니다.
모델명: 현재 ID와 오래된 별칭
2026년 5월 9일 기준으로 DeepSeek 직접 경로에서는 deepseek-v4-flash와 deepseek-v4-pro를 현재 모델 후보로 확인해야 합니다. deepseek-chat과 deepseek-reasoner는 오래된 Janitor AI 글이나 댓글에 남아 있지만, 새 설정에서는 현재 모델 목록을 먼저 보는 것이 맞습니다.
DeepSeek 직접 연결이면 DeepSeek 모델 목록이나 콘솔을 확인합니다. OpenRouter라면 OpenRouter 모델 페이지에서 정확한 slug를 복사합니다. 다른 공급자라면 해당 공급자 대시보드가 기준입니다. namespace, 버전, free suffix가 붙어 있다면 그 문자열까지 포함해야 합니다.
모델명은 어디서나 통하는 공통 이름이 아닙니다. DeepSeek 공식 endpoint에 있는 이름이 OpenRouter에서도 같은 이름으로 존재한다는 보장은 없습니다. 반대로 OpenRouter 화면의 slug가 DeepSeek 직접 endpoint에서 통한다는 보장도 없습니다.
첫 오류 진단하기
한 번에 하나의 계층만 바꿔야 합니다. URL, Key, 모델명, temperature, prompt를 동시에 바꾸면 다음 오류가 무엇을 의미하는지 알 수 없습니다.
| 증상 | 먼저 볼 계층 | 첫 확인 항목 | 멈출 기준 |
|---|---|---|---|
| 401, unauthorized, invalid key | API Key 또는 공급자 불일치 | Key가 endpoint와 같은 경로에서 나왔는지, 공백이나 누락이 있는지 | Key가 통과하기 전에는 모델 설정을 바꾸지 않음 |
| 403, forbidden | 계정 권한, 지역, 플랜 | 잔액, 과금 상태, 모델 접근 권한, allowlist | 공급자 계정에서 모델 호출이 가능한지 먼저 확인 |
| 404, not found | endpoint 또는 model path | Janitor가 base URL을 원하는지 전체 URL을 원하는지, 모델이 그 endpoint에 있는지 | 오래된 별칭을 계속 바꾸지 않음 |
| invalid model | 모델명 | 같은 공급자 대시보드의 정확한 ID를 복사 | 대시보드에 없는 모델은 Janitor에서 쓸 수 없음 |
| 429, quota, rate limit | 잔액, 크레딧, 제한 | balance, credits, free pool, dynamic limit | retry loop를 멈추고 계정 상태 확인 |
| network error, failed to fetch | URL, 브라우저, VPN, 확장 | 새로고침, 확장 끄기, VPN 확인, endpoint 접근성 | endpoint가 안 열리면 Key를 재발급하지 않음 |
| API not ready, 빈 응답 | queue, timeout, session | 저장, 새로고침, max tokens 낮추기, 짧은 테스트 | 짧은 테스트가 되면 생성 설정으로 이동 |
가능하다면 Janitor AI 밖에서 같은 endpoint, key, model로 최소 요청을 보내 봅니다. 밖에서도 실패하면 공급자 계정 문제입니다. 밖에서는 성공하지만 Janitor에서만 실패하면 Janitor의 URL 형태, 모드 선택, 캐시, 입력란을 봅니다.
연결 후에 roleplay 품질 조정
DeepSeek가 짧은 테스트에 답했다면 그때부터 roleplay 품질을 조정합니다. 품질은 temperature, max tokens, context length, memory, character card, example dialogue, Janitor의 messages 구성에 영향을 받습니다.
| 설정 | 시작점 | 이유 |
|---|---|---|
| Temperature | 중간값부터 | 너무 높으면 연결 문제와 문체 문제가 섞임 |
| Max tokens | 첫 테스트는 낮게 | 긴 출력은 비용과 timeout을 늘림 |
| Context와 memory | 작게 시작 | 큰 context는 실패 원인을 늘림 |
| Reroll | 한 계층을 고친 뒤 | 반복 retry는 quota를 소모함 |
| System 또는 jailbreak | 연결 후 추가 | 복잡한 prompt는 연결 테스트에 필요 없음 |
답은 오지만 스타일이 맞지 않으면 이 단계에서 카드, 예시 대화, temperature, context를 조정합니다. 답 자체가 오지 않으면 다시 필드 표와 오류 표로 돌아갑니다.
무료 DeepSeek 경로는 보장이 아니다
커뮤니티에는 무료 DeepSeek 경로가 자주 언급됩니다. 하지만 무료 모델 행은 그 시점의 공급자 정책일 뿐입니다. 중단, 제한, 유료 전환, 공유 quota 소진, slug 변경이 언제든 일어날 수 있습니다.
Janitor AI 채팅은 context가 길어지고 reroll도 많아집니다. 무료 또는 저렴한 경로라도 429, 느린 응답, 빈 응답, timeout이 발생할 수 있습니다. 오래된 무료 튜토리얼을 오늘의 무제한 보장으로 해석하면 안 됩니다.
API Key를 공개 캐릭터 카드, 스크린샷, 공유 프롬프트, preset에 넣지 마세요. Key는 Janitor AI의 비공개 설정란이나 공급자 대시보드에만 있어야 합니다.
자주 묻는 질문
Janitor AI에 어떤 프록시 URL을 넣어야 하나요?
선택한 경로의 URL을 넣습니다. DeepSeek 직접 연결의 base URL은 https://api.deepseek.com입니다. Janitor 현재 UI가 전체 proxy URL을 요구하면 해당 UI가 받는 chat-completions 형태를 사용합니다. OpenRouter는 https://openrouter.ai/api/v1/chat/completions입니다.
모델명은 무엇을 써야 하나요?
DeepSeek 직접 연결이면 DeepSeek 현재 모델 목록을 확인합니다. 2026년 5월 9일 기준으로 deepseek-v4-flash와 deepseek-v4-pro를 확인해야 합니다. OpenRouter 또는 다른 공급자라면 공급자 대시보드의 정확한 slug를 사용합니다.
deepseek-chat이나 deepseek-reasoner를 써도 되나요?
오래된 설정을 이해하는 단서로는 볼 수 있지만, 새 설정의 첫 선택으로는 권장하지 않습니다. 현재 경로의 모델 목록이 기준입니다.
OpenRouter가 꼭 필요한가요?
아닙니다. OpenRouter는 공급자 프록시 중 하나입니다. DeepSeek 공식 직접 연결도 가능하고, 다른 OpenAI 호환 공급자도 가능합니다.
invalid model은 왜 나오나요?
모델명이 선택한 endpoint에 없기 때문입니다. URL과 Key를 가져온 같은 공급자 화면에서 모델명을 복사해야 합니다.
401은 Janitor AI 문제인가요?
대부분 Key 또는 endpoint 불일치입니다. Key 출처, 공백, 만료, endpoint 일치를 먼저 확인하세요.
429는 어떻게 해결하나요?
잔액, credits, rate limit, free pool을 확인합니다. 무료 튜토리얼을 오늘의 사용 가능 보장으로 보지 마세요.
DeepSeek API 모델을 더 확인하려면?
DeepSeek V4 API 가이드를 참고할 수 있습니다. 다만 Janitor AI 설정의 핵심은 URL, Key, 모델명이 같은 경로에 속하는지입니다.