# 计费与充值

了解模型价格、元消耗、人民币充值订单以及如何核对实际账务状态。

## 两种金额不要混淆 [#两种金额不要混淆]

- **人民币金额（¥）**：充值订单向支付渠道提交的金额，例如 `custom_amount`；订单金额不是 API 调用的 Token 价格。
- **元**：账户用于模型用量结算的计费单位。模型使用扣减多少 元，取决于模型价格字段、实际用量、用户组折扣和适用的阶梯规则。

不要把充值金额直接当成同数值 元，也不要依赖固定兑换率或赠送比例。活动、套餐和实际到账以页面展示和对应流水为准。

## 模型价格如何影响消耗 [#模型价格如何影响消耗]

模型目录提供 `input_price`、`output_price`，可能还包含 `cache_price`、`pricing_rules` 和 `discount`。对话模型的这些价格字段及其相应输入/输出/缓存阶梯价格，单位为 **元/百万 Token**；网关按 Token 数乘单价并除以 1,000,000 结算，不能把目录数字理解成单 Token 价格。图片、视频等媒体模型按实际规则以张、秒或生成次数等计量，不沿用对话 Token 单价，也不在文档中承诺固定报价或人民币兑换率。

如果有 `pricing_rules`，输入和输出方向分别按其条件匹配价格档。已登录用户的价格还可能受到用户组折扣影响。文档不固定报价；调用前请查看[模型库](/models)，调用后用 元流水核实。

## 查看余额、用量和流水 [#查看余额用量和流水]

登录后在控制台查看：

- **财务**：账户余额入口、充值入口，以及订单明细和收支明细。
- **用量**：日用量汇总，可切换页面提供的时间范围。
- **调用日志**：逐次请求的时间、模型、状态、输入/输出 Token 和耗时等信息。

用量汇总、调用日志和账本流水是不同视图。金额或 Token 暂时不一致时，按请求时间和模型逐项核对，最终以实际账本流水和订单状态为准。不要仅凭响应中的预估值或界面提示推断最终扣费。

## 创建充值订单 [#创建充值订单]

当前业务 API 的充值请求在 `POST /api/v1/recharge/create`，需要控制台登录态认证。请求字段如下：

| 字段 | 类型 | 含义 |
| --- | --- | --- |
| `package_id` | number，可选 | 购买页面当前列出的充值套餐 ID |
| `custom_amount` | number，可选 | 自定义人民币金额；后端校验范围为 ¥10–¥100,000 |
| `payment_method` | string，必填 | 后端枚举为 `alipay` 或 `wechat`；实际可用方式以当前页面为准 |

套餐和自定义金额二选一。以下请求仅是字段格式示意，不会替你创建订单；请勿把此业务接口和模型调用 API Key 混用。

```http
POST /api/v1/recharge/create
Authorization: Bearer <控制台登录会话>
Content-Type: application/json

{
  "custom_amount": 10,
  "payment_method": "alipay"
}
```

如使用客户端集成，务必通过已登录的控制台会话发起请求；本页不提供登录令牌或令牌获取方式。


**提示**

创建订单不等于支付成功，支付成功也应以订单状态和对应的 元流水核对。充值回跳 URL、浏览器 query 参数或前端提示都不是付款到账证明。目前充值页面/支付闭环可能不完整；不要据此重复付款或自行认定余额已增加。


## 核对订单状态 [#核对订单状态]

控制台 **财务 → 订单明细** 展示充值订单号、人民币金额、支付状态、创建时间和支付时间；**财务 → 收支明细** 展示账本交易类型和余额变化。后端还提供按订单号查询状态的业务接口，但应通过控制台已认证环境使用。

当前前端的状态标识映射为 `0` 待支付、`1` 已支付、`2` 支付失败、`3` 已退款。请以对应订单返回的当前状态为准；不要用支付平台返回 URL 中的参数替代服务端订单核验。若显示已支付但没有相应到账流水，或订单状态不明确，请保留订单号并联系支持，不要再创建相同金额的重复订单。

## 卡密、失败与疑问 [#卡密失败与疑问]

财务页提供卡密兑换入口。卡密被拒绝时，以界面返回的实际错误为准，核查卡密是否输错、是否已使用或是否不符合当前规则；不要假设所有卡密共享固定面额或兑换上限。兑换后的 元变化应通过余额及收支明细核实。

模型调用失败不应被概括为统一的“不扣费”承诺：不同协议、请求阶段和结算/退款记录可能不同。遇到失败但有扣费疑问时，按请求时间、模型、状态和账本明细核对；以最终退款或扣费流水为准。

## 相关链接 [#相关链接]

- [模型价格与阶梯字段](/models)
- [控制台用量与调用记录](/docs/usage-logs)
- [开始使用](/docs/quickstart)
- [充值规则](/legal/recharge)