人民币充值、积分与客户价格
企业专属账户、充值套餐和差异计价的讨论草案
历史方案:本页为恢复第一版多仓文档前的快照,不是现行任务或已实现能力。现行入口为平台架构。
版本:2026-09-12 / 商业规则讨论稿。用户已确认人民币充值、系统内积分、企业专属账户与协议价,首期不做多人协作;以下价格结构和优先级为建议,尚非已批准的套餐或折扣政策。
已确认的边界
- 对客支付统一人民币,不提供多币种钱包;系统内以积分表示可用余额和调用消费。
- 企业首期使用专属账户及协议价,不引入多人共享余额、成员邀请或部门预算。
- 充值套餐与具体售价后续敲定;差异价格必须支持不同客户。
- Console 的客户页面参考 new-api 后修改;Admin 负责价格和客户运营配置。
- 复用既有计费执行基础,不为每个产品重复建设钱包。
建议分开的五类规则
| 规则 | 回答的问题 | 需要的数据 |
|---|---|---|
| 积分单位 | 一元充值对应多少基础积分 | 固定换算、积分精度、单位版本;具体比例待定 |
| 充值套餐 | 付多少人民币,获得多少积分 | 实付分、购买积分、赠送积分、适用客户、生效期 |
| 模型价格表 | 某种能力每计量单位消耗多少积分 | 模型/计费规格、单位、单价或规则、版本 |
| 客户价格方案 | 某账户适用什么价 | 标准、等级、企业协议价的绑定与有效期 |
| 周期权益 | 是否存在包月、周期额度或特定权益 | 购买、到期、重置、超额规则;首期是否启用待定 |
充值套餐不自动等于包月订阅。充值优惠影响“买到多少积分”,客户协议价影响“每次用多少积分”,两者可以同时存在,但必须明确组合规则,不能默默叠加。
人民币统一是产品规则,不是把上游所有 USD 文本替换成 RMB。支付金额、报价、回调、订阅、计费单位和历史记录都需做真实单位映射。对外只显示人民币/积分,供应成本的原始单位仍按事实保存。
企业客户和价格表
首期以一个专属账户绑定一个生效价格方案。建议 Admin 提供客户类型、客户名称、账户绑定、适用价格表、有效期和内部备注;企业标签不提升后台权限,也不增加成员模型。
价格表可按模型/计费规格覆盖单价。文本需要区分输入、输出、缓存等单位;媒体需要区分张、秒、次及影响价格的模型、分辨率、时长等维度。不能用一个全局折扣覆盖所有不同成本结构的模型。
建议价格选择顺序:
- 在有效期内的企业协议价,匹配该模型与计费规格时优先。
- 未覆盖项目使用该客户明确指定的基础价格方案。
- 基础方案缺少价格时按明示政策拒绝调用或提示未配置,不静默给出意外低价。
一个项目最终选出一套有效价格;企业价不再默认乘 VIP 折扣。充值赠送是否适用于企业价,另由套餐适用规则决定。以上顺序为讨论建议,不宣称上游已经实现。
充值与积分
建议沿用一个权威积分余额,并在账务记录中保留积分来源。如果赠送积分与购买积分拥有不同期限、使用范围或退款规则,则需要来源批次/资金子账户记录;不是仅在前端拆两个数。
建议订单保存:人民币实付(整数分)、购买积分、赠送积分、套餐及版本、适用客户、支付交易标识、入账状态和时间。没有赠送活动时赠送为零。用户看清本次得到多少积分,运营能够核对实付与赠送,不能把赠送积分计为现金收入。
需要进一步决定:基础换算比例;是否赠送;积分是否过期;赠送与购买积分的扣减顺序;企业是否享受公共充值活动;退款时赠送如何处理。未决定前不创建默认套餐、有效期或折扣。
消费与价格快照
概念关系:
到账积分 = 购买积分 + 明确适用的赠送积分
调用消费 = 按实际计量维度,对本次锁定的有效价格规则求值简单单价模型可用“实际用量 × 单价”;阶梯、缓存、多维媒体规则需要完整规则计算,不能全部简化成一个乘法。内部继续采用经过校验的最小整数额度与明确舍入规则,不直接用显示小数扣账。
建议调用受理时锁定账户、价格方案/版本及匹配规则,预扣与最终结算使用同一套价格依据,再按实际用量补扣或释放。修改价格只影响约定生效时间后的新调用;在途任务是否有特殊处理需另明确。
每次消费应能追溯:账户、产品来源、Key/调用者、模型与规格、用量、有效价格、价格版本、预扣、实际扣减、释放/退款及关联请求/任务。客户无需看到供应成本,但必须能解释为什么扣这些积分。
用量页面需要补的重点
Console 在 new-api 现有日志和统计上补齐:
- 用量与积分分列:Token、张、秒或次,不能全叫 Token。
- 消费明细可解释本账户有效价格、计量构成、最终积分与结算状态。
- 筛选和汇总口径一致;目前上游部分统计不支持明细的全部筛选。
- 充值、购买积分、赠送、消费、人工调整与退款分别展示。
- 结果失败、费用结算中、部分输出和退款完成分别表达。
- 产品/Key/模型归属与请求 ID 可定位;缺失的跨产品字段标为待接入。
- 默认显示积分,不按当前充值比例把历史消费折算成错误的“实际人民币成本”。
两端页面调整
| Console 客户页面 | Admin 运营页面 |
|---|---|
| 积分钱包:总可用、来源明细、人民币充值记录 | 充值套餐:实付、购买/赠送、适用客户、有效期 |
| 我的价格:本人有效模型价及计量单位 | 价格表:标准/客户等级/企业协议规则与版本 |
| 用量详情:本次使用的价格依据与积分 | 企业客户:专属账户和价格方案绑定 |
| 已购套餐/权益:实际存在时展示 | 生效与报价预览:指定客户+模型+参数+时间核对结果 |
“我的价格”只显示本人有效价格,不展示其他客户报价。公开 Developer 展示公开参考价,登录后显示本人价格;二者来源一致但权限和选价上下文不同。
上游可复用与需扩展的部分
本轮读取固定源码,未运行计费测试:
- 分组倍率已有使用组倍率及用户组到使用组的特殊倍率。
- 选取倍率在匹配特殊倍率时替代普通倍率,不是把二者重复相乘。
- 充值报价存在充值组倍率与金额档位折扣;它不是已验证的购买/赠送来源账本。
- 套餐处理创建/更新强制 USD,采用人民币产品规则需要明确适配。
简单等级价可映射已有分组机制;复杂企业逐模型协议价、版本有效期、报价预览和赠送积分来源需补适配或扩展。不能无条件给每个企业复制渠道与模型组,把计价规则和供应路由绑死。
下一步讨论
先确认计价规则,再定具体金额:换算与精度 → 充值套餐种类 → 企业价格覆盖/回退 → 优惠叠加 → 价格生效和历史解释。UI 可先表达明确标记的示例,示例不作为真实报价。