Sume 에이전트 수수료란 무엇인가요? 기본 5.5%의 의미

Sume 에이전트 수수료는 요청의 모델 금액 위에 더해 청구되며, 기본값은 5.5%입니다. API가 이 수수료를 어디에 보고하고 수수료 항목을 어떻게 읽는지 정리했습니다.

읽는 시간 4분Sume
전체 글

Sume 에이전트 수수료는 요청의 모델 금액 위에 더해지는 요금입니다. 사용량은 기본적으로 모델별 공개 요율에 5.5% 에이전트 수수료를 더해 청구되며, 워크스페이스 가격표(price book)가 다른 요율을 정할 수 있습니다. 생성 제출 응답은 이 수수료를 부과 기준이 된 모델 금액 옆에 별도 항목인 agent_fee_amount_usd_micros로 보고합니다.

수수료가 나타나는 위치와 읽는 법은 2026-09-27에 확인한 Sume API 레퍼런스에서 가져왔습니다. API 레퍼런스 문서가 가리키는 OpenAPI 스키마입니다. 기본 요율은 Sume의 가격 코드에서 읽었습니다. 요금제와 지갑은 Sume 요금 체계를 참고하세요.

에이전트 수수료는 어디에 나타나나요?

API 스키마에서 이 수수료가 나오는 곳은 두 군데입니다. POST /v1/avatar-1.0/talking-video나 POST /v1/timeline-1.0/render처럼 Sume의 Job envelope로 응답하는 생성 제출 응답에는 그 요청의 usage 추정치가 담깁니다. GET /v1/catalog에는 각 정가 옆에 같은 방식으로 나뉜 적용 추정치가 담길 수 있습니다. 이 엔드포인트의 나머지 내용은 Sume API 카탈로그에서 다룹니다.

수수료 필드, Sume API 레퍼런스(OpenAPI) 기준, 2026-09-27 확인.
필드위치담긴 값
usage.model_amount_usd_micros생성 제출 응답모델 금액. 워크스페이스 할인을 적용한 뒤의 정가이며, 에이전트 수수료 적용 전 금액
usage.agent_fee_amount_usd_micros생성 제출 응답모델 금액 위에 더해 청구되는 에이전트 수수료. 가격표가 다른 요율을 정하지 않으면 기본값 5.5%
usage.billable_amount_usd_micros생성 제출 응답모델 금액과 수수료의 합
usage.price_book생성 제출 응답discount_bps와 agent_fee_bps. 금액의 근거가 되는 조건
applied_model_estimated_usd_centsGET /v1/catalog, model_pricing[]적용 추정치의 모델 항목. 센트 단위로 올림
applied_agent_fee_estimated_usd_centsGET /v1/catalog, model_pricing[]적용 추정치의 에이전트 수수료 항목. 센트 단위로 올림

요청 하나의 수수료는 어떻게 읽나요?

합계로 읽으세요. billable_amount_usd_micros는 모델 금액과 수수료를 더한 값입니다. 기본 요율에서 모델 금액이 $2.00(2,000,000 micros)이면 수수료는 $0.11(110,000 micros)이고, 청구 금액은 $2.11(2,110,000 micros)입니다. 이 예시 금액은 설명을 위한 것이며 Sume 가격이 아닙니다.

  • micros는 정확한 저장을 위한 정수이며, 1,000,000 micros가 $1.00입니다. 인용할 값은 billable_amount_usd이고, 이 값은 항상 billable_amount_usd_micros / 1_000_000입니다.
  • billable_amount_usd_cents는 지갑 계산용으로 올림한 ceil(micros / 10_000) 센트입니다. 달러가 아닙니다.
  • price_book에는 금액의 근거가 되는 조건이 담깁니다. 워크스페이스 가격표가 있으면 그 가격표이고, 없으면 제품 기본 에이전트 수수료입니다. 그 안의 agent_fee_bps는 요율을 베이시스 포인트로 나타내므로, 기본값은 550입니다.
  • 카탈로그의 적용 합계는 micros 정밀도로 계산한 모델 금액과 수수료의 합이며, 센트 단위 항목은 각각 올림합니다.

Job이 실패하면 수수료도 환불되나요?

제출 시점의 예약에는 모델 금액과 수수료를 더한 Sume 청구 추정액이 저장됩니다. Sume는 Job이 완료되면 이를 확정하고, 실패했거나 생성 시작 전에 취소된 Job은 확정 전에 환불합니다. 예약, 확정, 환불의 흐름은 실패한 AI 영상 생성도 크레딧이 차감되나요?에서 설명합니다.

수수료가 따로 표시되지 않는 곳은 어디인가요?

일부 응답은 금액을 나누지 않고 합계 하나로 보고합니다.

  • Format 실행 영수증의 usage에는 billable_amount_usd_micros, debited_usd_micros, 열린 예약 금액, 환불 금액, 상한이 나오지만 수수료 필드는 없습니다. 이 합계들은 Sume API 실행 한 번에 든 비용에서 설명합니다.
  • /v1/videos Job은 폴링하면 usage.cost를 보고하며, 문서는 이 값을 Sume 청구 금액으로 정의합니다.
  • 완료된 POST /v1/images 응답은 usage.cost를 청구된 USD 금액으로 보고합니다. 이 경로의 30초 대기를 넘기는 생성은 대신 Job envelope를 반환합니다.
  • API 요금에는 기능별 공개 요율이 나와 있으며, 에이전트 수수료는 그 요율 위에 더해 청구됩니다.

출처

관련 글

요금제 카테고리의 다른 글

요금제 글 전체 보기

작성자 Sume