크레딧은 무엇이고 어떻게 쓰이나요
업데이트
- 읽는 분
- 크레딧을 사거나 쓰는 분
- 끝나면
- 크레딧이 무엇에 얼마나 쓰이는지 알고, 남은 양을 어디서 보는지 알아요.
크레딧의 크기
1 크레딧 = 부가세 포함 2원어치예요. 사는 값은 원화(부가세 포함)로 적혀 있어요.
모델마다 단가가 달라서 같은 질문도 사용하는 크레딧이 달라요.
쓰이는 방식
질문을 보내고 답을 받은 만큼, 그 모델의 차감 단가대로 크레딧을 사용해요. 모델별 단가는 API 장에 있어요.
웹 채팅·앱 채팅·API 키가 한 지갑의 크레딧을 함께 써요.
보내기 전에 그 요청이 쓸 수 있는 최대 금액을 잠시 잡아 두고, 답이 끝나면 실제로 쓴 만큼만 정산해요.
남은 양 보는 곳
원포트 스페이스는 스페이스 화면 「남은 크레딧」에서, 스쿨오더·오피스오더에서 산 지갑은 그곳 「AI API」 화면 「남은 크레딧」에서 봐요.
채팅 화면에서는 「남은 AI 사용액」으로 보여요. 사람별 한도가 걸린 분은 「이번 달 내 한도」(기수 반이면 「반에서 내 몫」)로 보여요.
다 쓰면
채팅에 「이번 달 내 한도를 다 썼어요.」가 떠요
- 확인
- 담당자가 내게 건 한 달 한도를 다 썼어요.
- 이렇게 해요
- 담당자에게 한도를 늘려 달라고 하거나, 다음 달이 되면 다시 써요.
채팅에 「크레딧을 다 썼어요. 충전하면 이어서 쓸 수 있어요.」가 떠요
- 확인
- 함께 쓰는 지갑의 크레딧을 다 썼어요.
- 이렇게 해요
- 지갑 주인이 크레딧을 채우면 이어서 써요.
API 가 402 를 돌려줘요
- 확인
- 오류의 error.reason 을 봐요. held_by_others 는 같은 지갑의 다른 호출이 잡아 둔 몫이고, hold_exceeds_balance 는 이 요청이 잡아 둘 금액이 잔액보다 큰 것, below_minimum_balance 는 잔액이 바닥난 거예요.
- 이렇게 해요
- held_by_others 면 Retry-After 초만큼 쉬고 그대로 다시 보내요(채울 필요 없어요). hold_exceeds_balance 면 max_tokens(/v1/responses 는 max_output_tokens)를 줄이거나 채워요. below_minimum_balance 면 채워요. 채운 뒤에도 같은 키를 그대로 써요.
API 가 429 key_limit_exceeded 를 돌려줘요
- 확인
- 오류의 error.reason 을 봐요. held_by_others 는 같은 키로 보낸 다른 호출이 아직 안 끝나서 그 몫까지 더하면 이번 달 한도를 넘는 거고, key_month_limit 은 그 키의 이번 달 한도, key_day_limit 은 오늘 한도에 닿은 거예요.
- 이렇게 해요
- held_by_others 면 Retry-After 초만큼 쉬고 그대로 다시 보내요(그 호출이 끝나면 풀려요). key_month_limit 이면 max_tokens(/v1/responses 는 max_output_tokens)를 줄여 보내거나, 「AI API」 화면 「키 관리」에서 그 키의 「한도 수정」으로 올리거나, 다음 달에 다시 써요. key_day_limit 이면 줄여도 같아요 — 한도를 올리거나 한국 시간 0시 뒤에 다시 써요.
API 가 403 model_not_in_plan 을 돌려줘요
- 확인
- 산 크레딧으로 부를 수 없는 모델이에요.
- 이렇게 해요
- 「AI API」 화면의 「이 크레딧으로 부를 수 있는 모델」을 보고 그 안의 모델로 바꿔요.
자주 묻는 질문
크레딧에 유효기간이 있나요?
채운 크레딧은 만료되지 않아요. 국고·교비 같은 사업비로 샀다면 그 사업의 인정 사용기간 안에 쓴 몫만 그 재원 정산에 들어가요.
생각(추론)하는 모델은 크레딧을 더 쓰나요?
네. 생각한 토큰도 출력 단가로 계산돼요. 생각을 많이 시킬수록 크레딧을 더 사용해요.
답을 못 받으면 크레딧은 어떻게 되나요?
실패한 요청은 잡아 둔 금액이 그대로 풀려요. 받는 중에 끊긴 답은 그때까지 쓴 만큼 크레딧을 사용해요. 다만 영상은 입력한 내용이 AI 회사의 안전 기준에 막혀 AI 회사가 값을 매기면 그만큼 빠져요. 모델이 답을 거절하면 실패가 아니라서, 답 글이 없어도 모델이 읽은 입력(채팅은 앞 대화와 첨부 글까지)과 답을 준비하며 쓴 몫만큼 크레딧을 사용해요.
API 로 잔액을 볼 수 있나요?
네. GET /v1/credits 를 부르면 남은 크레딧·충전 합계·사용 합계를 크레딧으로 받아요.