计费与用量
credits、skill 执行的预付费、余额不足与自动退款。
Credits 是 Agent 调用 Beatra skills 时消耗的独立额度和计费单位,不存在固定的 credits 与法币汇率。各市场的充值套餐决定一笔付款获得多少 credits;公开模型 价格决定一次操作消耗多少 credits。
扣费方式
所有付费 skill 执行——图像、视频、音频、音乐——都是预付费任务:提交时按
任务估价预扣,用量可变任务在成功后按实测用量结算。余额不足以覆盖估价时,
API 返回 402 insufficient_balance,任务不会创建。
预付费任务成功结算
当最终计费量取决于实际接收的媒体或上游输出时,提交时的扣款只是估算。 任务成功后,Beatra 使用提交时锁定的价格快照,按权威实测用量结算:
- 实际用量较少时,未使用的估算额计入
refunded_credits; - 实际用量相同时,无需调整钱包;
- 在已接受的请求契约内,实际有效用量较多时,差额作为补扣计入
charged_credits。
如果实测用量与其输入/输出拆分不一致,或超过已接受请求及模型的时长上限, Beatra 不会将其记为实际用量,也不会补扣;提交时的原预扣保持不变,任务进入 待结算状态交由运营审查。
最终净扣费由 billing.net_charged_credits 直接返回(等于
billing.charged_credits - billing.refunded_credits)。成功任务的
超额用量可能使钱包余额低于零;产物仍然有效,但充值前不能创建新的付费任务。
失败自动退款
任务 failed,或取消得到确认且任务进入 canceled 时,预扣的 credits 自动原路退回,无需申请。取消冲突表示任务仍在运行,不会触发退款:
响应中的计费字段
每个任务响应都带:
| 字段 | 说明 |
|---|---|
usage.credits | 成功任务最终净消耗的 credits |
usage.video_seconds | 结算后的权威输出计费秒数(等于 usage.output_video_seconds;计费的输入分量单独在 input 字段报告) |
usage.input_video_seconds / usage.output_video_seconds | 可用时的权威输入/输出秒数拆分;null 表示没有权威拆分,不能按 0 推断 |
billing.net_charged_credits | 实际用量结算与退款后的最终钱包净扣费 |
billing.charged_credits / billing.refunded_credits | 累计扣款 / 累计退款;两者相减得到最终净扣费 |
余额与充值
控制台 console.beatra.ai → Billing 查看余额、流水和充值。