유효한 DeepSeek API 키를 넣었는데도 Janitor AI에서 네트워크 오류가 난다면, API 키·엔드포인트·모델 ID의 제공업체가 서로 다른 경우가 많습니다. DeepSeek 직접 연결이라면 세 항목을 모두 하나의 DeepSeek 계정 기준으로 맞추고, 전체 chat-completions URL을 입력하세요. 필요하면 Janitor AI를 새로고침한 뒤 생성 옵션을 건드리기 전에 짧은 메시지부터 테스트하는 편이 좋습니다.
API 키를 만들기 전, 연결 경로부터 하나로 정하세요
Janitor AI는 대화 인터페이스이고, 실제 모델 응답은 API로 연결된 DeepSeek가 제공합니다. 여기서 말하는 ‘프록시’는 IP 프록시나 VPN이 아니라 LLM 요청이 지나가는 연결 경로를 뜻합니다. 이 차이와 보안상 고려할 점은 Janitor AI 프록시 가이드에서 더 자세히 확인할 수 있습니다.
핵심 원칙은 간단합니다. API 키, 엔드포인트, 모델명은 반드시 같은 제공업체 경로의 것이어야 합니다. 두 서비스 모두 OpenAI 호환 API를 제공하더라도, DeepSeek 키와 OpenRouter URL을 조합하면 DeepSeek 직접 연결이 되지 않습니다.
DeepSeek 직접 연결·AIReiter·OpenRouter, 무엇을 골라야 할까?
| 연결 경로 | 만들 API 키 | 엔드포인트 및 모델 | 적합한 경우 |
|---|---|---|---|
| DeepSeek 직접 연결 | DeepSeek API 키 | DeepSeek 엔드포인트 + deepseek-v4-flash 또는 deepseek-v4-pro | 공식 청구 체계와 가장 짧은 제공업체 연결 경로가 필요할 때 |
| AIReiter DeepSeek V4 Flash | AIReiter API 키 | AIReiter의 현재 호환 API 경로 + deepseek-v4-flash | AIReiter 관리형 액세스와 종량제 모델 사용을 원할 때 |
| OpenRouter | OpenRouter API 키 | OpenRouter 엔드포인트 + 현재 카탈로그 ID | 여러 모델 제공업체를 오가며 쓰고 싶을 때 |
이 글은 현재 DeepSeek API 문서와 가장 쉽게 대조할 수 있는 DeepSeek 직접 연결 방식을 기준으로 설명합니다. AIReiter는 별도의 제공업체 경로이므로 AIReiter 키는 AIReiter 엔드포인트에서만 사용해야 합니다. Janitor AI 프록시 입력칸이 포괄하는 의미는 Janitor AI 프록시 설정 가이드를 참고하세요.
커뮤니티 사례를 보면 오류 문구만으로는 원인을 판단하기 어렵습니다.
“network error” — u/dailylittlebrat, r/JanitorAI_Official
이 문구는 진단 결과가 아니라 증상으로 봐야 합니다. 제공업체 경로 혼용, 오래된 모델 ID, 잔액 부족, 설정 미적용 모두 같은 결과를 낼 수 있습니다.
DeepSeek 직접 연결 시 입력할 설정값
새로 직접 연결할 때는 아래 값을 기준으로 시작하면 됩니다. DeepSeek의 현재 빠른 시작 문서에는 OpenAI 호환 기본 URL로 https://api.deepseek.com가 안내되어 있으며, 전체 요청 엔드포인트는 /chat/completions로 제시됩니다. Janitor AI가 입력한 URL을 그대로 요청에 사용한다면 전체 URL을 넣으세요. 반대로 사용 중인 커넥터가 경로를 자동으로 덧붙인다고 명시한다면 해당 커넥터의 base URL 형식을 따르면 됩니다.
| Janitor AI 항목 | DeepSeek 직접 연결 값 |
|---|---|
| Configuration Name | DeepSeek Direct |
| Model Name | deepseek-v4-flash |
| Proxy URL | 전체 엔드포인트를 요구하는 필드라면 https://api.deepseek.com/chat/completions |
| API Key | platform.deepseek.com에서 발급한 본인 키 |
상위 티어 모델을 원하는 경우에는 deepseek-v4-pro를 사용하세요. DeepSeek의 현재 Models & Pricing 페이지에서는 토큰 요금 기준으로 Flash가 Pro보다 낮게 책정되어 있고, 두 모델 모두 같은 API 계열로 이용할 수 있습니다. deepseek-v4-flash-vision-exp도 제공되지만, Janitor AI의 텍스트 채팅 설정은 실험적 비전 모델보다 Flash 또는 Pro부터 시작하는 것이 적절합니다.
오래된 튜토리얼에는 deepseek-chat이나 deepseek-reasoner를 입력하라고 나올 수 있습니다. 이전 별칭이 여전히 작동한다고 가정하지 말고, DeepSeek 실시간 문서에 나오는 현재 V4 ID를 사용하세요.
Janitor AI를 열기 전에 준비할 것
platform.deepseek.com의 DeepSeek Platform 계정- 새로 발급한 DeepSeek API 키
- 사용 가능한 계정 잔액. DeepSeek 오류 문서에서 HTTP
402는 잔액 부족을 의미합니다. - Janitor AI 인터페이스에 해당 옵션이 있다면 외부 프록시 사용을 허용하는 캐릭터 또는 계정 설정
- 연결을 설정하는 동안 API 키를 안전하게 보관할 장소
DeepSeek 채팅 웹사이트용 일반 로그인 계정은 API 키가 아닙니다. 개발자 플랫폼에서 키를 발급하고, 앞뒤 공백 없이 복사하세요. 키가 노출됐을 때 예상치 못한 큰 비용이 생기지 않도록 처음에는 적은 잔액으로 시작하는 편이 안전합니다.
추측 없이 Janitor AI에 DeepSeek 연결하기
순서는 API 키 발급, 엔드포인트와 모델 입력, 저장, 필요 시 새로고침, 짧은 테스트 메시지 전송입니다.
DeepSeek API 계정 생성 및 잔액 충전
- DeepSeek Platform을 엽니다.
- 개발자 계정을 만들거나 로그인합니다.
- API 키 메뉴에서 Janitor AI용 키를 생성합니다.
- 키는 즉시 복사하고 외부에 노출되지 않게 보관합니다.
- 간단한 테스트에 충분한 잔액을 충전합니다.
DeepSeek API는 Janitor AI 메시지 수만으로 과금되는 방식이 아니라 토큰 사용량을 기준으로 청구합니다. 긴 캐릭터 카드와 많이 누적된 대화 기록은 매 턴마다 많은 입력 토큰을 보낼 수 있습니다. 따라서 DeepSeek라고 해서 무제한 무료 API라고 생각하기보다, 처음에는 적은 잔액으로 시작하는 편이 낫습니다.
프록시 설정 추가하기
- Janitor AI에서 캐릭터 채팅을 엽니다.
- API Settings 또는 현재 버전에서 이에 해당하는 메뉴를 찾습니다.
- 사용 가능한 Proxy, Custom 또는 OpenAI 호환 제공업체 옵션을 선택합니다.
- 화면에 Add Configuration이 있다면 새 설정을 만듭니다.
- 설정 이름에는
DeepSeek Direct를 입력합니다. - 모델 입력칸에
deepseek-v4-flash를 붙여넣습니다. - 전체 엔드포인트를 요구하는 Proxy URL 필드에는
https://api.deepseek.com/chat/completions를 붙여넣습니다. - 키 입력칸에 DeepSeek API 키를 붙여넣습니다.
- 설정을 저장하고 활성 연결 경로로 선택합니다.
Janitor AI 입력칸이 최종 요청 엔드포인트를 요구한다면 https://api.deepseek.com만 넣어서는 안 됩니다. 현재 커넥터 문서에서 /chat/completions 경로를 자동 추가한다고 안내한다면 그때는 base URL 형식을 사용하세요.
저장 후 새로고침하고 짧게 테스트
새 설정이 적용되지 않은 것처럼 보이면 테스트 전에 Janitor AI 탭을 새로고침하거나 다시 여세요. 프롬프트는 “연결을 확인하는 한 문장으로 답변해.”처럼 짧게 입력하면 됩니다.
짧은 응답이 돌아오면 인증, 모델 확인, 기본적인 완료 요청은 정상이라는 뜻입니다. 다만 모든 캐릭터 설정이나 컨텍스트 설정까지 검증된 것은 아닙니다.
테스트에 실패했다고 즉시 온도, 최대 토큰 등 생성 옵션부터 바꾸지는 마세요. 먼저 제공업체 경로, 엔드포인트, 모델 ID, API 키, 잔액, 프록시 사용 허용 설정을 확인해야 합니다.
오류는 처음 막힌 단계부터 확인하세요
문제가 발생한 첫 지점을 분리하면 훨씬 빨리 해결할 수 있습니다. DeepSeek API 키와 잔액을 먼저 확인하고, 그다음 Janitor AI 입력값을 점검하세요. 브라우저 상태나 제공업체 가용성은 그 이후에 살펴보는 순서가 효율적입니다.
| 오류 또는 증상 | 가능성이 높은 단계 | 가장 먼저 할 일 |
|---|---|---|
401 Unauthorized | 인증 | 새 DeepSeek 키를 발급하거나 다시 복사하고, 공백이 없는지와 DeepSeek 키가 맞는지 확인합니다. |
402 또는 잔액 부족 | 계정 결제 | 해당 키가 연결된 DeepSeek 계정에 잔액을 충전합니다. |
404 또는 모델을 찾을 수 없음 | 엔드포인트 또는 모델 ID | 전체 URL과 모델명을 DeepSeek의 최신 문서와 정확히 대조합니다. |
429 Too Many Requests | 제공업체 속도 제한 | 연속 재시도를 멈추고 기다린 뒤 요청 빈도를 낮추며, 제공업체 제한을 확인합니다. |
| 네트워크 오류 또는 “failed to fetch” | URL, 브라우저, 권한 또는 연결 가능 여부 | 전체 HTTPS 엔드포인트를 다시 확인하고 Janitor AI를 새로고침한 다음 프록시 사용 허용 설정을 점검합니다. |
500 또는 503 | 제공업체 측 가용성 | 잠시 기다렸다가 나중에 재시도합니다. 반복 재시도는 속도 제한을 더 악화시킬 수 있습니다. |
| 빈 응답 또는 중간에 끊긴 답변 | 생성 또는 컨텍스트 처리 | 인증 정보와 연결 경로를 확인한 뒤, 더 짧은 대화에서 테스트하고 출력 제한을 적절히 조정합니다. |
DeepSeek 공식 오류 문서는 인증(401), 잔액(402), 속도 제한(429), 내부 오류(500), 서버 혼잡(503)을 구분합니다. 이 구분은 중요합니다. API 키를 바꿔도 429는 해결되지 않으며, IP를 바꾼다고 402 계정에 잔액이 추가되지는 않습니다.
제공업체 문제와 Janitor AI 설정 문제를 분리하려면, 동일한 제공업체 값을 DeepSeek 문서의 빠른 시작 클라이언트에서 먼저 테스트하세요. 단, 실제 API 키는 절대 공개적으로 붙여넣지 마세요.
Janitor AI에서 DeepSeek 사용: 자주 묻는 질문
API 키 없이 Janitor AI에서 DeepSeek를 쓸 수 있나요?
직접 API 연결 방식으로는 불가능합니다. Janitor AI의 사용자 지정 프록시 연결에는 선택한 제공업체 경로의 인증 정보가 필요하며, DeepSeek 일반 채팅 계정은 DeepSeek Platform API 키를 대신할 수 없습니다.
Janitor AI에서 DeepSeek는 무료인가요?
DeepSeek 직접 API는 무제한 무료 채팅이 아니라 사용량 기반 API로 생각해야 합니다. DeepSeek의 요금 페이지에는 토큰당 요금이 안내되어 있고, 오류 문서에도 잔액 부족 응답이 포함되어 있습니다. OpenRouter의 무료 경로에는 별도 제한이 적용됩니다.
VPN이나 IP 프록시로 429 오류를 해결할 수 있나요?
대개는 어렵습니다. 429는 제공업체의 요청 속도 제한이므로 IP 주소 변경보다 기다리기, 요청 횟수 줄이기, API 연결 경로 변경, 계정 제한 확인이 더 관련 있는 조치입니다.
API 키, 엔드포인트, 모델 ID는 하나의 제공업체 경로에서만 가져오세요. 이후 Janitor AI를 새로고침하고 짧은 메시지로 테스트한 다음 생성 옵션을 조정하면 됩니다.