# 计费与用量
> 积分、创作与理解预付费、成功用量结算和退款。

积分是 Agent 调用 Beatra skills 时消耗的独立额度和计费单位，不存在固定的积分与法币汇率。各市场的充值套餐决定一笔付款获得多少积分；公开模型
价格决定一次操作消耗多少积分。

## 扣费方式

创作、语音、音色、音乐以及独立图片/视频理解任务都采用预付费。提交时按已接受的
任务价格扣下积分；最终用量可变的创作任务在成功后按实测用量结算。理解任务的完整
图片张数或向上取整的视频秒数在开始生成前已经确定，因此提交时扣下的积分就是精确金额。
公开社交数据读取（`beatra.social.execute`）同样预付费：价格为 6、12、30 或 60 积分，并在创建任务前确定。

余额不足以支付预付金额时，API 返回 `402 insufficient_balance`，任务不会创建。

## 同时做几个

| 套餐 | 同时做几个 |
| --- | ---: |
| 未买套餐 | 2 |
| 入门 | 4 |
| 进阶 | 6 |
| 专业 | 8 |
| 工作室 | 8 |

已经有这么多个在进行时，新请求不会开始、也不会扣费。等其中一个结束后用同一请求再试，或选能同时做更多的套餐。REST 的每分钟次数上限见限流页。

## 理解任务预付费

- `POST /v1/images/responses` 按已接受的 `image_count` 每张 5 积分计费，
  最多 8 张。
- `POST /v1/videos/responses` 按已接受的 `input_video_seconds` 每秒 0.4
  积分计费，毫秒向上取整到整秒。
- `detail` 和供应商 token 用量都不会改变价格。
- 理解任务失败，或取消得到确认时，提交时扣下的积分会按预付费退款原路退回。

## 预付费任务成功结算

当最终计费量取决于实际接收的媒体或上游输出时，提交时的扣款只是估算。
任务成功后，Beatra 使用提交时锁定的价格快照，按权威实测用量结算：

- 实际用量较少时，未使用的估算额计入 `refunded_credits`；
- 实际用量相同时，无需调整钱包；
- 在已接受的请求契约内，实际有效用量较多时，差额作为补扣计入
  `charged_credits`。

如果实测用量与其输入/输出拆分不一致，或超过已接受请求及模型的时长上限，
Beatra 不会将其记为实际用量，也不会补扣；提交时的原预扣保持不变，任务进入
待结算状态交由运营审查。

最终净扣费由 `billing.net_charged_credits` 直接返回（等于
`billing.charged_credits - billing.refunded_credits`）。成功任务的
超额用量可能使钱包余额低于零；产物仍然有效，但充值前不能创建新的付费任务。

## 失败自动退款

任务 `failed`，或取消得到确认且任务进入 `canceled` 时，预扣的积分 **自动原路退回**，无需申请。取消冲突表示任务仍在运行，不会触发退款：

```json
"billing": {
  "charged_credits": 48.0,
  "refunded_credits": 48.0,
  "net_charged_credits": 0.0
}
```

## 响应中的计费字段

每个任务响应都带：

| 字段 | 说明 |
| --- | --- |
| `usage.credits` | 成功任务最终净消耗的积分 |
| `usage.image_count` | 图片理解里接受的图片张数，或图片生成的成功输出张数 |
| `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` | 累计扣款 / 累计退款；两者相减得到最终净扣费 |

## 余额与充值

全球控制台的积分购买是一次性支付（卡、Apple Pay、Google Pay 或 Link）。在
[console.beatra.ai/wallet?intent=buy](https://console.beatra.ai/wallet?intent=buy) 查看余额并充值。

积分属于充值时登录的账号，Agent 只能用它连接的那个账号里的积分。充值页会写明「充值到：…」；你有两个账号时，见[账号与合并](https://docs.beatra.ai/zh/docs/accounts)。