New API Key와 사용량 가이드
New API Key를 만들고 모델, 사용량과 요청 기록을 확인하는 방법을 안내합니다.
API 키는 비밀번호와 같습니다
다른 사람에게 공유하거나 공개 Git 저장소, 게시글, 화면 캡처와 로그에 노출하지 마세요. 앱마다 키를 나누어 만들면 문제가 생긴 키만 삭제할 수 있습니다.
New API 열기
- jiminbox.com에 로그인합니다.
- 왼쪽 사이드바에서 서비스를 누릅니다.
- New API를 누릅니다.
- 로그인 화면이 나타나면 Sign in → Continue with OIDC를 차례대로 누릅니다.
로그인한 뒤 New API 기본 화면이 열리는지 확인합니다.
플랜과 사용량 확인
- Wallet: 현재 플랜과 잔여 한도를 확인합니다.
- Dashboard: 전체 사용량을 한눈에 확인합니다.
- Usage Logs: 요청 시각, 사용 모델과 차감 내역을 확인합니다.
왼쪽 메뉴에서 Dashboard, Usage Logs, Wallet을 눌러 각 화면으로 이동합니다. 이 이미지는 계정 정보와 사용량이 보이지 않도록 메뉴 영역만 재단했습니다.
Pro는 5시간마다 미화 2달러 상당, MAX는 5시간마다 미화 20달러 상당의 API 사용 한도가 갱신됩니다. 사용하지 않은 5시간 한도는 다음 갱신 주기로 이월되지 않으며 모델마다 차감량이 다를 수 있습니다.
자세한 플랜 범위는 Jiminbox 서비스 및 플랜에서 안내합니다.
토큰과 크레딧 이해하기
LLM API는 질문 횟수가 아니라 토큰 사용량을 기준으로 크레딧을 차감합니다. 토큰은 모델이 글을 읽고 쓰기 위해 문장을 잘게 나눈 단위입니다. 같은 글자 수라도 언어, 숫자, 코드와 문장 구성에 따라 토큰 수가 달라지므로, 글자 수나 페이지 수만으로 정확한 차감량을 미리 정할 수는 없습니다.
한 번의 요청에는 다음 사용량이 포함될 수 있습니다.
- 일반 입력 토큰: 시스템 지침, 사용자가 보낸 질문, 이전 대화, 첨부 문서와 도구 실행 결과처럼 모델이 새로 읽은 내용입니다.
- 캐시 입력 토큰: 이전 요청과 같은 앞부분을 공급사가 재사용한 입력입니다. 일반 입력보다 낮은 단가가 적용될 수 있지만, 같은 문장을 다시 보냈다고 항상 캐시되는 것은 아닙니다.
- 출력 토큰: 모델이 생성한 답변입니다. 모델과 라우팅 방식에 따라 추론에 사용한 토큰이 출력 사용량에 포함될 수 있습니다.
화면에서 질문 한 번을 보내도 API 요청은 여러 번 발생할 수 있습니다
OpenCode나 Hermes Agent가 도구를 호출하고 결과를 다시 모델에 보내거나, 오류를 고치기 위해 재시도하면 한 작업이 여러 요청으로 나뉩니다. 대화가 길어질수록 이전 대화도 입력에 다시 포함되므로, 짧은 질문을 한 번 보냈다는 사실만으로는 차감량을 판단하기 어렵습니다.
크레딧 차감 계산법
토큰 단가가 100만 토큰 기준으로 표시될 때 차감량은 다음처럼 계산합니다.
차감 크레딧 =
(일반 입력 토큰 × 입력 단가
+ 캐시 입력 토큰 × 캐시 입력 단가
+ 출력 토큰 × 출력 단가)
÷ 1,000,000예를 들어 deepseek-v4-flash의 표시 단가는 입력 $0.14, 캐시 입력 $0.028, 출력 $0.28입니다. 캐시 없이 입력 10만 토큰과 출력 1만 토큰을 사용하면 다음과 같습니다.
(100,000 × $0.14 + 10,000 × $0.28) ÷ 1,000,000
= $0.0168 크레딧 차감여기서 $0.0168은 결제 수단에 0.0168달러가 추가 청구된다는 뜻이 아닙니다. Pro의 5시간 한도 $2 가운데 약 0.84%를 사용했다는 뜻입니다. 같은 요청을 MAX에서 처리하면 5시간 한도 $20의 약 0.084%에 해당합니다.
단가 확인 기준
아래 계산은 2026년 7월 28일 New API 모델 목록에 표시된 플랜 크레딧 단가를 사용했습니다. 이는 공급사 직접 결제 가격이나 Jiminbox의 실제 공급 원가가 아닙니다. 모델과 단가는 바뀔 수 있으므로 실제 요청 전에는 가격표를 다시 확인합니다.
작업별 예상 차감량
다음 표는 캐시가 없는 단일 요청을 가정한 계산 예시입니다.
- 가벼운 요청: 입력 2,000 토큰, 출력 1,000 토큰
- 긴 문서·코드 작업: 입력 100,000 토큰, 출력 10,000 토큰
| 모델 | 이용 플랜 | 가벼운 요청 | 긴 문서·코드 작업 | 긴 작업 1회의 5시간 한도 비율 |
|---|---|---|---|---|
deepseek-v4-flash | Pro·MAX | $0.00056 | $0.0168 | Pro 기준 약 0.84% |
mimo-v2.5 | Pro·MAX | $0.00056 | $0.0168 | Pro 기준 약 0.84% |
deepseek-v4-pro | MAX | $0.00696 | $0.2088 | 약 1.044% |
glm-5.2 | MAX | $0.0072 | $0.184 | 약 0.92% |
kimi-k2.7-code | MAX | $0.0059 | $0.135 | 약 0.675% |
minimax-m3 | MAX | $0.0036 | $0.084 | 약 0.42% |
claude-sonnet-4-6 | MAX | $0.0084 | $0.18 | 약 0.9% |
claude-sonnet-4-6은 실제 Anthropic Claude가 아니라 현재 GLM-5.2로 전달되는 Claude Code 호환 ID입니다. 같은 GLM-5.2를 사용하더라도 호환 ID의 표시 단가가 다르므로, 모델 이름이 비슷하다는 이유로 차감액도 같다고 가정하면 안 됩니다.
캐시가 적용되는 예시
코딩 에이전트가 입력 10만 토큰 가운데 8만 토큰을 이전 요청과 같은 내용으로 재사용하고, 새 입력 2만 토큰과 출력 1만 토큰을 사용했다고 가정해 보겠습니다.
| 모델 | 캐시가 없을 때 | 8만 토큰이 캐시될 때 |
|---|---|---|
deepseek-v4-flash | $0.0168 | $0.00784 |
mimo-v2.5 | $0.0168 | $0.005824 |
glm-5.2 | $0.184 | $0.0928 |
캐시는 긴 시스템 지침이나 코드베이스처럼 같은 앞부분을 여러 번 읽는 작업에서 차감량을 줄일 수 있습니다. 다만 캐시 적용 여부와 범위는 공급사, 모델과 앱의 요청 방식에 따라 달라집니다. 최종 기준은 예상값이 아니라 Usage Logs에 기록된 실제 입력·출력 토큰과 차감량입니다.
실제 차감량이 예상보다 커지는 경우
- 대화가 길어져 이전 메시지가 매 요청의 입력에 다시 포함된 경우
- 에이전트가 파일 검색, 명령 실행과 오류 수정을 위해 모델을 여러 번 호출한 경우
- 큰 문서나 코드 저장소 전체를 매번 입력으로 보낸 경우
- 답변 길이 제한을 크게 설정해 출력 토큰이 늘어난 경우
- 이미지나 첨부파일이 모델별 방식에 따라 입력 사용량으로 환산된 경우
- 프로그램 오류나 자동 재시도로 같은 요청이 반복된 경우
크레딧을 아끼려면 먼저 deepseek-v4-flash나 mimo-v2.5로 작업을 시작하고, 결과가 부족할 때만 고급 모델로 바꿉니다. 관련 없는 이전 대화는 새 세션으로 분리하고, 필요한 파일과 코드 범위만 보내며, 앱에서 최대 출력 길이를 지나치게 크게 설정하지 않는 편이 좋습니다.
API 키 만들기
- 왼쪽 메뉴에서 API Keys를 엽니다.
- Create API Key를 누릅니다.
- 사용할 앱을 알아볼 수 있는 이름을 입력합니다. 예:
내 노트북 OpenCode - 필요한 경우 만료일과 사용 한도를 정합니다.
- Save를 누른 뒤 표시된 키를 안전한 곳에 복사합니다.
앱마다 키를 따로 만드세요
OpenCode, RisuAI와 개인 프로그램에 같은 키를 돌려 쓰지 않는 편이 안전합니다. 키 이름에 앱과 기기를 함께 적으면 나중에 삭제할 대상을 찾기 쉽습니다.
키를 여러 개 만들어도 플랜 한도는 늘어나지 않습니다
API 키에 별도 한도를 두지 않아도 계정의 플랜 한도와 허용 모델은 그대로 적용됩니다.
사용할 모델 확인
New API 모델 목록에서 현재 사용할 수 있는 모델 ID와 계정 그룹을 확인합니다.
모델 구성은 공급 상황에 따라 바뀔 수 있습니다. 앱 설정에 모델 ID를 직접 입력할 때는 기억에 의존하지 않고 이 화면의 값을 사용합니다.
모델별 특징과 작업에 맞는 선택 방법은 Jiminbox 모델 선택 가이드에서 안내합니다.
앱에 연결하기
- opencode 설치 가이드 — OpenCode에서 사용
- claude desktop 설치 가이드 — Claude Desktop에서 타사 추론으로 사용
- RisuAI 이용 가이드 — RisuAI 모델 프리셋에 연결
- 개인 프로그램 — OpenAI 호환 주소
https://api.jiminbox.com/v1과 발급한 키를 사용
연결한 앱에서 짧은 테스트 요청을 보낸 뒤 Usage Logs에 기록이 남는지 확인합니다.
키 삭제와 교체
키가 노출되었거나 더 이상 사용하지 않는다면 API Keys에서 즉시 삭제합니다. 삭제한 키는 다시 사용할 수 없으므로 연결된 앱에는 새 키를 입력해야 합니다.
Jiminbox는 이용자가 관리하는 키의 유출, 공유 또는 프로그램 오류로 소진된 사용량을 원칙적으로 복구하지 않습니다. 자세한 기준은 Jiminbox 사용 정책에서 안내합니다.
문제가 계속되면 Jiminbox 문제 해결 가이드의 오류 유형별 순서로 점검합니다.