指南
计费与余额
了解预付余额、生成任务价格的冻结与结算、失败任务自动退款、自动充值,以及如何通过 API 查询余额。
CheaperGen 采用 预付费和按量付费。你可以用美元充值额度,每次生成都会从余额中扣款,只有成功生成内容才会收费。无需订阅;可选的月度套餐会自动添加额度,也可能降低价格;并且不按席位收费,也没有平台费。
余额充值#
- 在 控制面板 → 账单 中使用银行卡充值积分(金额特别大时,也可以在控制台使用银行转账)。付款由 Stripe 处理,成功后积分会立即到账。
- 额度永不过期。
- 一个余额即可用于所有模型、API 和 Studio。
- 每笔付款的收据都可以在控制面板中查看。企业账户也可以选择按月开票,详情请参阅 企业方案。
- 充值余额为预付金额,除法律要求外不予退款;详情请参阅 服务条款。生成失败或取消时,冻结金额始终会退回余额。
生成任务如何计费#
- 查询价格。 提交请求时,我们会根据输入(视频分辨率和时长、图像尺寸和数量)以及模型公开价格计算费用。
- 冻结金额。 提交后,冻结金额会立即从余额中扣除,生成任务随后加入队列。如果余额不足,请求会返回
402 insufficient_balance,且不会扣款。 - 结算。 生成成功后,冻结金额会转为最终费用。实际用量与报价不一致时,差额会作为调整项入账。
- 退款。 生成失败,或队列中的任务被取消时,冻结金额会自动全额退回余额。
每个生成任务都会报告费用。任务进行中时,该金额为冻结金额,estimated 为 true;结算后,estimated 为 false:
{
"status": "succeeded",
"cost": {
"amount_usd": 0.4494,
"currency": "usd",
"estimated": false
}
}计价单位#
- 视频 按所选分辨率下每秒输出计价。10 秒视频的价格是 5 秒视频的两倍。
- 图像 按所选尺寸逐张计价;
num_images: 4对应四张图像的价格。 - Seedance 模型与官方 API 一样,按视频 Token 计费:
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_price_source 的取值规则是:当 list_usd 为开发者自己的标价时取 official;当它是我们用来比较的另一种价格时取 reference,价格来源由 list_price_label 标明(例如 fal API,用于模型开发者没有面向国际市场销售 API 的情况)。
参考视频的计费#
使用 reference-to-video 模式时,参考视频时长会与输出视频时长一起计费,规则与官方 API 相同:
- Seedance(2.0、2.0 Fast、2.0 Mini、2.5):Token 数 =(参考视频秒数 + 输出视频秒数)× 宽度 × 高度 × 24 ÷ 1024,采用较低的 视频输入 Token 费率,因此含视频输入的请求总价更高,但每秒价格更低。
- Wan 3.0、Wan 3.0 Prime 和 MiniMax H3:参考视频按与输出视频相同的每秒费率计费。
提交时,我们会在服务器上测量每段参考文件的实际时长,而不是采用请求中提供的时长,并按测得的时长冻结金额。生成任务的 cost.reference_video_seconds 字段会显示计入的秒数。每计费秒(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 会测量实际文件并按相应价格冻结余额。Playground 会在浏览器中读取时长并执行相同操作。
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 | 通过银行转账(电汇 / ACH)或银行卡结账以外的其他方式付款(例如 WeChat Pay 或 Alipay)后,资金到账时会添加相应积分。账单中显示为“银行 / 线下付款”,并附有发票。如果此类付款被撤销,会添加一条负数记录扣回积分,并开具贷项通知单冲销原发票。 |
有不清楚或缺少的内容?发邮件至 support@cheapergen.com——我们会认真阅读每一封邮件。