JanitorAI에서 AIHubMix 무료 모델 사용하기: 프록시 설정 및 일반 오류

JanitorAI는 프록시 옵션을 통해 OpenAI 호환 API와 통신할 수 있으며, AIHubMix도 그 중 하나입니다. 전체 설정은 하나의 양식에 입력된 네 가지 값으로 구성됩니다:

이름:       원하는 대로, 예: AIHubMix MiMo
프록시 URL:  https://aihubmix.com/v1/chat/completions
API 키:    귀하의 AIHubMix 키
모델:      xiaomi-mimo-v2.6-pro-free

사용자 정의 프롬프트는 비워두고, 테스트를 누른 후 추가를 클릭하고 페이지를 새로 고치면 됩니다. 그게 전부입니다.

JanitorAI 커뮤니티에서 보고된 대부분의 실패는 이 네 가지 필드 중 하나가 약간 잘못되었거나 무료 계층이 예상보다 빨리 소진되는 경우에서 발생합니다. 이 가이드는 설정을 한 번 설명한 후, 여러분이 볼 가능성이 있는 각 오류와 그에 대한 해결 방법을 다룹니다.

시작하기 전에

세 가지가 필요합니다:

AIHubMix 계정 및 API 키. 가입 후 AIHubMix API 키 페이지에서 키를 생성하세요. 즉시 안전한 곳에 복사해 두세요.
프록시를 허용하는 봇. 프록시는 "프록시 허용"이 표시된 봇과만 작동합니다. 이는 커뮤니티 프록시 가이드에서 설명합니다. 캐릭터 정의가 보이는 봇은 일반적으로 이를 허용합니다.
모델 ID. AIHubMix 무료 모델 목록에서 하나를 선택하고 ID를 정확히 복사하세요. 커뮤니티에서 현재 역할 놀이에 가장 선호되는 모델은 xiaomi-mimo-v2.6-pro-free입니다; 이 시리즈의 모델 가이드에서 옵션을 비교합니다.

첫 번째 메시지를 보내기 전에 알아야 할 한 가지: 새 계정은 총 10회의 시험 호출을 받으며, 모든 무료 모델에서 공유됩니다. $1 이상의 일회성 충전 후 계정은 일일 할당량으로 전환됩니다 (하루 100 요청, 분당 10, 하루 1M 토큰). 이 시리즈의 한도 가이드에서는 긴 채팅에서 얼마나 사용할 수 있는지 설명합니다.

네 가지 값과 사람들이 실수하는 부분

필드	입력할 내용	일반적인 실수
이름	원하는 레이블	없음, 그냥 당신을 위한 것입니다
프록시 URL	전체 채팅 완료 URL	기본 URL만 붙여넣기
API 키	귀하의 AIHubMix 키	다른 제공자의 키
모델	정확한 모델 ID	표시 이름을 대신 사용

모델 ID는 모델 필드에 입력합니다. 소문자로 입력하며 -free 접미사를 유지합니다. "Xiaomi Mimo V2.6 Pro (free)"는 표시 이름이며 작동하지 않습니다; xiaomi-mimo-v2.6-pro-free는 작동합니다.

프록시 URL 레이블 옆에는 추가 /chat/completions 버튼이 있습니다. 이 버튼은 필드에 이미 있는 내용 뒤에 /chat/completions를 추가합니다. 위에 전체 URL을 붙여넣었다면 클릭하지 마세요, 그렇지 않으면 경로가 두 번 입력됩니다. https://aihubmix.com/v1를 붙여넣었다면 한 번 클릭하면 완성됩니다.

API 키 필드에는 "(선택 사항)"이라고 표시됩니다. 어쨌든 입력하세요: 키가 없으면 모든 요청이 거부됩니다.

사용자 정의 프롬프트는 이 프록시에 대한 시스템 프롬프트를 재정의하며 프록시가 활성화된 동안 모든 요청의 상단에 전송됩니다. AIHubMix는 필요하지 않으므로 비워두세요.

JanitorAI에서 설정하기

JanitorAI는 2026년 7월 19일에 채팅 설정을 재설계했으므로 이전 비디오에서는 다른 화면이 표시됩니다. 아래 단계는 2026년 10월 현재 웹 버전과 확인되었습니다:

프록시 허용 봇과 채팅을 엽니다.
오른쪽 상단의 메뉴를 열고 설정을 선택합니다.
제공자 아래에서 프록시를 선택합니다.
프록시 구성 아래에서 + 새로 만들기를 클릭합니다.
새 구성 양식에서 위의 값으로 이름, 프록시 URL, API 키 및 모델을 입력합니다. 사용자 정의 프롬프트는 비워둡니다.
테스트를 클릭합니다. 설정이 작동하면 아무 메시지도 나타나지 않으며, 문제가 있을 때만 메시지가 나타납니다.
추가를 클릭한 후 페이지를 새로 고치거나 채팅을 다시 시작합니다.

7단계에서의 새로 고침은 사람들이 가장 많이 건너뛰는 단계입니다. 페이지가 다시 로드될 때까지 JanitorAI는 이전 설정을 통해 메시지를 계속 보낼 수 있습니다.

여러 구성을 저장할 수 있으며, 예를 들어 모델별로 하나씩 저장하면 하나의 모델이 바쁠 때 빠르게 전환할 수 있습니다. 백업을 추가하려면 저장된 구성을 열고 복제를 클릭한 후 모델 필드만 변경합니다.

첫 번째 채팅을 위한 설정

메뉴를 열고 → 설정을 다시 열어 생성 제어를 확인합니다. 첫 실행에 중요한 두 가지가 있습니다. Arcanum RPGs의 현재 패널 안내서에 따르면:

컨텍스트 크기. 외부 모델을 사용할 경우 슬라이더는 128,000 토큰까지 올라갑니다. 16,000에서 32,000 사이에서 시작하세요. JanitorAI의 툴팁은 응답 생성이 실패할 경우 줄이라고 합니다.
최대 토큰. 0은 모델이 응답 길이를 선택하게 합니다. 다른 숫자는 하드 스톱이므로 낮은 값은 응답을 중간에 잘라낼 수 있습니다.

저장을 누르세요; 아무것도 적용되지 않습니다.

컨텍스트 크기는 품질 이상으로 중요합니다. 매 턴마다 전체 컨텍스트를 다시 전송하며, 모든 무료 모델은 하루에 1M 토큰의 하나의 풀을 공유합니다. 채팅이 32,000 토큰의 컨텍스트를 채우면, 그 풀은 대략 30개의 응답을 커버하며, 100 요청 한도 이하입니다. 이 시리즈의 한도 가이드는 숫자를 통해 설명합니다.

선택 사항: JanitorAI 외부에서 키 테스트하기

터미널에 익숙하다면 이 요청은 "내 키가 잘못되었다"와 "내 JanitorAI 설정이 잘못되었다"를 구분합니다. 이는 AIHubMix 빠른 시작 문서와 동일한 엔드포인트를 사용하며, 요청 하나를 소모합니다 (충전하지 않았다면 10회의 시험 호출 중 하나입니다).

export AIHUBMIX_API_KEY="paste-your-key-here"

curl https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "xiaomi-mimo-v2.6-pro-free", "messages": [{"role": "user", "content": "Say hello in five words."}]}'

텍스트가 포함된 응답이 오면 키와 모델 ID가 정상이며, 문제는 JanitorAI의 필드나 누락된 새로 고침에 있습니다.

일반 오류 및 수정 방법

"네트워크 오류" 또는 "가져오기 실패"

테스트에서 "네트워크 오류. 나중에 다시 시도하세요!" 또는 채팅에서 "네트워크 오류가 발생했습니다. 속도 제한이 있거나 연결 문제일 수 있습니다: 가져오기 실패"라는 메시지가 표시됩니다.

이유: 요청이 AIHubMix에 도달하지 않았거나 응답이 브라우저로 돌아오지 않았습니다. 문구와는 달리 "가져오기 실패"는 연결 문제를 나타내며, 할당량 문제가 아닙니다. 일반적인 원인은 aihubmix.com을 차단하거나 잘못 라우팅하는 VPN 또는 프록시입니다; 요청을 필터링하는 브라우저 확장도 같은 문제를 일으킬 수 있습니다. AIHubMix의 이 가이드 테스트에서 VPN이 원인이었습니다.
수정: VPN을 끄거나 다른 서버로 전환하거나 aihubmix.com을 통과하도록 설정하세요. janitorai.com에서 광고 차단기 또는 개인 정보 보호 확장을 일시 중지하세요. 그런 다음 다시 테스트를 누르세요.

테스트에서 오류가 표시되거나 봇이 응답하지 않음

이유: 프록시 URL이 불완전하거나 (기본 URL 또는 홈페이지만), 오타가 있거나, 전체 URL을 붙여넣은 후 추가 /chat/completions 버튼을 클릭하여 /chat/completions가 두 번 끝나는 경우입니다. AIHubMix는 잘못된 경로에 대해 "요청한 API 엔드포인트가 존재하지 않습니다."라는 응답을 합니다.
수정: https://aihubmix.com/v1/chat/completions를 정확히 붙여넣고, 후행 공백이 없도록 하세요.

"모델을 찾을 수 없음" 또는 모델 오류

이유: 모델 필드에 표시 이름이 들어가 있거나, 대문자가 포함되어 있거나, -free 접미사가 누락된 경우입니다.
수정: 무료 모델 목록에서 ID를 다시 복사하고 그대로 붙여넣으세요.

"유효하지 않은 키" 또는 인증 오류

이유: 키가 다른 서비스에 속하거나 삭제되었거나, 공백이 포함되어 있거나, 필드가 비어 있는 경우입니다. AIHubMix는 비어 있는 키에 대해 "제공된 키가 없습니다"라는 응답을 하고, 잘못된 키에 대해서는 "유효하지 않은 키"라고 응답합니다.
수정: AIHubMix 키 페이지에서 새 키를 생성하고 다시 붙여넣으세요.

설정을 변경했지만 아무것도 변경되지 않음

이유: JanitorAI가 이전에 로드한 구성을 여전히 사용하고 있습니다.
수정: 페이지를 새로 고치거나 채팅을 다시 시작하고, 올바른 구성이 선택되었는지 확인하세요.

봇의 "응답"이 시험이 소진되었다는 알림

이유: 10회의 시험 호출이 소진되었습니다. AIHubMix는 오류 대신 알림으로 응답하므로, JanitorAI에서는 채팅에서 메시지로 표시될 가능성이 높습니다.
수정: $1 이상 충전하세요; 계정이 무료 모델에 대한 일일 할당량으로 전환됩니다. 이 시리즈의 충전 가이드에서 단계를 다룹니다.

오류 429

429 오류에는 두 가지 일반적인 원인이 있습니다:

한도 초과. 분당 또는 일일 한도를 초과하면 API는 다음 분 또는 하루가 시작될 때까지 429를 반환합니다. 일부 모델은 표준 100회/일 및 10회/분보다 낮은 한도를 가집니다 (예: qwen3.6-plus-preview-free는 하루 50회 및 분당 5회를 허용)이며, 공유 1M 토큰 풀은 긴 채팅에서 먼저 소진될 수 있습니다.
모델이 바쁨. 일부 모델의 무료 용량은 제한되어 있으며, AIHubMix 변경 로그에서는 이러한 이유로 무료 모델에서 429 오류가 "발생할 수 있다"고 경고했습니다. 많은 사람들이 동시에 하나의 인기 모델에 몰리면 일반적인 원인이 됩니다.

수정: 1분 기다렸다가 다시 시도하거나, 메시지를 덜 자주 보내거나, 다른 모델이 있는 두 번째 저장된 구성으로 전환하세요. 일일 한도가 문제라면, 할당량은 하루에 한 번 초기화됩니다.

모델이 retired라는 언급이 있는 404 오류

이유: 모델이 제거되었습니다. 2026년 9월 1일부터, 퇴역 모델은 명시적인 model_retired 404를 반환합니다.
수정: 무료 목록에서 다른 모델을 선택하고 모델 필드를 업데이트하세요.

유료 모델을 사용한 후 무료 모델이 작동하지 않음

이유: 계정 잔액이 -$1 이하로 떨어지면, 무료 모델을 호출할 수 없습니다. 계정이 다시 충전될 때까지 기다려야 합니다.
수정: 잔액을 그 선 이상으로 되돌리기 위해 충전하세요.

아직도 문제가 있나요?

AIHubMix 연락처 페이지에는 공식 Discord 서버, 지원 이메일 (feedback@aihubmix.com), 및 상태 페이지가 나와 있습니다. 상태 페이지는 Chat Completions와 같은 서비스를 추적하며, 개별 모델은 추적하지 않으므로 바쁜 모델은 거기에서 나타나지 않습니다.

빠른 답변을 받으려면 다음을 포함하세요:

요청 시간 및 귀하의 시간대
모델 ID 및 엔드포인트 (프록시 URL)
HTTP 상태 또는 오류 텍스트, 표시된 경우 추적 ID
예상했던 것과 실제로 발생한 것

API 키는 제외하세요. 지원팀은 필요하지 않으며, 이를 가진 사람은 귀하의 할당량을 사용할 수 있습니다.

자주 묻는 질문

AIHubMix는 JanitorAI에서 무료로 사용할 수 있나요?
모든 새 계정은 모든 무료 모델에서 10회의 시험 호출을 받습니다. $1 이상의 일회성 충전 후 무료 모델은 일일 할당량으로 전환됩니다: 하루 100 요청, 분당 10, 하루 1M 토큰이 공유됩니다.

프록시 URL 필드에는 정확히 무엇을 입력해야 하나요?
https://aihubmix.com/v1/chat/completions, 전체 주소입니다. https://aihubmix.com/v1만 붙여넣었다면, 한 번 추가 /chat/completions 버튼을 클릭하여 완성하세요.

왜 일부 봇에서 프록시 옵션이 보이지 않나요?
"프록시 허용"으로 표시된 봇만 프록시와 함께 작동합니다. 다른 봇은 JanitorAI의 자체 모델을 사용합니다.

어떤 모델 ID로 시작해야 하나요?
무료 모델 목록에서 정확히 복사된 모든 ID가 작동합니다. 많은 JanitorAI 사용자들이 xiaomi-mimo-v2.6-pro-free로 시작하며, 이 시리즈의 모델 가이드에서 대안을 비교합니다.

모델을 변경한 후 새로 고쳐야 하나요?
예. 구성을 저장한 후 페이지를 새로 고치거나 채팅을 다시 시작하여 JanitorAI가 변경 사항을 반영하도록 하세요.

왜 계속 429 오류가 발생하나요?
분당 또는 일일 한도를 초과했거나 모델이 바쁩니다. 1분 기다렸다가 다시 시도하거나, 속도를 줄이거나, 다른 모델이 있는 저장된 구성으로 전환하세요.

API 키를 친구와 공유할 수 있나요?
아니요. 서비스 약관에서는 AIHubMix 계정 공유를 금지하며, 귀하의 키를 사용하는 모든 사람은 귀하의 일일 할당량을 소모합니다.

계속 읽기: JanitorAI를 위한 AIHubMix 시리즈

설정이 작동하지만 실제로 하루에 몇 개의 메시지를 받을 수 있나요? 토큰 수학은 여기에서 확인하세요: AIHubMix 무료 모델 한도: 10회의 시험 호출, $1 잠금 해제 및 토큰 한도
시험 알림이 이미 채팅에 표시되었다면, 일일 할당량 잠금을 해제하는 방법을 안내합니다: Alipay로 AIHubMix 결제하는 방법
붙여넣은 모델 ID가 역할 놀이에 적합한지 확신이 없으신가요? 무료 옵션을 비교하세요: JanitorAI 역할 놀이에 사용할 AIHubMix 무료 모델
첫 긴 채팅 전에 제로 데이터 보존이 귀하의 메시지가 AIHubMix에 저장되지 않도록 하는 방법을 확인하세요: AIHubMix는 JanitorAI 역할 놀이 채팅을 지원하며 기본적으로 제로 데이터 보존을 제공합니다

출처

무료 AI 모델 (AIHubMix)
빠른 시작 (AIHubMix 문서)
변경 로그 (AIHubMix 문서)
custom-proxy-for-janitorai (GitHub)
Janitor AI 생성 설정 (2026) (Arcanum RPGs)