가이드
결제 및 크레딧
선불 크레딧, 생성 요금의 보류 및 정산, 실패 작업 자동 환불, 자동 충전, API로 잔액 확인하기
CheaperGen은 선불로 충전하고 사용량에 따라 결제하는입니다. 미국 달러로 크레딧을 충전하면 생성할 때마다 해당 잔액에서 결제되며, 생성에 성공한 경우에만 요금이 청구됩니다. 구독은 필요하지 않습니다. 선택형 월간 요금제를 이용하면 크레딧이 자동으로 추가되고 가격을 낮출 수 있으며, 좌석 요금이나 플랫폼 수수료도 없습니다.
크레딧#
- 대시보드 → 결제에서 카드로 크레딧을 충전하세요. 큰 금액은 대시보드에서 은행 송금도 이용할 수 있습니다. Stripe에서 결제를 처리하며, 결제가 완료되면 잔액에 즉시 반영됩니다.
- 크레딧은 만료되지 않습니다.
- 잔액 하나로 모든 모델, API 및 Studio를 이용할 수 있습니다.
- 모든 결제 영수증은 대시보드에서 확인할 수 있습니다. 엔터프라이즈 계정은 월별 청구서 결제도 가능합니다. 자세한 내용: Enterprise.
- 법에서 요구하는 경우를 제외하면 선불 크레딧은 환불되지 않습니다. 자세한 내용은 이용약관을 참고하세요. 실패하거나 취소된 생성은 항상 잔액으로 환불됩니다.
생성 요금 계산 방식#
- 견적. 요청을 제출하면 입력값 (동영상은 해상도와 길이, 이미지는 크기와 장수)을 바탕으로 모델 공개 가격을 기준으로 비용을 계산합니다.
- 보류. 계산된 금액이 잔액에서 즉시 차감되고 생성 작업이 대기열에 들어갑니다. 잔액이 부족하면
402 insufficient_balance오류가 반환되며 요금은 청구되지 않습니다. - 정산. 생성이 성공하면 보류 금액이 최종 청구액이 됩니다. 실제 사용량이 견적과 다르면 차액이 조정됩니다.
- 환불. 생성에 실패하거나 대기 중 취소하면 보류 금액이 전액 자동 환불됩니다.
각 생성 응답에는 비용이 포함됩니다. 작업 진행 중에는 금액이 보류 상태이며 estimated 값은 true입니다. 최종 완료 후에는 estimated 값이 false입니다:
{
"status": "succeeded",
"cost": {
"amount_usd": 0.4494,
"currency": "usd",
"estimated": false
}
}가격 단위#
- 동영상은 선택한 해상도의 출력 길이를 기준으로 초당 요금이 부과됩니다. 10초 클립은 5초 클립의 두 배입니다.
- 이미지는 선택한 크기를 기준으로 이미지 한 장당 요금이 부과됩니다. 요청에서
num_images: 4로 지정하면 이미지 4장에 해당하는 비용이 청구됩니다. - Seedance 모델은 공식 API와 동일하게 동영상 토큰으로 과금합니다:
tokens = seconds × width × height × 24 ÷ 1024. 사이트 가격은 16:9 기준 초당 가격으로 환산되어 있으며 다른 화면 비율에서는 조금 달라집니다. - 참조 동영상은 과금 대상 초를 늘립니다. 자세한 내용은 아래에서 확인하세요. 참조 이미지와 오디오는 가격에 영향을 주지 않습니다.
- 가격은 소수점 네 자리까지 표시하며 요청당 가장 가까운 $0.0001 단위로 올림 처리합니다.
모든 모델과 요금 등급의 전체 가격표는 가격 페이지에서 확인할 수 있습니다.
실행 전 비용 예상하기#
POST /api/v1/quote/{endpoint}은 실행하지 않고도 입력의 가격을 계산합니다. API 키가 필요하지 않으며 프롬프트와 이미지 같은 콘텐츠 필드는 무시합니다. 예를 들어 이 설정에서 Seedance 2.0 Fast의 비용은 $0.45입니다:
curl -X POST https://cheapergen.com/api/v1/quote/bytedance/seedance-2.0-fast/text-to-video \
-H "Content-Type: application/json" \
-d '{"aspect_ratio":"16:9","resolution":"720p","duration":5}'{
"amount_usd": 0.4494,
"list_usd": 0.6048,
"list_price_source": "official",
"list_price_label": "Official",
"discount_pct": 26,
"available": true,
"currency": "usd"
}amount_usd은(는) 결제할 금액, list_usd은(는) 같은 요청의 정가, discount_pct는 절감률입니다. list_usd가 개발사의 자체 정가일 때 list_price_source은(는) official이고, 비교에 사용하는 다른 가격일 때는 list_price_label이(가) 명시한 가격(fal API 등)인 reference입니다. 개발사가 국제 API를 판매하지 않는 모델이 그 예입니다.
참조 동영상#
reference-to-video 모드에서는 공식 API와 같은 방식으로 참조 동영상 길이와 출력 길이를 합산해 청구합니다:
- Seedance (2.0, 2.0 Fast, 2.0 Mini, 2.5): tokens = (참조 동영상 초 + 출력 초) × width × height × 24 ÷ 1024입니다. 참조 동영상이 있는 요청은 총 요금이 늘지만 초당 단가는 낮아집니다. 동영상 입력용 토큰 요율은 더 낮게 책정됩니다.
- Wan 3.0, Wan 3.0 Prime 및 MiniMax H3: 참조 동영상 초는 출력 영상과 같은 초당 요율로 청구됩니다.
요청을 제출하면 서버에서 각 참조 파일을 측정합니다. 요청에 입력된 예상값은 사용하지 않습니다. 실제 길이에 따른 가격을 보류하며 생성의 cost.reference_video_seconds에서 포함된 초를 확인할 수 있습니다. 과금 대상 1초 기준 (참조 동영상 5초 + 출력 5초, 16:9):
| 모델 | 등급 | 공식 가격 | CheaperGen |
|---|---|---|---|
| Seedance 2.0 | 480p | $0.0411 | |
| Seedance 2.0 | 720p | $0.0883 | |
| Seedance 2.0 | 1080p | $0.2170 | |
| Seedance 2.0 | 4K | $0.4433 | |
| Seedance 2.5 | 480p | $0.0585 | |
| Seedance 2.5 | 720p | $0.1314 | |
| Seedance 2.5 | 1080p | $0.3232 | |
| Seedance 2.0 Fast | 480p | $0.0298 | |
| Seedance 2.0 Fast | 720p | $0.0539 | |
| Seedance 2.0 Mini | 480p | $0.0178 | |
| Seedance 2.0 Mini | 720p | $0.0382 | |
| Wan 3.0 | 480p | $0.0379 | |
| Wan 3.0 | 720p | $0.0757 | |
| Wan 3.0 | 1080p | $0.1513 | |
| Wan 3.0 Prime | 480p | $0.0582 | |
| Wan 3.0 Prime | 720p | $0.1198 | |
| Wan 3.0 Prime | 1080p | $0.2394 | |
| MiniMax H3 | 768P | $0.0570 | |
| MiniMax H3 | 2K | $0.1068 | |
| MiniMax H3 Fast | 480P | $0.0369 | |
| MiniMax H3 Fast | 768P | $0.0546 |
참조 동영상이 있는 요청 비용 예상하기#
/quote는 파일을 다운로드하지 않습니다. 예상 클립 길이를 초 단위로 클립마다 하나씩 reference_video_durations로 전달하세요 (선택 사항: reference_audio_durations). 추정값이므로 /run에서 실제 파일 길이를 측정해 가격을 보류합니다. 플레이그라운드에서도 브라우저에서 길이를 읽어 같은 방식으로 처리합니다.
curl -X POST https://cheapergen.com/api/v1/quote/bytedance/seedance-2.0/reference-to-video \
-H "Content-Type: application/json" \
-d '{"resolution":"720p","duration":5,"reference_video_durations":[4.2,3]}'{
"amount_usd": 1.076479,
"list_usd": 1.133136,
"list_price_source": "official",
"list_price_label": "Official",
"discount_pct": 5,
"available": true,
"currency": "usd",
"reference_video_seconds": 7.2
}자동 충전#
자동 충전을 설정하면 잔액 부족으로 운영 작업이 402 상태가 되는 일을 막을 수 있습니다. 대시보드 → 결제에서 카드를 저장하고 충전 기준액 자동 충전 기준액와 충전 금액 금액을 선택하세요. 결제 후 잔액이 기준액 아래로 내려가면 저장된 카드로 선택한 금액을 결제해 잔액에 추가합니다.
자동 충전 결제가 실패하면
자동 충전이 일시 중지되면 대시보드에 사유가 표시됩니다. 잔액이 소진될 때까지 생성 작업은 계속되며, 이후에는402 insufficient_balance 오류가 반환됩니다. 다시 시작하려면 카드를 업데이트하세요.월간 요금제#
종량제 이용에는 요금제가 필요하지 않습니다. 매월 생성한다면 요금제를 통해 크레딧을 자동으로 추가하고 가격을 낮출 수 있습니다.
- Starter — 월 $99, 결제 금액 전액이 잔액에 크레딧으로 추가됩니다, 일반 가격 적용.
- Pro — 월 $499, 결제 금액 전액이 잔액에 크레딧으로 추가됩니다, 그리고 대부분 모델의 더 낮은 Pro 가격.
- Max — 월 $4,999, 결제 금액 전액이 잔액에 크레딧으로 추가됩니다, 그리고 대부분 모델의 더 낮은 Max 가격.
요금제 크레딧은 이월되며 다른 크레딧과 마찬가지로 만료되지 않습니다. 요금제는 취소할 때까지 매월 갱신되며, 취소하면 이미 결제한 달이 끝날 때 종료됩니다. 상위 요금제로 변경하면 즉시 새 달이 시작되고, 새 요금제 가격에서 현재 달의 남은 금액을 뺀 차액을 결제합니다(남은 금액은 크레딧으로 적립). 하위 요금제로 변경하면 즉시 적용되며 다음 달부터 새 요금제 가격이 청구됩니다. Pro 또는 Max 요금제가 활성화된 동안 대부분 모델의 가격이 낮아집니다. 할인 폭은 모델마다 다르며 각 모델 페이지에서 요금제 가격을 확인할 수 있습니다. 안전 검사기를 끈 요청에는 해당 모델의 자체 가격이 적용되며 요금제 할인이 적용되지 않습니다. 요금제 가격이 적용된 요청은 견적과 생성 결과에 custom_price: true, volume_level이 반환되고, GET /api/v1/account/pricing에서 요금제를 확인할 수 있습니다. 대시보드 → 결제에서 관리하세요. 더 필요한가요? 맞춤 가격 맞춤 가격을 협의할 수 있습니다.
요금제 때문에 요청 가격이 일반 가격보다 높아지지는 않습니다. 적용 가능한 요금제 가격은 각 모델 페이지에 표시되며, 해당 용량을 사용할 수 없어도 같은 가격으로 처리할 다른 용량이 있으면 그 가격이 유지됩니다. 그렇지 않으면 새 요청에는 요금제 가격과 일반 가격(종량제 계정에 적용되는 가격) 사이의 금액을 안내합니다. 종량제에 일반 가격이 적용되는 경우 비상 가격은 사용하지 않습니다. 요금제 가격으로 이미 접수한 작업은 이후 용량에 문제가 생기면 표준 가격을 넘지 않는 선에서 더 비싼 다른 용량으로 전환될 수 있습니다. 이 동작은 REST API와 MCP에 적용되며 요청에 allow_fallback_price: false을(를) 보낸 경우는 제외되고, max_cost_usd 이내에만 가능합니다. 전환할 때 추가 금액을 보류하며, 생성 결과의 pricing에는 더 이상 volume_level이(가) 표시되지 않습니다. Studio 작업은 클릭할 때 표시된 가격보다 더 청구되지 않습니다. 용량 문제가 생기면 작업이 실패 처리되고 전액 환불됩니다.
잔액 확인#
GET /api/v1/account은 잔액, 이미지 크레딧 및 자동 충전 설정을 반환합니다.
curl https://cheapergen.com/api/v1/account \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"{
"object": "account",
"email": "you@company.com",
"balance_usd": 42.5,
"image_credit_usd": 0,
"reserved_usd": 1.2,
"auto_topup": {
"enabled": true,
"threshold_usd": 10,
"amount_usd": 50
},
"limits": {
"unlimited": false,
"concurrent_generations": 20,
"in_flight": 3,
"requests_per_second": 10,
"burst": 20,
"tier": null
}
}balance_usd— 지금 사용할 수 있는 금액입니다. 진행 중인 생성에 보류된 금액은 이미 차감되어 있습니다.image_credit_usd— 이미지 전용 크레딧(예: 가입 환영 크레딧)입니다. 이미지 생성에 잔액보다 먼저 사용되며 동영상에는 사용할 수 없습니다.reserved_usd— 대기 중이거나 실행 중인 생성 작업으로 인해 현재 잔액에서 보류된 총액입니다. 작업이 끝나면 요금으로 청구되거나 환불됩니다.
거래 내역#
잔액 변경 내역은 대시보드 → 결제의 원장에 기록되며 각 항목 이후 잔액도 표시됩니다:
| 항목 | 의미 |
|---|---|
TOPUP | 카드로 충전한 크레딧입니다. |
AUTO_TOPUP | 자동 충전으로 충전된 크레딧입니다. |
CHARGE | 생성 요청을 제출할 때 보류된 금액입니다(음수). |
REFUND | 보류 금액 환불: 생성이 실패하거나 취소되면 전액, 시작 전에 가격이 내려가면(긴급 가격으로 보류된 채 대기하던 생성) 차액이 환불됩니다. |
ADJUSTMENT | CheaperGen이 선의의 제공이나 정정 등의 사유로 잔액에 추가한 크레딧 또는 잔액 정정입니다. 충전 크레딧처럼 사용할 수 있지만 결제 금액이 아니므로 인보이스가 발행되지 않습니다. |
PROMO | 당사가 제공하는 프로모션 또는 감사 크레딧입니다. 이미지 크레딧(예: 가입 환영 크레딧)은 이미지 모델에만 사용할 수 있고 동영상에는 사용할 수 없습니다. 잔액과 별도로 관리되며, 이미지 생성에 잔액보다 먼저 사용되고 환불 시 이미지 크레딧으로 반환됩니다. |
BANK_TRANSFER | 은행 송금(wire / ACH)이나 카드 결제창 외부에서 진행한 WeChat Pay, Alipay 등의 결제가 완료되면 잔액에 추가되는 크레딧입니다. 인보이스와 함께 “은행 / 오프라인 결제”로 표시됩니다. 결제가 취소되면 마이너스 내역으로 금액을 회수하고 크레딧 노트로 기존 인보이스를 취소합니다. |
궁금한 점이나 빠진 내용이 있나요? support@cheapergen.com로 이메일을 보내 주세요. 모든 의견을 읽고 있습니다.