积分与账单
介绍积分(credits)的构成、充值档位的「购买 + 赠送」规则、订阅特权免扣,以及在哪里查看账单与交易明细。
积分的构成
团队积分余额由三部分构成:
| 分项 | 来源 | 到账方式 |
|---|---|---|
| 订阅赠送(subscription grant) | 订阅套餐按期发放 | 订阅生效/续期时入账 |
| 充值购买(purchase) | 充值档位中「购买」的部分 | 支付回调后入账 |
| 充值赠送(topup grant) | 充值档位中「赠送」的部分 | 与购买同笔支付一起入账 |
积分的消耗优先级、过期规则等由平台计费配置决定;其中充值赠送部分按自然月月底过期(当月充值的赠送积分月底清零),购买与订阅赠送部分以账单页展示为准。
充值档位(买 X 送 Y)
充值不是单一价格:每个档位标注「基础积分 + 赠送积分 = 到账总积分」(如买 3000 送 1500)。规则要点:
- 下单即快照:付款时的档位内容(基础/赠送/总额)会冻结进订单,支付后管理员调整档位配置不影响已支付订单的到账数量。
- 收款金额以商品价为准:档位只决定「这笔钱换多少购买积分 + 多少赠送积分」,不改价。
- 双笔入账:支付成功后购买与赠送分别入账——在交易明细中会看到同一笔订单的两条记录(
topup_purchase购买笔、topup_grant赠送笔),到账总数 = 两笔之和。 - 无订阅用户使用默认档位;订阅套餐可配置专属档位。
入口:个人设置 → Billing(或在账单页点充值);网页登录的支付落地页可通过 ?topup=1 参数直达充值弹窗。
订阅特权免扣
有效订阅(active / trialing 且未过期)的用户调用特权模型清单内的模型时「记账不扣费」:
- 调用照常计量、照常写流水(报表可查),但不扣积分余额——余额为零也不阻断此类请求。
- 命中特权时 API 响应带
X-Wainao-Entitlement标头,调用方可据此区分本次是否免扣。 - 特权模型清单与软额度由站点管理员配置;软额度只是报表标记,超过软额度也不断服务、不额外扣费。
- 清单外的模型照常扣费。订阅取消/过期后特权即时失效。
交易明细
个人设置 → Transactions 查看积分流水,关键类型:
| 类型 | 含义 |
|---|---|
topup_purchase | 充值档位的购买部分 |
topup_grant | 充值档位的赠送部分(月底过期口径) |
purchase | 历史充值(档位拆分上线前的单笔入账) |
model_usage | 模型调用消耗(订阅特权命中时记账不扣余额,流水仍在) |
editor_run / api_run | 编辑器运行 / API 运行消耗 |
开发者接口
- 计费与订阅 API:
GET /billing/summary返回余额分项(订阅赠送/充值购买/充值赠送)、订阅状态与充值档位(topupTiers) - 支付 API:充值下单与支付回调
- 模型网关 API:免扣判定与
X-Wainao-Entitlement响应头的详细语义