한눈에 보기
단계별로 하는 일
확정해도 결제는 자동으로 시작되지 않습니다. 확정한 뒤 인보이스마다 결제를 요청해야 합니다. 첫 결제 요청과 결과 확인을 보세요.
GET /v1/invoices)로 확인합니다. 웹훅 이벤트 유형과 data
예시: 이벤트 하나가 금액이 되기까지
AI 서비스가 생성 요청 한 번마다 아래 이벤트를 보낸다고 해 봅니다.이벤트
1
미터가 이벤트를 고른다
event_type이 llm_generation인 미터만 이 이벤트를 집계합니다. 입력 토큰 미터(input_tokens 합계), 출력 토큰 미터(output_tokens 합계), 요청 수 미터(이벤트 건수)처럼 한 이벤트에서 여러 미터가 각자 수량을 뽑을 수 있습니다. 미터 정의는 미터 설계에 있습니다.2
조합별로 수량을 나눈다
이 미터들이 모두
model을 차원 속성으로 두었다면, 이 이벤트의 수량은 {"model": "lumen-fast"} 조합에 쌓입니다. lumen-standard 모델 이벤트는 다른 조합에 쌓입니다.3
같은 조합의 단가를 곱한다
입력 토큰 미터의
{"model": "lumen-fast"} 조합에 이번 달 단가가 있으면 그 단가를 곱한 금액이 청구 예정액의 한 라인이 됩니다. 단가가 없으면 그 조합의 수량은 금액에 들지 않고 청구 예정액의 unpriced_usages에 나옵니다.4
고객별로 합친다
한 고객의 모든 라인 금액과 요금제 금액을 더한 값이 그 고객의 청구 예정액입니다. 숫자로 따라가는 예시는 금액 계산 따라가기에 있습니다.
되돌릴 수 없는 제약
아래는 한번 일어나면 되돌릴 수 없거나, 순서를 잘못 잡으면 바로잡을 수 없는 일입니다. 준비 순서는 이 제약에서 나옵니다.안전한 준비 순서
1
미터를 만든다
이벤트의
type과 집계할 속성, 단가를 나눌 차원 속성을 정해 미터를 만듭니다. 이벤트가 들어오면 이름 말고는 바꿀 수 없으므로 이벤트보다 먼저 확정합니다. 미터 설계2
이번 달 단가를 등록한다
미터의 조합마다 이번 달부터 적용할 단가를 넣습니다. 필요하면 기본료와 최소 사용료도 정합니다. 단가 모델과 버전, 기본료와 최소 사용료
3
고객을 등록한다
고객을 등록하고 응답의
id를 저장합니다. 고객 등록에는 미터가 필요하지 않으므로 이 단계는 미터와 단가보다 먼저 해도 됩니다. 고객 등록과 ID 대응4
이벤트를 보낸다
저장한 고객
id를 customer_id에 넣어 이벤트를 보냅니다. 사용량 이벤트 보내기5
청구 예정액으로 확인한다
콘솔의 ‘청구 검토’ 화면이나
GET /v1/invoices/draft로 금액이 생각한 대로 나오는지 봅니다. 보낸 데이터 확인하기type으로 이미 저장된 이벤트는 집계됩니다. 하지만 지난달 단가는 넣을 수 없으므로, 달이 바뀐 뒤 미터를 만들면 지난달 사용량은 청구할 수 없습니다.
콘솔의 ‘개요’ 화면 목록과 https://meterengine.com 첫 화면은 고객 연결을 먼저 보여 줍니다. ‘개요’ 화면의 목록은 진행 표시이며 순서를 따를 필요는 없습니다. 고객은 미터보다 먼저 등록해도 되지만, 이벤트는 미터와 단가를 만든 뒤에 보내세요. 자세한 내용은 빠른 시작을 보세요.
제약은 업무 환경마다 따로입니다
위 제약은 업무 환경마다 따로 적용됩니다. 테스트 환경의 미터에 이벤트가 들어와도 실제 환경의 같은 code 미터에는 영향이 없습니다. 고객, 미터, 단가는 업무 환경마다 따로 만들어야 하므로 실제 환경에서도 같은 순서로 다시 준비합니다. 업무 환경을 보세요.다음에 읽을 페이지
업무 환경
테스트 환경과 실제 환경이 무엇을 나누는지 봅니다.
시간 규칙
청구 월, 이벤트를 받는 기간, 집계 마감 시각을 봅니다.
예정액, 확정액, 수납액
화면과 API의 금액이 각각 무엇인지 봅니다.
빠른 시작
이 순서를 테스트 환경에서 직접 따라 합니다.