# 费用与充值 (/docs/developers/account/billing)



Praxis 采用按次计费模式——每次 API 调用按实际 token 用量计费，不调用不收费。

## 计费模式 [#计费模式]

| 项目       | 说明                      |
| -------- | ----------------------- |
| 计费方式     | 按次按 token，输入和输出分别计价     |
| 闲置费      | 无——不调用不产生费用             |
| 最低消费     | 无                       |
| 推理 token | 计入输出 token（推理模型的思维链也计费） |
| 免费额度     | 新账号自带 $1                |

各模型的具体单价见[模型目录](https://console.deepraxis.ai/models)。

## 充值 [#充值]

1. 打开 [控制台 → 资金账户](https://console.deepraxis.ai/billing)
2. 点「充值」
3. 选择金额和支付方式

充值后余额立即可用。

## 余额不足时 [#余额不足时]

当余额耗尽，API 调用会返回余额不足错误（HTTP 402 或类似错误码），不会静默降级。你的应用应处理这个错误并提示用户充值。

## 监控花费 [#监控花费]

* **实时**：API 响应中的 `usage.cost` 字段直接返回本次调用费用
* **汇总**：[控制台 → 用量与费用](https://console.deepraxis.ai/usage)按月/按资源聚合
* **逐笔**：用量明细页每一笔调用都有时间、模型、token 数和费用

## 常见问题 [#常见问题]

| 症状       | 原因           | 解法                                 |
| -------- | ------------ | ---------------------------------- |
| 调用返回 402 | 余额不足         | 到资金账户充值                            |
| 花费比预期高   | 推理 token 也计费 | 查看 `usage.reasoning_tokens`；换非推理模型 |
| 免费额度用完了  | —            | 充值继续使用                             |
