사용량과 요금
대화에는 로그인한 사용자의 HarperHarbor credits가 사용됩니다. 권한을 받은 앱은 사용자를 대신해 대화를 시작할 수 있지만, 사용자의 잔액을 받거나 보관하지는 않습니다.
모델별 요금은 GET /open/v1/models에서 확인할 수 있습니다. 입력, 캐시된 입력, 출력에는 각각 다른 요금이 적용됩니다. 최종 요금은 모델이 보고한 토큰 사용량으로 계산하며, 완료된 응답에는 최소 1 credit가 부과됩니다.
credits 예약과 정산
Section titled “credits 예약과 정산”서비스는 생성 전에 입력과 최대 출력에 필요한 credits를 예약합니다. 따라서 최종 요금보다 많은 사용 가능 잔액이 필요할 수 있으며, 사용하지 않은 예약분은 정산할 때 해제됩니다.
요금은 모델의 실제 사용량에 따라 계산합니다. 안전 필터가 응답을 차단하거나, 모델이 내용을 이유로 답변을 거부하거나, 출력 한도에 도달하거나, 사용자가 중지하더라도 이미 발생한 사용량에는 요금이 부과됩니다. 응답 본문이 화면에 표시되지 않아도 요금이 발생할 수 있습니다.
플랫폼 자체 오류에는 요금을 부과하지 않습니다. 배포로 인한 중단도 여기에 포함됩니다. 모델 사용량이 없는 서비스 오류에도 요금을 부과하지 않습니다. 각 작업은 한 번만 정산하며 사용하지 않은 예약분은 해제됩니다. 동일한 내용의 clientOperationId로 다시 보내도 중복 청구되지 않습니다.
예약에 필요한 잔액이 부족하면 402 insufficient_credits가 반환됩니다. 앱에서 사용자를 계정 잔액으로 안내하면 사용 가능한 credits를 확인할 수 있습니다.
최종 요금 확인
Section titled “최종 요금 확인”GET /open/v1/conversation/operations/{operationId}로 작업 결과를 조회하고, 작업 상태와 settled, chargeCredits를 함께 확인하세요. 계정 잔액과 이용 내역에서도 해당 기록을 확인할 수 있습니다. 앱에서 추정한 토큰 수로 최종 요금을 계산하거나 보장해서는 안 됩니다.
credits 요금제와 현재 이용 가능한 구매 방법은 요금 안내를 확인하세요.
Agent 모드
Section titled “Agent 모드”Agent 준비 과정에서는 모델을 호출할 때마다 credits를 예약하고, 필요한 경우 예약액을 추가합니다. 실행이 끝나면 보고된 입력, 출력, 캐시 읽기, 캐시 쓰기 사용량을 합산해 한 번에 정산합니다. 일반 호출에 고정 요금이 적용되는 모델도 Agent 실행에는 토큰 요금이 적용됩니다. 모델 목록의 예상치는 한 차례 대화의 범위이며, 여러 번 호출하는 Agent 실행의 요금 상한이 아닙니다.
사용자가 중지하거나 모델 서비스에 오류가 나기 전에 완료된 모델 사용량에는 요금이 부과됩니다. 플랫폼 자체 오류에는 요금을 부과하지 않습니다. 저장된 준비 과정을 이어서 실행하면 새로 발생한 사용량에만 요금이 부과되며, 재연결하거나 같은 작업을 재생해도 중복 청구되지 않습니다. 자동 메모리 준비는 별도로 정산합니다.
이용 내역에는 Agent 모드 요금으로 표시되며 실제 사용한 모델도 별도로 기록됩니다. 최종 요금은 작업 결과의 settled와 chargeCredits로 확인하세요.