크레딧

충전·차감·잔액 조회.

개인·기업 선불로 충전한 잔액은 만료되지 않아요.
국고·사업비로 충전하신 경우, 잔액 만료와 별개로 그 사업의 인정 사용 기간 안에 찍힌 사용분만 해당 재원 정산에 들어가요. 인정 기간과 잔여분 처리는 계약서에 정해요.
다 쓰면 같은 키에 다시 충전하면 돼요 — 키를 새로 만들 필요가 없어요.
차감은 벤더 공식 단가 그대로예요. 캐시 읽기는 입력보다 싸게 계산돼요.
생각(추론) 토큰은 출력 단가로 계산돼요. Gemini · Grok 은 응답의 completion_tokens 에 생각한 몫이 안 들어가는데(Gemini 는 total_tokens 에만, Grok 은 completion_tokens_details.reasoning_tokens 에 따로 잡혀요), 벤더가 출력으로 받는 몫이라 저희도 출력으로 빼요 — 그래서 차감이 completion_tokens 로만 셈한 값보다 클 수 있어요.
Claude 는 캐시 쓰기가 입력보다 비싸게 계산돼요 — 5분 캐시 쓰기는 입력가의 1.25배, cache_control 에 ttl "1h" 를 준 1시간 캐시 쓰기는 입력가의 2배예요.
Claude 에 inference_geo "us"(미국에서만 처리)를 주시면 모든 토큰이 1.1배로 계산돼요. Anthropic 이 매기는 배수 그대로이고, 응답의 usage 가 실제로 그렇게 처리됐다고 알려준 호출에만 붙어요.
스트리밍이 중간에 끊겨도 그때까지 쓴 토큰은 차감돼요.

잔액 조회#

bash

curl https://oneport.kr/v1/credits \
  -H "Authorization: Bearer $ONEPORT_API_KEY"

응답

{
  "object": "credit_balance",
  "balance_usd": 42.185,
  "purchased_usd": 50,
  "used_usd": 7.815,
  "key_prefix": "sk-so-a1b2c3…"
}

응답 예시

{
  "object": "credit_balance",
  "balance_usd": 42.183204,
  "purchased_usd": 100.0,
  "used_usd": 57.816796,
  "key_prefix": "sk-so-a1b2"
}

응답 필드

파라미터	받는 값	저희가 하는 일
balance_usd	달러 (소수 6자리)	지금 남은 금액이에요. 예약 중인 금액은 이미 빠져 있어서, 진행 중인 호출이 있으면 잠깐 작게 보일 수 있어요.
purchased_usd	달러	지금까지 충전하신 총액이에요. 계정이 생긴 뒤 누적이라 줄어들지 않아요.
used_usd	달러	지금까지 실제로 쓴 총액이에요. 실패한 호출은 여기 안 들어가요(영상은 입력이 안전 기준에 막혀 AI 회사가 값을 매긴 경우만 들어가요).
key_prefix	문자열	이 조회에 쓴 키의 앞부분이에요. 키를 여러 개 나눠 쓰실 때 어느 키로 물었는지 확인하는 자리예요.

무엇이 언제 빠지나요#

부르기 전 — 이 요청이 최대로 쓸 금액을 미리 잡아둬요(예약). 잔액이 그보다 적으면 벤더로 보내지 않고 402 를 드려요.
끝난 뒤 — 벤더가 알려준 실제 사용량으로 정산해요. 예약이 실제보다 컸으면 남는 만큼 그대로 돌아와요.
실패하면 — 예약이 통째로 풀려요. 실패한 호출로는 돈이 안 나가요. 다만 영상은 입력한 내용이 AI 회사의 안전 기준에 막혀 AI 회사가 값을 매기면 그만큼 빠져요.
모델이 답을 거절하면 — 실패가 아니라서, 답 글이 없어도 모델이 읽은 입력과 답을 준비하며 쓴 몫이 벤더가 알린 사용량대로 빠져요. Claude 의 거절은 finish_reason 이 content_filter 로 와요(/v1/messages 는 stop_reason 이 refusal).

충전과 환불#

선불로만 팔아요. 원화로 결제하시고, 학교·기관 구매는 전자세금계산서를, 개인 구매는 현금영수증을 받으실 수 있어요. 쓰지 않은 크레딧은 받으신 날부터 7일 안이면 아무것도 빼지 않고 돌려드려요(사업자가 사업용으로 산 크레딧은 빼고요). 개인 구매는 결제 후 14일 안이고 30% 미만으로 쓰셨을 때도 그렇고, 그 밖에는 남은 잔액에서 10%만 빼고 돌려드려요. 학교·공공기관 구매는 7일이 지나면 바로 10%를 빼고 돌려드려요. 사업자가 사업용으로 산 크레딧은 현금으로 돌려드리지 않고, 만료되지 않아요. 2026년 10월 1일까지 사신 크레딧은 이와 상관없이 남은 몫을 아무것도 빼지 않고 돌려드려요. 국고·사업비로 사신 크레딧은 계약서를 따라요. 그리고 학교회계에는 회계연도 독립의 원칙이 있어 과다한 이월이 지적 사유가 될 수 있으니, 연도말 대량 충전은 행정실과 먼저 확인해주세요.

이 문서를 AI 에게 넘기시려면 마크다운 원문을 쓰세요 — 주소 끝에 .md 를 붙이면 나와요.