실패한 AI 영상 생성도 크레딧이 차감되나요? 예약·확정·환불

아닙니다. Sume에서 실패한 AI 영상 생성 Job은 과금되지 않습니다. Sume는 요청을 접수할 때 Job의 예상 비용을 예약(선차감)하고, Job이 완료될 때만 사용량을 확정하며, Job이 실패하거나 생성 시작 전에 취소되면 예약을 해제하거나 환불합니다.

Sume는 미국 달러로 청구하므로 여기서 "크레딧"은 USD를 뜻합니다. 잔액은 USD 기준이며, 호환용 필드는 반올림한 센트 값을 크레딧으로 보여 줄 수 있습니다. 아래 수명주기는 2026-09-26에 확인한 Generation admission, 핵심 개념, Job과 결과 (영문), Usage 문서에서 가져왔습니다.

Job을 제출하면 금액은 어떻게 처리되나요?

유료 생성에는 공개된 Sume USD 추정치가 쓰입니다. Sume는 제출을 접수하면 워크스페이스 잔액에서 추정 금액을 예약하며, 예약된 금액은 아직 지출이 아닙니다. 이어서 Job이 실행되고, 사용량은 성공하면 확정되고 확정 전에 실패하거나 취소되면 환불됩니다. 문서는 단계를 다음 순서로 정리합니다.

client submit
  -> Sume validates API key and request
  -> optional usage reservation
  -> provider-backed execution
  -> artifact mirroring to media.sume.com
  -> usage capture or refund
  -> terminal webhook delivery when configured
  -> result available from /v1/jobs/:id/result

어떤 결과에는 비용이 들지 않나요?

예약을 확정하는 것은 완료된 Job뿐입니다. 다른 결과는 모두 예약을 돌려주거나, 애초에 예약을 잡지 않습니다.

Job을 취소해서 비용을 내지 않을 수 있나요?

네, 생성이 시작되지 않았다면 가능합니다. POST /v1/jobs/:id/cancel은 생성 작업이 시작되기 전에만 성공하므로, 더 이상 필요 없는 대기 중인 Job은 처리가 시작되기 전에 취소하세요. 생성이 시작된 뒤에는 이미 생성에 제출된 작업을 사용량 정산이 환불하지 않도록, API가 409 job_generation_already_started와 details.cancelable: false로 취소를 거부합니다. 이미 canceled인 Job을 다시 취소하는 것은 멱등입니다.

Job, Format 실행, 에이전트 실행은 취소 방식이 서로 다릅니다. Sume API로 AI 영상 Job이나 실행 취소하기에서 비교합니다.

curl -X POST https://api.sume.com/v1/jobs/job_123/cancel \
  -H "Authorization: Bearer $SUME_API_KEY"

실패한 Job이 환불됐는지 어떻게 확인하나요?

Job을 조회하세요. 사용량 원장 행이 있으면 GET /v1/jobs/:id에 usage_summary가 담깁니다. 그 status는 reserved, captured, refunded 중 하나입니다. usage_summary는 예약·확정·환불·해제된 금액을 USD micros와 센트로 나열하며, 예약이 확정되거나 해제되면 final이 true가 됩니다. 해제된 금액은 예약이 돌려준 금액이며, 원래 크레딧 묶음(lot)이 해제 전에 만료되면 실제로 복구되는 사용 가능 잔액은 다를 수 있습니다. 필드는 API 레퍼런스에 있습니다.

원장을 조회하는 방법도 있습니다. job_id를 붙여 GET /v1/usage를 호출하면 그 Job을 합산합니다. refunded_usd_micros는 실패, 취소, queue_full 뒤 되돌려진 예약을 세며 지출이 아니고, debited_usd는 지갑에서 차감된 금액입니다. 환불된 행도 billable_amount_usd_micros에 예약 금액을 그대로 유지하므로, 행을 직접 더하지 마세요.

curl "https://api.sume.com/v1/usage?job_id=job_123" \
  -H "Authorization: Bearer $SUME_API_KEY"

실패한 Format 실행에도 비용이 드나요?

들 수 있습니다. 무인 AI 에이전트 지출 상한에서 설명하듯, 실패 전에 끝난 생성은 과금된 채로 남습니다. 일부 실패 코드는 아무것도 과금되지 않았다고 명시합니다. mcp_unavailable에는 details.charged: false가 담깁니다.

Format 실행은 여러 생성 Job을 시작할 수 있는 에이전트 턴 하나이므로, Job 하나가 아니라 실행 전체의 합계를 확인하세요. Format 실행 영수증의 usage.debited_usd_micros를 보거나, Action과 Agent 실행도 합산하는 GET /v1/usage?run_id=를 쓰면 됩니다.

재시도하면 두 번 과금되나요?

키를 재사용하면 그렇지 않습니다. 같은 Idempotency-Key를 담은 제출은 재시도해도 괜찮습니다. 재시도는 두 번째 Job을 청구하는 대신 원래 Job을 돌려줍니다. 로컬 워커가 타임아웃됐다는 이유만으로 유료 요청을 다시 제출하지 말고, Job ID를 보관해 폴링하세요. 키 설계는 AI 영상 API 멱등성 키에서 다룹니다.