文档
v1(2026-09 及以前)实施计划跨模块联调

文本调用与计费联调计划

完整响应计量、固定销售价格和单一 Core 钱包的联合验收

归档内容,只读,不代表现行方案。现行文档见文档总览。

执行依据:用户已确认Core/Edge 多仓与 new-api 用量计价复用路线,uumi 保持代码不变。此页替代原先“新增网关报价/最终 quota 回执”的实施假设;已交付的 uumi-log-v1 仍见历史隔离验证,不作为新生产正常路径。

目标与参与方

客户请求 → Core 鉴权、模型权限、冻结客户销售价格并预留 → Edge 受控透传至 uumi → 完整普通/流式用量 → Core 计算销售费用并唯一写账。正常请求对 /api/log/token 查询次数为零;日志仅低频异常核对,不能假设无限查询或永久可恢复。

Core 复用固定 new-api 的计量语义和计算代码,同时保留自己的账户、价格版本、预留和幂等流水;Edge 负责协议终态、可信证据与持久交接;uumi 负责供应商、渠道和格式转换;Contracts 维护真实已实现切片,Console/Admin 读取同一账务事实。客户价格不要求与 uumi 网关账户消耗相同,不后台同步两份客户余额。

前置与边界

  • 固定 new-api 源码版本、文件哈希、许可证和适配差异。按纯文本倍率、缓存/推理、工具/多模态、表达式分别验收,不把一个计算分支称为全模型支持。
  • 冻结客户价格版本、计算器版本、参数/计量语义和积分换算。quota、人民币、microcredits 明确分开;本地测试数值不确认正式商业政策。
  • 内部服务来源鉴权、一次发送权与请求关联保留;对外用 uumi ID,内部 Operation/Attempt 不删。不得接受终端客户自报 usage/金额。
  • 支持矩阵绑定实际模型/返回形态。OpenAI 入口转换后没有完整缓存语义,不能以“new-api 支持该模型”替代验证。
  • 缺最终 usage、断流、超时或未知执行保持待核对;不估算精确账单,不自动退款,不通过重发模型调用恢复。

执行步骤

步骤交付物完成标准
TXT-I01 源码与计算器用量归一化/合并、舍入和常规计价迁入;离线回放命令与来源清单同一个回包用量、同一价格分别交给固定源原函数与迁入实现,比较用量和金额;拒绝用例单列
TXT-I02 可信用量契约新版 evidence/snapshot schema、普通/SSE 终态及持久化规则明确必填/缺失/零值、缓存 TTL、推理、估算标签与绑定关系,历史 profile 不混用
TXT-I03 代表模型验证统一 OpenAI 入口及原生 Chat/Responses/Messages/Gemini 的受控样本普通/SSE、缓存写入/命中及推理字段保真;模型执行与只读核对分开,记录现网支持限制
TXT-I04 Core 结算接入显式新 profile、不可变价格快照与 quota→积分换算、原有钱包事务不逐请求查询 uumi 日志;同事件只扣一次;同用量可核对不同客户价;不重复应用网关组倍率
TXT-I05 故障与恢复缺字段、断流、重启、结算回包丢失、改价、余额/Key 不足保存可信证据可重放结算;无证据进入 pending;无额外模型执行或猜测退款
TXT-I06 产品与生产Console/Admin 同源明细、生产鉴权与真实政策、容量及恢复报告产品读到正确价格版本/状态;部署、迁移与收费另按发布门槛验收

当前执行结果统一见计算器迁入及本机工作台 NEXT-05,不另建并行实施队列。NEXT-03 商业政策仍是正式收费前置;先用隔离规则完成技术验证。

联合验收

一条操作关联客户、Key、准入模型、冻结销售价格、uumi 请求、可信完整用量与唯一流水。普通/SSE 共用同一计算规则;累计/增量不盲相加,缓存/推理不重复计费。供应调价不能改变已准入请求的客户快照。网关凭据与客户 Key 隔离,对外 SDK 响应不夹入内部账务数据。

正常路径不查日志是一项待验证的系统指标,离线计算器没有网络依赖不等于主链已经达到。容量检查在正确性验证后按容量要求执行,race 测试不能证明吞吐目标。

后置与交接

首批纯文本以外的工具附加费、多模态 token、按次/阶梯/表达式和语义不明的旧转换路径逐项增加;未支持规则在准入阶段拒绝,执行后发现缺失则待核对。正式模型清单、价格、积分比例、硬预算策略与目标并发仍需明确。交接提供来源版本、同输入差分结果、协议样本、异常证据和账务核对,不用回放测试替代真实请求覆盖。

On this page