跳到主要内容
SAITower
GitBook 风格文档
返回首页

SAITower 项目文档

阅读进度 · 1/13

8%

先建立心智:公开入口服务用户理解与接入,SAITower 在内部再把路由、交割、结算整合为同一交易系统。

SAITower 项目摘要

SAITower 面向 AI 推理采购与交付场景:公开页面负责用户理解与接入,各类业务工作台承接合约匹配、路由、计量、交付与账单读回。

商业目标

降低多供应商采购与履约的管理复杂度,提升价格与交付可控性。

产品定位

公开入口负责产品认知与 API 理解,期货承兑与后续合约操作在用户工作台完成。

结算方式

仅支持法币/加密货币支付,不使用平台代币作为支付单位。

目标角色

按决策链路拆分信息,减少一次性信息灌输。

角色核心关注平台能力
用户/采购价格、交割、承兑窗口期货 SKU + 用户工作台入口
技术负责人接入效率与稳定性OpenAI 兼容 API + 受控履约回退/读回
财务/风控账单一致性与审计法币/加密支付记录 + 事件读回

三端架构

三端分离是商用稳定性的前提:公开入口只承接用户,供应商与平台治理继续留在各自工作台。

Buyer Surface

公开入口与用户工作台:产品选择、购买入账、承兑管理、余额与订单读回。

供给工作台

签约供给方的业务工作台:经营设置、订单报价、保证金与履约运行态。

平台治理工作台

平台治理工作台:平台运维、期货订单、财务复核、提现结算与信息流审计。

交易生命周期

从调用到账单读回的 8 步路径,强调“可履约、可对账、可审计”。

  1. 1. 请求进入统一网关(OpenAI-compatible)。
  2. 2. API key、项目权限、账户等级校验。
  3. 3. 合约与容量匹配(模型/服务等级/地区)。
  4. 4. 路由引擎选择 provider 候选队列。
  5. 5. provider adapter 调用与受控履约回退处理。
  6. 6. 用量与事件异步写入。
  7. 7. 交割进度推进,承兑窗口内履约。
  8. 8. 账单读回与审计查询输出。

业务对象说明

将白皮书中的产品、交易、计量、账本和风控规则整理为前端可展示、可追踪、可对账的对象说明。

ServiceQuotaContract

未来模型服务额度合约

对象

用户购买的是未来承兑期内可使用的模型服务额度,provider 承诺在交割日后按合约条款履约。

contract_id / sku_id模型族、模态声明、上下文窗口输入/输出/总 token 额度交割日与承兑期Fill Tier 与可替代履约条件

ProviderOffer

Provider 挂售对象

对象

provider 发布的标准化产品包,受保证金、等级、杠杆系数和产品风险系数共同约束。

provider_id基础/占用/冻结保证金最大挂售名义价值产品风险系数SLA 目标与 SDK 服务状态

SecondaryTransfer

后续合同处理对象

对象

承兑开始前的合同处理记录,用于承接当前业务范围内的后续合同动作,并按价格偏离、持有时间、处理次数和关联交易风险治理。

listing_id / order_id卖方、买方或 LP参考价偏离最大流转次数手续费与流转备注

UsageRecord

承兑计量记录

对象

每次承兑请求生成的计量凭证,是额度扣减、SLA、账单、provider 结算和争议处理的主依据。

usage_id / request_idholder_user_id / provider_idinput_tokens / output_tokensstatus / latency_msbilled_tokens / risk_flag

LedgerEntry

复式账本分录

对象

所有购买、流转、退款、结算、保证金冻结/释放/罚没、分佣和提现动作都必须生成账本分录。

entry_id业务动作类型借贷账户金额与币种清算状态与审计时间

PaymentRail

入金通道对象

对象

记录 Stripe Checkout、银行电汇、稳定币和 ePUSDT 等入金路径的费用、到账、验证和最终确认依据。

rail_id / provider费用与到账时间KYC/KYB 或钱包白名单webhook / 链上确认 / 银行对账pending / paid / expired 状态

PayoutRail

出款通道对象

对象

记录银行、网络支付和稳定币出款账户的绑定、验证状态、风控要求、默认渠道和二次验证链路。

rail_id / category账户名与脱敏账号SDK/商户/地址验证费用、最小金额与到账时间2FA 与人工复核状态

RiskReview

风控审核对象

对象

记录高频流转、异常价格、恶意请求、提现风险、provider 超卖或履约异常等事件的处理链路。

risk_event_id触发规则影响对象处置措施复核与解除条件

关键规则护栏

退款窗口

首次成交后、未进入后续合同处理且未进入承兑期可申请退款并收取平台费用;已产生后续合同动作或 usage 原则上不可主动退款,provider 违约等异常除外。

内容安全计费

转发前拦截默认不扣完整 token;已进入 provider 处理链路可按输入 token 或最低调用成本计费,平台误判需退还。

Crypto 确认

不同链不采用统一确认数,按链安全模型、金额、网络拥堵、账户风险和 AML 风险动态设置。

密钥与隐私

provider API key、签名密钥和第三方凭证只能在后端安全环境保存,建议使用 KMS/HSM/Secrets Manager,并对日志做最小化与脱敏。

整体框架说明(FlowchartLR 直绘)

上游电力与算力供给通过分发路由进入统一 API 面,现货实时交付,期货按延迟交割并承接后续合约操作入口。

SAITower 项目框架优势说明图(中文)
SAITower 项目逻辑流程图(中文)
逻辑流程图按语言切换展示,补充说明 API 调用、分发路由、算力集群、用户终端与期货延迟交割关系。

现货 v.s. 期货

SAITower spot architecture
Spot:参考 OpenRouter 路由范式,实时请求实时交付。
SAITower futures architecture
Futures:在 Spot 路由链路之上增加 Delayed Delivery 与后续合约操作入口。

买方动态流程

流程与 OpenRouter 相似,但本项目增加了期货交割和承兑窗口两个关键环节。

真实链路图与动态步骤同步展示,减少纯文本流程的割裂感。

参考 OpenRouter 执行链路,补上期货的 Book、交割与承兑读回。

Spot · SolidFutures · Dashed
用户入口合约与策略分发与执行交付与读回登录 / 鉴权实时请求策略匹配路由至 provider响应 / 计量结果读回锁预算 / 锁条款延迟交付等待交割日承兑窗口窗口内持续读回入口用户应用注册后发起模型调用请求携带项目与账户上下文校验账户 / API 权限检查 API key 与项目策略决定可见模型与额度策略合约 / Fill TierSpot 即时匹配实时额度Futures 先锁预算、交割日与承兑期路由分发路由引擎按模型、地区、履约层选择 provider 候选队列执行Provider / Model Cluster调用上游模型服务回传响应与执行状态回读结果 / Usage / Quota统一写入用量、余额、账单并回显给用户工作台01 Book预定未来窗口先锁成本、额度与履约条款适合预算明确的长期项目02 Delivery交割日启动承兑到期后激活服务响应按窗口回读 request / quota / usage03 Acceptance承兑结束自动失效服务期结束后自动收口减少长期挂权与审计压力
Futures 模式:在实时路由之外增加 Book、交割日与承兑窗口。

采买端动态流程(期货承兑版)

Hyperframe-style Scroll Reveal

核心路径与 OpenRouter 类似(注册、选型、下单、调用、结算),差异在于本平台采用 期货承兑,显式引入承兑窗口、交割期限与流转中心解锁条件。

Step 01

注册与账户准备

OpenRouter-like entry

买方通过 OAuth/本地账号注册,创建 API Key 并完成法币/加密货币支付方式配置。

OAuthAPI KeyFiat/Crypto

Step 02

筛选开源模型 SKU

Marketplace selection

在期货市场中按上下文窗口、服务等级、区域、指导价与交割窗口筛选 SKU。

SKUBook PriceDelivery Window

Step 03

下单 Book 期货

Futures-specific

确认承兑期限与交割总量(k/MTokens 等),以 book 形式锁定下月资源。

bookAcceptance Timek/MTokens

Step 04

合约匹配与 Fill Tier

Contract + routing

系统按合约、容量和路由策略组织候选供应商,并按 Best/Preferred/Guaranteed Fill 目标口径观察读回。

Contract MatchRoutingFill Tier

Step 05

承兑窗口运行

Time participation

在承兑期限内跟踪订单状态、预估兑现量与风险提醒,支持回退与审计记录。

Acceptance WindowQoSFallback

Step 06

交割与账单读回

Post-delivery readback

交割完成后回读账单状态与供应商上报的用量证据,供财务与运营复核。

DeliveryUsage EvidenceBilling Readback

Step 07

打开二级流转入口

Post-delivery logic

累计交割量达到门槛后展示二级流转入口,并保留后续合约操作所需的入口与读回。

>=120 MTokensTransfer EntryReadback

Step 08

账单归档与复盘

Ops/finance readback

输出账单读回、事件轨迹与承兑结果,供采购、财务、运营统一复盘。

InvoiceEventsReadback

API Quota Pack:现货 vs 期货

现货参考 OpenRouter 的即时报价与即刻交付逻辑;期货侧强调预定配额、承兑窗口与后续合约操作入口。

维度现货 Quota Pack(Spot)期货 Quota Pack(Futures)
购买方式按需调用、即时支付,即买即用。提前预定未来窗口期额度,锁定交割时段与条款。
价格形成接近 OpenRouter 的实时路由与按量计费逻辑。按合约指数 + 期限溢价形成 Book Price,并为后续流转读回提供参考。
交付节奏请求到达后实时交付 token。交割日后按承兑窗口分批/持续交付(Delayed Delivery)。
风险关注点主要看实时可用性、瞬时价格波动。主要看履约率、承兑偏差、交割窗口内达成率。
后续操作面主要关注请求读回、余额与额度变化。围绕承兑、结果读回与后续合同处理提供读面,具体可见范围以当前开通范围为准。

对业务侧建议:短周期、弹性流量优先走 Spot;中长期稳定需求优先走 Futures(尤其在预算、交付窗口、可审计要求更高时)。

API 契约

目标是最小迁移成本:应用侧不重写协议,只替换网关地址。

Endpoint说明
POST /v1/chat/completionsOpenAI 兼容调用入口。支持 extra_body.paik 与 header 覆盖(header 优先)。
GET /v1/models模型可见性与合约可购范围由账户等级、项目策略和风控规则共同控制。
GET /v1/usage | /v1/capacity | /v1/contracts查询用量、容量、合约状态和交割进度,支持运营与财务核对。

定价与结算

前台展示法币价格,支付使用法币或合规加密货币。输入/输出仅表示包含量,不是单价。

当前文档使用固定的定价说明参数来解释前端报价口径;它不是后端权威结算合同。

指数回看

7

日溢价系数

0.40%

大额门槛

100,000,000 tokens

等级要求

Professional+

SKU 定价口径(Book Futures)

  • • SKU 示例:Qwen3.5-32B / 128k / Standard / Next-Month Book
  • • 输入/输出字段:例如 5M / 20M,表示包含量
  • • 合约价格字段:Book Price(总价值,低价)
  • • 到达交割日后启动承兑,承兑期不超过约定天数

指导阶梯底价公式

GTF = Avg(CI, 7d) × TF
BP = GTF × (1 + A × 0.0040)
CI = 合约指数TF = 等级系数A = 承兑天数BP = Book Price

回看窗口与期限系数由管理端统一维护。前台按地区展示 USD/CNY,支付支持 Stripe Checkout / USD Wire / USDC / USDT / ePUSDT。

风控与可靠性

平台核心不是“单次可用”,而是“持续可履约”。

填充等级(Fill Tier)

  • Best Effort: 尽力履约,不承诺固定填充补偿。
  • Preferred Fill: 优先服务目标 + 受控 fallback,适合作为常规商用流量的目标口径。
  • Guaranteed Fill: 平台级履约目标,面向关键交易与生产核心路径,不应直接读成当前已普遍生效的统一承诺。

回退阶梯(Fallback Ladder)

  • 1. 同供应商同模型重试
  • 2. 同模型跨供应商切换
  • 3. 同家族模型降级
  • 4. 买方授权的降档回退

路线图

按“可运行 → 可治理 → 可规模化”顺序推进;以下为目标建设项,不等同于今天全部 live。

Phase 1(2 周)

可运行闭环

  • 统一网关与 API key 权限
  • 基础路由与 provider adapter
  • 账单与事件读回基线
  • 后续合同处理与手工审核流程

Phase 2(2 周)

可治理能力

  • 合约/容量匹配
  • fallback 策略与告警目标
  • 风控策略中心
  • 支付与对账流程标准化

Phase 3(持续)

商用规模化

  • 自动撮合与流动性策略探索
  • 多区域合规与审计包
  • 供应商健康评分与优化目标
  • 财务报表自动化输出目标

观测指标

从运营、交易、财务三个视角定义经营与读回基线,不把品牌页指标写成 live 生产事实。

Reliability · 目标/读回

成功率、fallback 命中率、P99 延迟

Commercial · 目标/读回

履约率、承兑偏差、后续合同处理活跃度

Financial · 目标/读回

对账一致性、结算时延、重算率

目标事件词汇 / 当前读回应逐步向这组事件名收敛。

request_receivedcontract_match_resultrouting_decisionprovider_call_attemptfallback_triggeredusage_record_createdsettlement_writtensecondary_listing_createdsecondary_trade_matcheddelivery_acceptance_closed
下拉/下滑以加载更多