RisuAI 이용 가이드
RisuAI는 AI 캐릭터의 설정과 프롬프트, 대화 기록을 관리하는 웹·데스크톱·모바일용 채팅 인터페이스입니다.
이 문서는 초보자가 jiminbox.com에서 RisuAI를 열고, New API Key와 사용량 가이드에서 만든 New API Key로 모델 프리셋을 등록한 뒤 첫 대화를 시작하는 과정을 안내합니다. 연결할 API 제공자와 모델을 바꾸어 사용할 수 있지만, 처음에는 연결에 필요한 항목만 설정하고 고급 생성 옵션은 기본값으로 두는 편이 좋습니다.
소악마 프롬프트를 사용하는 방법은 RisuAI 소악마 프롬프트 가이드에서 따로 안내합니다. 이 문서에서는 해당 프롬프트의 상세 내용을 중복해서 다루지 않습니다.
화면 이름은 버전에 따라 다를 수 있습니다
RisuAI는 업데이트에 따라 메뉴 위치와 버튼 이름이 달라질 수 있습니다. 이 문서의 모델 프리셋, OpenAI 호환 API, 저장/적용은 연결 설정의 주요 항목과 단계를 설명할 때 쓰는 대표 표현입니다. 화면에 비슷한 이름의 항목이 보이면 API 제공자, 주소, 키, 모델을 입력하는 설정인지 확인합니다.
먼저 준비할 것
- Jiminbox 계정으로 jiminbox.com에 로그인할 수 있어야 합니다.
- New API Key와 사용량 가이드를 따라 New API에서 사용할 API 키를 하나 만듭니다.
- New API의 현재 모델 목록에서 내 계정으로 사용할 모델 ID를 확인합니다.
- API 키를 복사할 수 있는 안전한 장소를 준비합니다. 키는 이 문서, 채팅, 게시글과 화면 캡처에 적지 않습니다.
API 키는 비밀번호와 같습니다
API 키는 RisuAI 설정에만 직접 입력하세요. 운영자나 다른 사람에게 키 값을 보내지 말고, 문제가 생겼을 때는 키 대신 오류 문구와 발생 시각만 전달합니다. 키가 노출되었다고 의심되면 New API의 API Keys에서 해당 키를 삭제하고 새 키를 만드세요.
접속하기
- jiminbox.com에 로그인합니다.
- 왼쪽 사이드바의 서비스를 누릅니다.
- RisuAI를 누릅니다.
- Authentik 화면이 나타나면 Jiminbox 통합 계정으로 로그인합니다.
RisuAI에 별도 앱 비밀번호가 설정되어 있으면 다음 잠금 화면이 한 번 더 나타날 수 있습니다.
앱 비밀번호를 공유하지 마세요
앱 비밀번호는 Authentik 비밀번호와 별도로 동작할 수 있습니다. 여러 번 추측하지 말고 운영자에게 재설정을 요청하세요. 문의할 때 비밀번호 자체를 보내지 마세요.
RisuAI에서 자주 보는 말
처음에는 다음 정도만 알아도 대화를 시작할 수 있습니다.
| 표현 | 뜻 |
|---|---|
| 캐릭터(character) | 말투, 성격, 배경과 첫 인사 등이 들어 있는 대화 상대입니다. 공유 파일이나 링크로 배포될 때는 캐릭터 카드라고도 합니다. |
| 페르소나(persona) | 캐릭터가 대화하는 상대인 나를 설명하는 설정입니다. 처음에는 비워 두거나 짧게 작성해도 됩니다. |
| 모델 프리셋 | API 제공자, API 주소, 키, 모델과 생성 옵션을 묶어 저장하는 설정입니다. 저장한 프리셋을 바꾸면 같은 캐릭터에서도 연결 대상을 바꿀 수 있습니다. |
| 모델 ID | New API가 모델을 구분하는 정확한 문자열입니다. 화면에 보이는 이름이 아니라 목록에 표시된 ID를 사용해야 할 수 있습니다. |
| API 키 | RisuAI가 New API에 요청을 보낼 때 사용하는 비밀 인증 문자열입니다. 대화 내용이 아니라 연결 권한을 나타냅니다. |
캐릭터 카드, 페르소나, 프리셋, 로어북과 같은 표현은 RisuAI 및 AI 캐릭터 커뮤니티에서 함께 쓰이지만, 파일 형식이나 기능은 배포자와 RisuAI 버전에 따라 다를 수 있습니다. 처음 연결할 때는 캐릭터 설정을 크게 바꾸지 않고, 먼저 짧은 대화가 되는지 확인합니다.
설정 열기
- RisuAI 화면 왼쪽 위의 메뉴 버튼을 누릅니다.
- 펼쳐진 사이드바에서 톱니바퀴 모양의 설정 버튼을 누릅니다.
- AI 연결 설정에서 모델 프리셋을 엽니다.
현재 화면에 채팅 봇 또는 비슷한 이전 방식의 설정이 함께 보일 수 있습니다. 새 연결을 만들거나 변경할 때는 API 주소, API 키와 모델을 한 곳에서 관리하는 모델 프리셋을 먼저 사용합니다. 버튼 이름이나 메뉴 위치가 다르면 API 제공자와 연결 정보를 관리하는 설정 화면을 찾습니다.
설정에는 프롬프트, 페르소나, 디스플레이, 언어, 접근성, 모듈, 플러그인, 데이터 이전, 단축키와 고급 설정도 포함될 수 있습니다. 이번 연결에서는 필요한 항목만 바꾸고, 의미를 모르는 항목은 기본값을 유지합니다.
New API Key로 모델 프리셋 등록하기
1. New API에서 키와 모델을 준비합니다
- New API Key와 사용량 가이드를 열고 New API에 접속합니다.
- API Keys에서 RisuAI 전용 키를 만듭니다. 키 이름에는 앱과 기기를 알아볼 수 있는 설명만 적습니다. 실제 키 값이나 개인 정보는 문서에 남기지 않습니다.
- 키가 생성된 직후 표시되는 값을 안전한 곳에 임시로 복사합니다. 키를 다시 볼 수 없는 화면이라면, 잃어버렸을 때 새 키를 발급해야 합니다.
- New API 모델 목록에서 현재 계정과 플랜으로 사용할 수 있는 정확한 모델 ID를 복사합니다.
모델 목록은 공급 상황과 운영 설정에 따라 바뀔 수 있습니다. 기억하고 있는 모델 이름을 그대로 입력하지 않고, 연결하는 날 New API 목록의 값을 사용합니다.
2. 새 프리셋을 만듭니다
- RisuAI의 모델 프리셋 화면에서 새로 만들기, 추가,
+또는 이와 비슷한 버튼을 누릅니다. - 프리셋 이름을 입력합니다. 예를 들어
Jiminbox RisuAI처럼 앱과 제공자를 알아볼 수 있게 적습니다. - API 제공자 목록에서 OpenAI 호환, OpenAI Compatible 또는 비슷하게 표시된 항목을 선택합니다.
OpenAI와OpenAI 호환이 함께 보일 때RisuAI 버전에 따라 같은 기능이
OpenAI,OpenAI Compatible,Custom OpenAI또는 다른 이름으로 표시될 수 있습니다. Jiminbox New API처럼 OpenAI 호환 방식으로 연결하는 항목을 선택합니다. 어떤 항목이 해당하는지 확실하지 않으면 임의로 저장하지 않고 화면의 제공자 설명이나 최신 RisuAI 안내를 확인합니다.
3. 연결 정보를 입력합니다
다음 값만 입력하고 나머지 고급 옵션은 우선 기본값으로 둡니다.
| RisuAI 항목 | 입력할 값 | 주의 |
|---|---|---|
| API 주소, Base URL 또는 Endpoint | https://api.jiminbox.com/v1 | 이 문서와 기존 Jiminbox 문서에서 사용하는 주소입니다. 주소 끝에 개인 키나 임의의 경로를 붙이지 않습니다. |
| API Key, Secret Key 또는 Token | New API에서 방금 만든 RisuAI 전용 키 | 키 앞뒤에 공백이 들어가지 않게 붙여 넣고, 문서·캡처·메신저에 다시 적지 않습니다. |
| 모델, Model 또는 Model ID | New API 모델 목록에서 복사한 현재 모델 ID | 표시 이름이 아니라 정확한 ID를 요구할 수 있습니다. 드롭다운에 없으면 직접 입력할 수 있는지 확인합니다. |
예시로 주소만 다시 적으면 다음과 같습니다.
https://api.jiminbox.com/v1실제 API 키와 모델 ID는 예시로 만들거나 이 문서에 적지 않습니다. 입력란의 이름이 표와 다르면, API 서버 주소, 인증 키, 사용 모델에 해당하는 세 칸을 찾아 같은 의미로 입력합니다.
4. 저장하고 연결을 선택합니다
- 저장, Save, 적용 또는 비슷한 버튼을 누릅니다.
- 저장한 프리셋이 목록에 나타나는지 확인합니다.
- RisuAI가 현재 사용할 프리셋을 따로 고르게 한다면 방금 저장한 프리셋을 선택합니다.
- 모델 목록을 불러오는 버튼이 있다면 눌러 목록이 표시되는지 확인합니다. 자동으로 목록을 불러오지 않는 버전은 모델 ID를 직접 입력할 수 있습니다.
첫 설정에서는 단순하게 시작하세요
처음부터 온도, 최대 출력 길이, 프롬프트 템플릿, 추론 관련 옵션을 모두 바꾸면 오류 원인을 찾기 어려워집니다. 연결과 첫 응답을 확인한 뒤 필요한 옵션을 하나씩 조정합니다.
첫 대화 시작하기
- RisuAI의 캐릭터 목록에서 대화할 캐릭터를 엽니다. 캐릭터가 없다면 RisuAI가 제공하는 캐릭터 가져오기 또는 만들기 흐름을 사용합니다. 캐릭터 카드의 출처와 설정 내용을 확인한 뒤 사용합니다.
- 새 대화 또는 새 채팅을 엽니다.
- 대화 화면에서 현재 프리셋이 방금 저장한 Jiminbox 프리셋인지 확인합니다. 이 선택기가 보이지 않는 버전에서는 모델 프리셋 설정에서 현재 선택된 항목을 확인합니다.
- 다음처럼 짧고 민감하지 않은 메시지를 보냅니다.
안녕하세요. 짧게 자기소개해 주세요.- 캐릭터의 응답이 대화창에 표시될 때까지 기다립니다. 첫 요청은 모델이나 네트워크 상태에 따라 시간이 걸릴 수 있습니다.
성공 확인
다음 세 가지를 확인하면 기본 연결이 완료된 것입니다.
- 대화창에 오류 없이 응답이 표시됩니다.
- 응답이 끝난 뒤 재시도나 인증 오류 알림이 남지 않습니다.
- New API의 Usage Logs에 요청 시각, 사용 모델과 사용량 기록이 나타납니다.
Usage Logs 기록은 RisuAI가 실제로 New API에 요청을 보냈는지 확인하는 보조 신호입니다. 화면에 보이는 프리셋 이름이나 “연결됨” 표시만으로 성공을 단정하지 않고, 실제 대화 응답을 함께 확인합니다.
문제가 생겼을 때
RisuAI가 열리지 않음
- jiminbox.com에 먼저 로그인했는지 확인합니다.
- Authentik 로그인과 RisuAI 앱 비밀번호를 각각 확인합니다.
- 앱 비밀번호를 여러 번 추측하지 말고 운영자에게 재설정을 요청합니다.
- 다른 서비스는 열리지만 RisuAI만 열리지 않으면 발생 시각과 화면에 보이는 오류 문구만 기록합니다. 비밀번호, API 키와 개인 정보가 보이는 화면은 보내지 않습니다.
프리셋을 저장할 수 없음
- API 제공자가 OpenAI 호환 API에 해당하는지 확인합니다.
- 필수 입력란인 프리셋 이름, 주소, API 키와 모델이 비어 있지 않은지 확인합니다.
- API 키를 다시 붙여 넣을 때 앞뒤 공백이 들어가지 않았는지 확인합니다.
- 화면이 다른 버전이라면 OpenAI Compatible, Custom, Base URL처럼 비슷한 이름의 항목을 찾습니다. 확실하지 않은 항목을 임의로 바꾸기보다 버전 정보를 함께 기록해 문의합니다.
모델이 보이지 않거나 모델 오류가 발생함
- New API 모델 목록에서 현재 플랜에 허용된 정확한 모델 ID를 다시 복사합니다.
- 모델 목록을 새로 고치거나, 목록에 없는 경우 직접 입력 방식이 제공되는지 확인합니다.
- 모델 ID의 대소문자, 숫자와 하이픈을 임의로 바꾸지 않습니다.
- 모델이 계속 보이지 않으면 Jiminbox 문제 해결 가이드의 모델 확인 순서를 참고합니다.
인증 오류, 401 또는 권한 오류가 발생함
- API 주소가
https://api.jiminbox.com/v1인지 확인합니다. - New API의 API Keys에서 해당 키가 삭제되거나 만료되지 않았는지 확인합니다.
- 다른 앱의 키를 복사한 것은 아닌지, 키 값 앞뒤에 공백이 없는지 확인합니다.
- 오류가 계속되면 키 값을 공유하지 말고 해당 키를 삭제한 뒤 새 키를 발급해 다시 연결합니다.
응답이 멈추거나 사용량 초과가 표시됨
- New API의 Wallet에서 현재 한도와 잔여량을 확인합니다.
- Usage Logs에서 방금 보낸 요청이 기록되었는지 확인합니다.
- 긴 캐릭터 설정과 대화는 입력 토큰을 많이 사용할 수 있으므로, 먼저 새 대화에서 짧은 메시지로 다시 시험합니다.
- 한도나 모델 접근 권한 문제는 New API Key와 사용량 가이드와 Jiminbox 서비스 및 플랜을 확인합니다.
보안 주의
화면과 로그를 공유하기 전
RisuAI 설정 화면에는 API 키, 캐릭터 설정, 개인 프롬프트와 대화 내용이 함께 보일 수 있습니다. 오류를 문의할 때는 API 키, 앱 비밀번호, 쿠키, 세션 정보, 개인 정보와 민감한 대화를 가리고 필요한 부분만 공유하세요. 키가 한 글자라도 노출되었다고 의심되면 즉시 삭제하고 새로 발급합니다.
- RisuAI 프리셋을 공개 파일이나 게시글에 내보내지 않습니다. 내보내기 기능이 키를 포함하는지는 버전에 따라 다를 수 있으므로, 공유 전 텍스트를 직접 확인합니다.
- 캐릭터 카드나 프롬프트에 비밀번호, API 키, 주민등록번호, 결제 정보와 같은 민감한 정보를 넣지 않습니다.
- 외부 AI 계정을 RisuAI에 직접 연결하면 사용량과 비용은 해당 외부 서비스 정책을 따릅니다. Jiminbox New API 한도와 별개인지 확인합니다.
다음 단계: New API Key와 사용량 가이드 · Jiminbox 문제 해결 가이드 · Jiminbox 사용 정책
참고 자료
- Jiminbox — 서비스 포털에서 RisuAI와 New API를 여는 기본 경로를 안내합니다.
- New API 모델 목록 — 연결할 때 현재 사용 가능한 모델 ID를 확인하는 출처입니다. 모델 구성과 단가는 바뀔 수 있습니다.
- RisuAI 공식 웹사이트 — RisuAI가 AI 캐릭터와 대화하는 웹·다중 API 클라이언트라는 설명과 초보자용 사용 흐름을 제공합니다.
- RisuAI 공식 GitHub 저장소 — 공식 프로젝트가 지원하는 API 범위와 웹·다중 플랫폼 특성을 설명합니다.
- RisuAI 공식 Wiki — 캐릭터, 로어북 등 기본 용어를 설명합니다. 위키 첫 화면에 오래된 문서라는 안내가 있어 UI 라벨의 확정 근거로 사용하지 않습니다.
- RisuAI OpenAI 호환 연동 예시 — OpenAI 호환 제공자, 주소, API 키와 모델을 입력하는 일반 흐름을 설명하는 제3자 공개 연동 문서입니다. Jiminbox의 실제 주소와 키는 기존 Jiminbox 문서의 값을 우선합니다.
- 아카라이브 캐릭터AI 게시판 — RisuAI와 AI 캐릭터 이용자가 사용하는 표현과 흐름을 살펴볼 수 있는 공개 커뮤니티입니다. 개별 게시글의 긴 내용은 복제하지 않습니다.