본문으로 건너뛰기

유닛

남은 유닛과 초과 사용에 따른 호출 상태

보유 유닛과 초과 사용량, 만료일과 호출 차단 조건을 설명하고, 결제가 활성화된 스페이스에서 Admin이 유닛을 구매하는 방법을 안내합니다.

페이지 목차

역할별로 가능한 작업

작업AdminMember
보유, 초과 및 차단 상태 확인가능가능
보유 상세와 구매 및 만료 이력 확인가능가능
유닛 화면에서 구매결제가 활성화된 스페이스에서 가능불가

유닛 구매 버튼은 결제가 활성화된 스페이스의 Admin에게 표시됩니다. Member는 구매가 필요하면 Admin에게 요청하세요. Admin이라도 버튼이 보이지 않으면 현재 스페이스와 결제 활성화 여부를 확인합니다. 결제 활성화 상태와 화면 표시가 맞지 않으면 플랫폼 내 문의 기능으로 확인을 요청합니다.

유닛 화면에서 확인하는 값

항목의미
보유 유닛구매하거나 지급받아 현재 사용할 수 있는 unit 합계
이번 달 초과 유닛보유 유닛으로 차감하지 못하고 기록된 초과 사용량(unit)
호출 차단 상태보유 유닛이 없고 초과 사용도 허용되지 않아 API 호출이 중단된 상태
보유 유닛 상세남은 수량, 유상 유닛과 프로모션 유닛의 구분과 만료일
유닛 변동 이력 (최근 3개월)최근 3개월의 유닛 구매, 지급 및 만료에 따른 변동

유닛 화면에서는 남은 유닛을, 분석 화면에서는 이미 사용한 유닛을 확인합니다. 에셋 및 API 키별로 이미 사용한 양을 비교하려면 누적 사용량 분석하기로 이동합니다. VAT 포함 KRW 미결제 금액은 유닛과 별개의 값입니다. 이 금액은 결제가 활성화된 스페이스의 Admin이 스페이스 관리 > 결제에서 확인합니다.

화면에 표시된 개별 유닛 값을 더하면 표시된 합계와 조금 다를 수 있습니다. 계산과 표시의 자릿수가 다르기 때문입니다.

값자릿수
호출 비용과 구매 적립량의 계산소수점 이하 6자리
화면의 합계 표시계산값을 모두 더한 뒤 소수점 이하 2자리로 반올림

호출 한 건의 비용을 응답에서 읽고 기록하는 방법은 요청별 비용에서 확인합니다.

잔액과 호출 가능 상태 확인하기

  1. 유닛 열기

    왼쪽 메뉴에서 AI 게이트웨이 > 유닛 관리로 이동합니다.

  2. 보유와 초과 상태 비교하기

    화면의 보유 유닛과 이번 달 초과 유닛을 확인합니다.

  3. 만료 예정 유닛 확인하기

    보유 유닛 상세에서 유상 유닛과 프로모션 유닛의 구분, 남은 수량과 만료일을 확인합니다. 만료가 임박한 유닛이 있으면 화면의 경고도 함께 확인합니다.

  4. 호출 차단 상태 확인하기

    화면의 호출 차단 상태를 확인합니다. 초과 사용량이 기록돼 있다고 해서 이후 호출에도 초과 사용이 허용된다는 뜻은 아닙니다. 초과 사용이 허용되지 않은 스페이스에서는 보유 유닛이 모두 소진되면 호출이 중단될 수 있습니다. 잔액 소진 뒤 호출과 Batch 제출 조건을 함께 확인하세요.

잔액이 소진됐을 때

게이트웨이는 호출을 시작할 때 최종 비용을 알 수 없으므로, 남은 유닛보다 비용이 큰 마지막 호출도 완료될 수 있습니다. 이 호출에서 잔액을 넘긴 사용량은 초과 사용량으로 기록됩니다. 이후 호출의 결과는 스페이스의 초과 사용 허용 여부에 따라 다릅니다.

상황결과
초과 사용이 허용되지 않은 스페이스의 다음 호출402 insufficient_units로 차단됩니다.
초과 사용이 허용된 스페이스의 다음 호출이후 호출의 사용량도 초과 사용량으로 계속 집계됩니다.
초과 사용이 허용되지 않은 스페이스의 Batch 신규 제출보유 유닛이 있어도 제출할 수 없습니다. 유닛을 구매해도 제출할 수 있게 되지는 않습니다.

Batch 제출 조건은 Batch 시작 조건과 확인 방법에서 확인하세요.

유닛 구매하기

유닛은 결제가 활성화된 스페이스의 Admin이 AI 게이트웨이 > 유닛 관리 화면에서 구매합니다. 구매 금액과 적립량, 결제수단을 확인한 뒤 결제하세요.

유닛의 원화 단가는 렛서가 정하며 AI 게이트웨이 요금정책의 유닛 단가를 따릅니다. 구매할 때의 금액은 구매 요약에서 확인합니다.

초과 사용량이 있으면 구매한 유닛은 초과분 상계에 먼저 쓰입니다

상계하고 남은 수량만 보유 유닛이 됩니다. 렛서는 초과 사용량을 월간 정산 때 원화로 환산해 청구합니다.

  1. 예상 적립량 확인하기

    입력한 KRW 구매 금액으로 적립될 unit을 구매 요약에서 확인합니다. 구매 요약에 상계와 적립 결과가 표시되면 초과분을 줄이는 수량과 보유 유닛에 더해지는 수량을 확인합니다.

  2. 총 결제금액 확인하기

    구매 금액과 부가세, 카드에 청구될 VAT 포함 총액을 확인합니다.

  3. 결제하기

    결제 결과가 불분명해도 같은 구매를 반복하지 마세요

    결제하면 카드에 실제로 청구됩니다. 결제 전에 구매 요약과 적용 정책을 확인하세요. 결과가 불분명하면 다시 결제하기 전에 거래 내역과 제공되는 증빙부터 확인하세요.

    구매 요약을 확인한 뒤 결제합니다.

  4. 구매 결과 확인하기

    구매 완료 화면에서 실제 결제금액, 적립 unit과 구매 후 보유 상태를 다시 확인합니다. 거래 증빙은 결제 및 거래 내역의 거래 내역과 증빙 확인하기에서 확인합니다.

유닛 구매와 미결제 금액 납부 구분하기

동작위치결과
유닛 구매AI 게이트웨이 > 유닛 관리초과 사용량에서 차감된 수량과 보유 유닛에 더해진 수량이 구매 요약과 완료 화면에 표시됨
미결제 금액 납부스페이스 관리 > 결제VAT 포함 KRW 미결제 금액이 결제한 만큼 줄어듦

유닛 구매와 미결제 금액 납부는 서로 다른 화면에서 시작하는 작업입니다. 거래 내역에 유닛 구매가 표시되어도 기존 미결제 금액의 납부가 완료된 것은 아닙니다. 처리 결과는 각 완료 화면과 거래 내역에서 확인합니다.