콘솔 메뉴 가이드

1. 콘솔 메뉴 구성

콘솔(나의 관리 페이지) 좌측 사이드바는 세 그룹으로 나뉘어 있습니다.

관리 — 사용 현황·크레딧 관리·API 키 관리·로그 조회·캐시 관리
설정 — 라우팅 설정·프리셋 설정·BYOK 설정·프라이버시 설정
계정 — 계정 설정

2. [관리] 사용 현황

내가 AI를 얼마나 썼는지 한눈에 보여주는 대시보드입니다. 콘솔에 들어가면 기본으로 열리는 페이지입니다.

요약 카드 — 총 요청 수, 총 비용(₩), 총 토큰 사용량, 총 성공률 (직전 동일 기간 대비 증감 함께 표시)
추이 차트 — 요청 / 비용 / 토큰 / 에러 메트릭을 탭으로 전환
필터 — 기간(1·7·30·90·120일, 기본 7일)·키·모델 조건이 모든 영역에 공유
TOP 5 — 요청이 많은 모델 / API 키 / Provider
현재 필터 조건에 해당하는 데이터를 CSV로 다운로드할 수 있습니다.

3. [관리] 크레딧 관리

크레딧을 충전하고 사용 내역을 확인하는 지갑·결제 메뉴입니다.

현재 잔액 확인 (소수점 둘째 자리까지)
수동 충전 — 프리셋 금액 선택 또는 직접 입력
자동 충전 켜기/끄기 — 잔액이 정해둔 금액 이하로 떨어지면 자동 결제
충전 내역 — 일시·금액·결제 수단·상태(성공/실패/환불)
이번 달 충전액, 평균 사용액 등 통계 카드

4. [관리] API 키 관리

AI를 호출할 때 필요한 "열쇠" 같은 키를 발급·관리하는 메뉴입니다. 발급한 키는 ChatGPT 호환 채팅 앱(ChatBox·TypingMind·Open WebUI·LobeChat 등) 설정 화면에 Base URL과 함께 붙여넣기만 하면 바로 사용할 수 있습니다. 코드를 모르는 분도 이 방식으로 충분히 연결됩니다.

키 발급 — 키 이름·크레딧 한도·리셋 주기(리셋 없음/매일/매주/매월)·만료일 설정
키 수정 — 한도 변경·활성화/비활성화 토글 (키 값과 만료일은 변경 불가)
키 삭제 — 노출됐을 때 즉시 폐기 후 재발급
키별 시맨틱 캐시 ON/OFF 및 유사도 임계값(0.70-0.99, 기본 0.70, 권장 0.90) 설정

키 값은 발급 시점에만 1회 표시되므로, 안전한 곳에 꼭 저장해 두세요. 잃어버리면 재조회가 불가능하고 새로 발급받아야 합니다.

5. [관리] 로그 조회

지금까지의 모든 API 호출 기록을 자세히 들여다보는 메뉴입니다. 문제가 생겼을 때 원인을 찾거나, 사용 내역을 검증할 때 유용합니다.

기간·키·모델·상태(정상/오류)·Provider 등으로 필터링
각 로그에는 토큰 수·비용·응답 시간·폴백 여부가 표시됨
"상세" 클릭 시 그 요청의 전체 정보 확인 (요청·응답 본문은 프라이버시 설정에서 저장 ON일 때만 보임)

6. [관리] 캐시 관리

비슷한 질문에 이전 답변을 재사용해서 비용을 아껴주는 시맨틱 캐시의 통계와 항목을 조회하는 메뉴입니다.

7일 / 30일 / 90일 기간 토글 적중률 추이 차트
모델·API 키·키워드로 필터링한 캐시 항목 목록
항목 상세 모달 및 캐시 전체 삭제(더보기 메뉴)

캐시 ON/OFF와 유사도 임계값 설정은 "API 키 관리" 메뉴에서 키별로 합니다. 캐시가 정상 작동하려면 프라이버시 설정에서 "요청/응답 내용 저장" ON, "로그 민감 정보 마스킹" OFF, "민감 정보 마스킹"이 비어있는 상태여야 합니다. 시맨틱 캐시는 요청 길이 5,000자 이하·TTL 24시간 제한이 있습니다.

7. [설정] 라우팅 설정

라우터가 어떤 기준으로 AI를 골라줄지 정책을 정하는 메뉴입니다.

Access Control — "모두 허용하되 차단" 또는 "모두 차단하되 허용" 모드로 프로바이더·모델을 제어. Preset·Auto Router·개별 호출·BYOK 모든 호출에 공통 적용됩니다.
Provider 정렬 방식 — 동일 모델을 여러 프로바이더가 제공할 때의 우선 순서. 디폴트(Balanced) / 최저 비용(Price) / 최고 처리량(Throughput) / 최저 지연(Latency) 중 선택
Auto Router 후보 — cafe24/auto 호출 시 후보 모델을 Provider→모델 2단계로 제한
Fallback 설정 — 호출 실패 시 같은 모델의 다른 프로바이더로 자동 전환할지 여부 (기본 ON)

8. [설정] 프리셋 설정

자주 쓰는 호출 설정을 하나의 "세트"로 묶어 저장하는 메뉴입니다. 매번 같은 옵션을 입력하지 않아도 한 줄로 부를 수 있어요.

Primary 모델 + 실패 시 시도할 폴백 모델 체인
Provider 설정(정렬·차단/허용·시도 순서)과 System Prompt
샘플링 파라미터(Temperature·Max Tokens·Top P·Top K·Frequency/Presence Penalty)
호출 시 @preset/이름 형태로 한 번에 적용
수정할 때마다 버전이 올라가며 필요 시 이전 버전으로 롤백 가능 (삭제 시 복구 불가, 해당 프리셋을 사용하는 호출은 즉시 404 실패)

9. [설정] BYOK 설정

사용자가 보유한 외부 Provider API Key를 등록해서 사용하는 메뉴입니다. 본인 키로 호출되는 비용은 카페24 크레딧이 아닌 사용자 Provider 계정으로 직접 과금됩니다.

프로바이더 선택 → 인증 정보 입력 → 저장 전 유효성 자동 검증(테스트 호출). 실패 시 저장 거부
활성화 토글로 라우팅에 포함시킬지 결정. 비활성화 시 라우팅에서 제외
BYOK 가능 프로바이더 목록과 연동 현황 표시

9.1 BYOK 동작 방식

BYOK 키를 등록하면 해당 프로바이더 요청은 등록한 본인 키를 우선 사용합니다.
본인 키 호출이 실패하면 카페24 공유 크레딧으로 자동 전환(fallback)됩니다.
그래도 실패하면 오류로 처리됩니다.
모든 BYOK 요청은 로그 조회에서 본인 키 사용/fallback 여부를 확인할 수 있습니다.

BYOK 호출에는 캐싱(시맨틱)·프리셋이 적용되지 않습니다. 또한 fallback에 대비해 잔액 크레딧이 0원 초과인 상태에서만 작동하며, 월 1만 건 초과 시 모델 토큰 가격의 3%가 수수료로 부과됩니다.

10. [설정] 프라이버시 설정

대화 내용 저장 여부와 민감 정보 처리 방식을 정하는 개인정보 보호 메뉴입니다.

요청/응답 내용 저장 — 기본 OFF. ON 시 보관 기간(7일/14일/30일, 기본 7일) 선택
민감정보 마스킹 — 기본 OFF. 정규표현식과 치환 라벨로 모델 전달 전 마스킹. 빠른 추가 프리셋: 이메일·휴대폰·유선전화·주민등록번호·신용카드 번호·IP 주소
- 직접 추가로 사용자 정의 정규표현식 패턴을 등록할 수 있음
로그 민감 정보 마스킹 — 기본 활성화. 모델에는 원본이 전달되고 로그 저장 시에만 이메일·전화번호·주민등록번호·신용카드번호·IP 주소가 마스킹됨 (활성화 시 캐싱 사용 불가)

11. [계정] 계정 설정

내 계정 정보와 알림을 관리하는 메뉴입니다.

알림 설정 — 잔액 부족·자동 충전 실패·에러 응답 등 어떤 상황에서 알림을 받을지 선택
회원 정보 수정 — 비밀번호·이메일·연락처는 외부 카페24 사용자 페이지로 이동
로그인 보안 설정 — 2단계 인증·로그인 알림 등은 외부 카페24 보안 페이지로 이동
서비스 해지 — 호스팅 계정 대시보드로 이동 (서비스 해지는 미납 요금 없을 때만 가능)