# 计费与账单 (/docs/user/help/billing)



# 计费与账单 [#计费与账单]

LocoPal 的余额、套餐、消费与账单都集中在 **LocoPal Ai 的账户**里。Creation
不单独收费，它的消耗统一计入同一个账户。

## 计费方式 [#计费方式]

不同模型按不同方式计费，具体以模型广场的详情页展示为准。

| 计费方式        | 含义                                        | 常见于        |
| ----------- | ----------------------------------------- | ---------- |
| 按 Token     | 按输入与输出 Token 分别计费，单位显示为 `1K` 或 `1M` Token | 文本对话、多模态理解 |
| 缓存输入 / 缓存写入 | 仅支持提示词缓存的模型会显示                            | 支持缓存的文本模型  |
| 按次          | 每次成功请求按固定价格计费                             | 部分图片模型     |
| 按量 / 按时长    | 按分辨率、时长或模型定义的计量单位计费                       | 视频、音频      |

视频模型（如 `doubao-seedance`、`seedance` 系列）会显示独立的**价格矩阵**，
按「是否含视频输入」和「输出分辨率」拆分。阅读时先确定本次是否提交视频输入，
再选择需要的分辨率：

* 只上传文字或图片参考 → 看「不含视频输入」一栏；
* 提交视频作为输入 → 看「含视频输入」一栏；
* 不支持的组合会明确标注「不支持」；未展示的档位不要按相邻档位推测。

## 结算时点 [#结算时点]

这是最容易产生误解的一点，请区分同步接口和异步任务。

| 类型             | 结算方式                                       |
| -------------- | ------------------------------------------ |
| 同步调用（文本、图片、音频） | 请求成功返回后计入用量                                |
| 异步任务（视频）       | **完成时结算**：提交只受理任务，不预先扣费；任务完成后账单里出现一条实际扣费记录 |

异步任务的关键行为：

* 提交前平台会校验账户余额（或当前 Key 的额度）能否覆盖本次**预估**消耗；
  不足时会直接返回可读提示，**不会创建任务**；
* 任务执行中不会产生中间扣费；
* **查询任务状态不产生费用**，只有创建任务才计费；
* 失败任务的计费按该模型与平台价格配置处理。

## 余额与校验 [#余额与校验]

* 调用前平台会校验余额是否覆盖预估消耗，不足时返回提示而不是创建任务；
* 文本模型的预估按输入长度估算，实际以响应里的 `usage` 为准；
* 图像、视频等按次或按时长计费，预估与实际通常在模型支持范围内一致；
* 建议在业务后端对余额不足做**前置判断和友好提示**，不要把余额校验完全交给平台返回的错误。

## 在哪里核对 [#在哪里核对]

| 想看什么                    | 去哪                 |
| ----------------------- | ------------------ |
| 余额、充值、套餐、订单             | LocoPal Ai 控制台「钱包」 |
| 每一次同步调用的明细（模型、Token、费用） | 「使用日志」             |
| 异步任务状态、进度与制品            | 「任务日志」             |
| 模型价格与计费方式               | 「模型广场」             |

钱包提供充值、套餐与权益兑换；模型广场提供估算价格；账单提供最终结算。三者用途不同，
**价格展示不等于最终扣费**。

## 核对异常扣费 [#核对异常扣费]

按以下顺序定位，不要凭感觉判断：

1. **确定时间范围**：先缩小到出问题的那段时间；
2. **找到任务或请求标识**：异步任务用任务 ID，同步调用用请求 ID；
3. **确认模型**：用模型 ID（不是显示名称）确认是哪个模型产生的；
4. **对照用量与单价**：文本对比 `usage` 的输入输出 Token；视频对比分辨率、时长与输入类型；
5. **检查是否重复提交**：异步任务最常见的异常是多创建了一次任务，而不是单价错误。

完成上述定位后，再联系平台支持并提供这些信息。**不要提供完整密钥。**

## 控制消耗 [#控制消耗]

* **按应用拆 Key**：生产服务、测试环境、客户应用分别创建，便于定位消耗来源；
* **给 Key 设额度与有效期**：限制异常消耗的影响范围；
* **选对模型**：同样的任务用更小的模型往往能显著降低成本；
* **避免重复提交**：异步任务保存任务 ID，用查询而不是重新创建来跟踪进度；
* **及时转存结果**：图片和视频的返回地址可能是短期的，过期后需要重新生成。

## 常见误解 [#常见误解]

| 误解               | 事实                      |
| ---------------- | ----------------------- |
| 「提交视频任务就扣费了」     | 异步任务在完成时结算，提交不预先扣费      |
| 「一直查询会重复计费」      | 查询不产生费用，重复**创建**才会      |
| 「价格卡片就是最终价格」     | 卡片用于估算，实际以账单为准          |
| 「Creation 要另外充值」 | 两个平台共用同一个账户额度           |
| 「400 报错也扣费」      | 参数校验失败通常不产生生成任务费用       |
| 「换模型要重新上传素材」     | 素材只需入库一次，同一素材 ID 可跨模型复用 |