Jiminbox 문제 해결 가이드
로그인, New API Key, 모델 연결과 서비스 접속 문제를 순서대로 점검하는 방법을 안내합니다.
서비스가 열리지 않음
- jiminbox.com의 서비스 메뉴에서 다시 엽니다.
- 가입한 플랜에 포함된 서비스인지 확인합니다.
- 개인 컨테이너가 처음 만들어지는 중이라면 잠시 기다렸다가 새로 고침합니다.
- 다른 브라우저 창이나 시크릿 모드에서도 같은지 확인합니다.
개인별 주소는 직접 입력하기보다 서비스 포털에서 여는 편이 안전합니다.
로그인이 반복됨
- 브라우저에서 쿠키가 차단되어 있지 않은지 확인합니다.
- Jiminbox와 Authentik 로그인 탭을 모두 닫은 뒤 서비스 포털에서 다시 엽니다.
- 비밀번호를 여러 번 시도하지 말고, 계정 재설정이 필요하면 운영자에게 문의합니다.
API 요청이 인증 오류로 실패함
- 앱에 입력한 API 주소가
https://api.jiminbox.com/v1인지 확인합니다. - 키 앞뒤에 공백이나 따옴표가 들어가지 않았는지 확인합니다.
- New API의 API Keys에서 해당 키가 남아 있는지 확인합니다.
- 키 노출이 의심되면 기존 키를 삭제하고 새 키를 만듭니다.
키를 새로 만드는 방법은 New API Key와 사용량 가이드에서 안내합니다.
모델을 찾을 수 없음
- New API 모델 목록에서 현재 모델 ID를 확인합니다.
- 앱 설정의 철자와 대소문자가 같은지 확인합니다.
- 현재 플랜에서 사용할 수 있는 모델인지 확인합니다.
- 공급 상황에 따라 모델 구성이 바뀌었는지 공지를 확인합니다.
한도 초과 또는 응답 지연
- New API의 Wallet, Dashboard와 Usage Logs에서 잔여 한도와 최근 요청을 확인합니다.
- 5시간 사용 한도가 갱신될 때까지 기다립니다.
- 자동화나 프로그램이 요청을 반복하고 있지 않은지 확인합니다.
- 필요하지 않은 앱의 API 키를 삭제해 추가 요청을 막습니다.
앱 설정이 반영되지 않음
- 앱을 완전히 종료한 뒤 다시 실행합니다.
- 설정 파일 이름과 저장 위치를 확인합니다.
- JSON을 사용하는 경우 쉼표, 따옴표와 중괄호가 빠지지 않았는지 확인합니다.
- 먼저 짧고 단순한 요청으로 연결을 시험합니다.
앱별 설정은 opencode 설치 가이드, claude desktop 설치 가이드와 RisuAI 이용 가이드에서 안내합니다.
운영자에게 문의할 때
다음 정보만 전달하면 문제를 확인하기 쉽습니다.
- 문제가 발생한 서비스와 시각
- 사용한 기기, 운영체제와 브라우저 또는 앱 이름
- 수행하려던 작업
- 개인정보와 인증정보를 가린 오류 화면
- API 요청 문제라면 모델 이름과 오류 문구
API 키 전체, 비밀번호, VPN 설정 파일, 일회용 인증번호와 민감한 대화 내용은 보내지 마세요.
운영 중 변경과 이용 제한 기준은 Jiminbox 사용 정책에서 안내합니다.