计费与充值
了解模型价格、元消耗、人民币充值订单以及如何核对实际账务状态。
两种金额不要混淆
- 人民币金额（¥）：充值订单向支付渠道提交的金额，例如
custom_amount；订单金额不是 API 调用的 Token 价格。 - 元：账户用于模型用量结算的计费单位。模型使用扣减多少 元，取决于模型价格字段、实际用量、用户组折扣和适用的阶梯规则。
不要把充值金额直接当成同数值 元，也不要依赖固定兑换率或赠送比例。活动、套餐和实际到账以页面展示和对应流水为准。
模型价格如何影响消耗
模型目录提供 input_price、output_price，可能还包含 cache_price、pricing_rules 和 discount。对话模型的这些价格字段及其相应输入/输出/缓存阶梯价格，单位为 元/百万 Token；网关按 Token 数乘单价并除以 1,000,000 结算，不能把目录数字理解成单 Token 价格。图片、视频等媒体模型按实际规则以张、秒或生成次数等计量，不沿用对话 Token 单价，也不在文档中承诺固定报价或人民币兑换率。
如果有 pricing_rules，输入和输出方向分别按其条件匹配价格档。已登录用户的价格还可能受到用户组折扣影响。文档不固定报价；调用前请查看模型库，调用后用 元流水核实。
查看余额、用量和流水
登录后在控制台查看：
- 财务：账户余额入口、充值入口，以及订单明细和收支明细。
- 用量：日用量汇总，可切换页面提供的时间范围。
- 调用日志：逐次请求的时间、模型、状态、输入/输出 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 混用。
POST /api/v1/recharge/create
Authorization: Bearer <控制台登录会话>
Content-Type: application/json
{
"custom_amount": 10,
"payment_method": "alipay"
}如使用客户端集成，务必通过已登录的控制台会话发起请求；本页不提供登录令牌或令牌获取方式。
创建订单不等于支付成功，支付成功也应以订单状态和对应的 元流水核对。充值回跳 URL、浏览器 query 参数或前端提示都不是付款到账证明。目前充值页面/支付闭环可能不完整；不要据此重复付款或自行认定余额已增加。
核对订单状态
控制台 财务 → 订单明细 展示充值订单号、人民币金额、支付状态、创建时间和支付时间；财务 → 收支明细 展示账本交易类型和余额变化。后端还提供按订单号查询状态的业务接口，但应通过控制台已认证环境使用。
当前前端的状态标识映射为 0 待支付、1 已支付、2 支付失败、3 已退款。请以对应订单返回的当前状态为准；不要用支付平台返回 URL 中的参数替代服务端订单核验。若显示已支付但没有相应到账流水，或订单状态不明确，请保留订单号并联系支持，不要再创建相同金额的重复订单。
卡密、失败与疑问
财务页提供卡密兑换入口。卡密被拒绝时，以界面返回的实际错误为准，核查卡密是否输错、是否已使用或是否不符合当前规则；不要假设所有卡密共享固定面额或兑换上限。兑换后的 元变化应通过余额及收支明细核实。
模型调用失败不应被概括为统一的“不扣费”承诺：不同协议、请求阶段和结算/退款记录可能不同。遇到失败但有扣费疑问时，按请求时间、模型、状态和账本明细核对；以最终退款或扣费流水为准。