2026-09-26요금제

AI 영상 한 편 생성 비용: Sume API 실행 한 번에 든 비용

Sume 실행이나 영상 Job 하나의 비용은 run_id나 job_id로 GET /v1/usage를 호출해 debited_usd를 읽으면 됩니다. 에이전트 턴을 포함한 지갑 차감액입니다.

읽는 시간 6분Sume

Sume에서 AI 영상 실행이나 Job 하나에 든 비용을 보려면 run_id(또는 job_id, thread_id)를 붙여 GET /v1/usage를 호출하고 summary.debited_usd를 읽으세요. 에이전트 자체의 LLM 턴까지 포함해, 그 범위에 대해 지갑에서 실제로 차감된 금액입니다. Format 실행 영수증의 usage.billable_amount_usd_micros는 지출 상한에 쓰이는 수치이지 총액이 아닙니다.

아래 필드는 2026-09-26에 확인한 Sume의 Usage와 실행과 결과 (영문) 페이지, 그리고 API 레퍼런스에서 가져왔습니다. 상한이 실행 전과 실행 중에 지출을 어떻게 제한하는지는 무인 AI 에이전트 지출 상한에서 다룹니다.

실행 한 번의 비용은 어떻게 확인하나요?

GET /v1/usage에 실행 ID를 넘기세요. 응답에는 그 범위가 만든 모든 원장 행을 접어 계산한 summary가 추가됩니다. limit(1–100)은 나열되는 행 수만 제한할 뿐, 합계는 제한하지 않습니다. 실행 범위는 Format, Action, Agent 실행 하나를 다루며, 그 실행의 생성 Job과 실행 스레드 자체의 턴 행을 포함합니다.

Format 실행 영수증의 usage 블록(debited_usd_micros, held_usd_micros, refunded_usd_micros, final)에도 같은 금액이 담깁니다. 같은 행을 같은 방식으로 접어 만들기 때문에 영수증과 원장은 어긋나지 않습니다.

curl "https://api.sume.com/v1/usage?run_id=arun_…&limit=50" \
  -H "Authorization: Bearer $SUME_API_KEY"

비용은 billable과 debited 중 어느 수치인가요?

비용처럼 보이는 필드가 여럿 있지만, 실제 비용은 하나뿐입니다.

Usage와 사용량 읽기 (영문) 기준, 2026-09-26 확인.
필드	집계 대상	비용 여부
영수증의 `billable_amount_usd_micros`	실행에 귀속된 예약 및 확정 생성 금액. 상한을 적용하는 기준 수치이며, 에이전트 자체의 LLM 턴은 빠짐	아니요. 상한용 수치
`debited_usd_micros`, `debited_usd`	지갑에서 차감된 금액. 모든 operation type의 확정된 원장 행이며, 에이전트 자체의 턴도 포함	예. 인용할 수치
`held_usd_micros`	아직 열려 있는 예약	아직 아님. 지출이 아님
`refunded_usd_micros`	실패, 취소, `queue_full` 뒤 되돌려진 예약	아니요. 지출이 아님
`final`	열린 예약이 없으면 `true`. 이후 `debited_usd_micros`는 바뀌지 않음	비용이 정산됐다는 표시
`cap`	실행의 경우: 생성 상한, 상한에 산입되는 금액, 남은 금액	어떤 경우에도 비용이 아님

영상 Job 하나에는 얼마가 들었나요?

대신 job_id를 넘기면 생성 Job 하나의 원장 행을 합산합니다. 에이전트 턴의 job id도 받으며, 이때는 턴 자체의 행과 그 턴이 만든 모든 Job을 합산합니다. 원장 행마다 run_id, thread_id, turn_job_id가 있어서, Job을 시작한 실행까지 거슬러 올라갈 수 있습니다.

OpenRouter 호환 영상 생성 (영문) 경로인 POST /v1/videos의 Job은 폴링 응답에 usage.cost도 보고합니다. 이 값은 Sume 과금 금액입니다.

micros와 센트를 달러로 어떻게 바꾸나요?

Sume는 미국 달러로 청구하며, 잔액은 USD 기준입니다. 금액은 세 가지 형태로 오므로, 문서에 나온 방식대로 변환하세요.

*_usd_micros는 정수이며, 1,000,000 micros가 $1.00입니다. 달러는 micros ÷ 1,000,000이고, 제출 응답의 billable_amount_usd에 담긴 값이 정확히 이것입니다.
micros를 10,000으로 나누면 달러가 아니라 센트가 나오므로 지출이 100배로 부풀려집니다. API 레퍼런스의 예시로, 133,061 micros는 $13.31이 아니라 $0.133061입니다.
제출 응답의 billable_amount_usd_cents는 지갑 계산용으로 올림한 ceil(micros / 10_000)입니다. 사용량 요약의 debited_usd_cents는 차감된 micros를 한 번 반올림(half-up)한 값으로, 반올림은 이때 한 번뿐이며, debited_usd는 그 수치를 달러로 나타낸 것입니다.
원장 행의 credit_amount와 잔액의 available_credits는 호환성을 위해 남겨 둔, 반올림한 USD 센트 단위의 레거시 값입니다.

재시도하거나 이어서 실행한 비용은 어떻게 합산하나요?

후속 실행(continuation)은 자체 영수증과 자체 usage를 가진 새 실행이며, 두 실행은 thread_id를 공유합니다. 대화 전체를 합산하려면 GET /v1/usage?thread_id=…를 조회하세요. 스레드 요약에는 실행별 금액을 담은 runs[]가 추가되고, by_operation_type은 같은 금액을 operation별로 나눕니다. 후속 실행 자체는 Sume API로 AI 영상의 장면 하나를 다시 생성하기에서 보여 줍니다.

원장 행을 직접 더하지 마세요. 환불된 행도 billable_amount_usd_micros에 예약 금액을 그대로 유지합니다. 행이 5,000개를 넘는 범위에서는 summary.truncated가 설정되며, 이때 수치는 가장 최근 행만 반영합니다.

실행 비용을 자체 청구 내역과 어떻게 맞춰 보나요?

실행을 재판매한다면 제품에 Format 임베드하기 (영문)가 권하는 대로, 고객에게는 자체 기록을 기준으로 청구하고 GET /v1/usage와 대조하세요. 만든 실행 ID를 모두 보관하고, 수치가 더 이상 바뀌지 않는 시점인 summary.final이 true가 된 뒤에 summary.debited_usd를 읽으면 됩니다. 실행의 에이전트 턴과 생성은 같은 잔액에서 차감됩니다. 지갑은 Sume 요금 체계에서 다룹니다.

출처

작성자 Sume