跳到主要内容
PAIK
GitBook 风格文档
返回首页
项目摘要目标角色三端架构交易生命周期业务对象说明整体框架买方动态流程Quota Pack 对比API 契约定价与结算风控与可靠性路线图观测指标商用推进

PAIK 项目文档

阅读进度 · 1/14

7%

先建立心智：PAIK 不是单点 API，而是把路由、交割、结算整合为同一交易系统。

PAIK 项目摘要

PAIK 面向 AI 推理交易场景：外部兼容 OpenAI 调用方式，内部完成合约匹配、路由、计量、交割与结算。

商业目标

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

产品定位

book 期货 + 二级流转机制，支撑容量交易与价格发现。

结算方式

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

目标角色

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

角色核心关注平台能力
采购/商务价格、交割、承兑窗口book 期货 SKU + 二级市场流转
技术负责人接入效率与稳定性OpenAI 兼容 API + fallback 路由
财务/风控账单一致性与审计法币/加密支付记录 + 事件回放

三端架构

三端分离是商用稳定性的前提：买方效率、供应商履约、平台治理。

Buyer Surface

一级申购（book）/ 二级交易 / 交割进度 / 账单与合同。

Provider Surface

容量发布、履约状态、收益归集、提现流程。

Admin Surface

策略审批、风险控制、结算核对、异常处理。

交易生命周期

从调用到结算的 8 步闭环，强调“可履约、可对账、可审计”。

  1. 1. 请求进入统一网关（OpenAI-compatible）。
  2. 2. API key、项目权限、账户等级校验。
  3. 3. 合约与容量匹配（模型/服务等级/地区）。
  4. 4. 路由引擎选择 provider 候选队列。
  5. 5. provider adapter 调用与 fallback 处理。
  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 面，现货实时交付，期货按延迟交割并支持权利转移。

PAIK 项目框架优势说明图（中文）
根据本地语言自动切换：中文环境展示中文版本，英文环境展示英文版本。
PAIK 项目逻辑流程图（中文）
逻辑流程图按语言切换展示，补充说明 API 调用、分发路由、算力集群、用户终端与期货延迟交割关系。

JS/SVG 实时绘制，避免外部图片加载链路。

Spot · SolidFutures · Dashed
电力 / Powerrequesttokenrequesttokenrequesttoken / 延迟交割 Delayed Deliveryrequesttokenrequesttoken / 延迟交割 Delayed Deliveryrequesttokenrequesttoken / 延迟交割 Delayed Delivery购买权利 / Purchase Right转移权利 / Transfer Right电站Power Plant算力集群Computing Cluster分发路由Distribution Router用户终端 AUser Terminal A用户终端 BUser Terminal B用户终端 CUser Terminal C
Futures 模式：强调虚线延迟交割与购买/转移权利流转。

架构链路与下方买方动态流程连续衔接：先理解供给/分发框架，再进入 Spot/Futures 的真实业务流。

PAIK spot architecture
Spot：参考 OpenRouter 路由范式，实时请求实时交付。
PAIK futures architecture
Futures：在 Spot 路由链路之上增加 Delayed Delivery 与权利流转层。

买方动态流程

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

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

JS/SVG 实时绘制，避免外部图片加载链路。

Spot · SolidFutures · Dashed
电力 / Powerrequesttokenrequesttokenrequesttoken / 延迟交割 Delayed Deliveryrequesttokenrequesttoken / 延迟交割 Delayed Deliveryrequesttokenrequesttoken / 延迟交割 Delayed Delivery购买权利 / Purchase Right转移权利 / Transfer Right电站Power Plant算力集群Computing Cluster分发路由Distribution Router用户终端 AUser Terminal A用户终端 BUser Terminal B用户终端 CUser Terminal C
Futures 模式：强调虚线延迟交割与购买/转移权利流转。

采买端动态流程（期货承兑版）

Hyperframe-style Scroll Reveal

核心路径与 OpenRouter 类似（注册、选型、下单、调用、结算），差异在于本平台采用 book 期货，显式引入承兑窗口、交割期限与二级市场解锁条件。

Step 01

注册与账户准备

OpenRouter-like entry

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

OAuthAPI KeyFiat/Crypto

Step 02

筛选开源模型 SKU

Marketplace selection

在模型市场中按上下文窗口、服务等级、区域、book 价格与交割窗口筛选 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

交割与结算

Delivery settlement

交割完成后按法币/加密货币账单结算，供应商原生计量归一化后进入账本。

DeliveryNormalized UsageLedger

Step 07

解锁二级市场

Post-delivery logic

累计交割量达到门槛后开放二级市场，可查看订单簿、价格变化和撮合示意。

>=120 MTokensOrder BookMatching

Step 08

账单归档与复盘

Ops/finance traceability

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

InvoiceEventsAudit Trail

API Quota Pack：现货 vs 期货

现货参考 OpenRouter 的即时报价与即刻交付逻辑；期货侧强调预定配额、承兑窗口与可流转权利。

维度现货 Quota Pack（Spot）期货 Quota Pack（Futures）
购买方式按需调用、即时支付，即买即用。提前预定未来窗口期额度，锁定交割时段与条款。
价格形成接近 OpenRouter 的实时路由与按量计费逻辑。按合约指数 + 期限溢价形成 Book Price，并可进入二级流转。
交付节奏请求到达后实时交付 token。交割日后按承兑窗口分批/持续交付（Delayed Delivery）。
风险关注点主要看实时可用性、瞬时价格波动。主要看履约率、承兑偏差、交割窗口内达成率。
流动性实时市场深度决定成交体验。支持 Purchase Right/Transfer Right，形成配额权利流转。

对业务侧建议：短周期、弹性流量优先走 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（总价值，低价）
  • • 到达交割日后启动承兑，承兑期不超过约定天数

指导阶梯底价公式

Guided Tier Floor = Avg(Contract Index, 7 days) × Tier Factor
Book Price = Guided Tier Floor × (1 + AcceptanceDays × 0.0040)

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

风控与可靠性

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

填充等级（Fill Tier）

  • Best Effort: 尽力履约，不承诺固定填充补偿。
  • Preferred Fill: 优先队列 + 受控 fallback，适合常规商用流量。
  • Guaranteed Fill: 平台级履约承诺，适合关键交易与生产核心路径。

回退阶梯（Fallback Ladder）

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

路线图

以“可运行 → 可治理 → 可规模化”顺序推进。

Phase 1（2 周）

可运行闭环

  • • 统一网关与 API key 权限
  • • 基础路由与 provider adapter
  • • 账单与事件可追溯
  • • 二级市场挂牌与手工审核流程

Phase 2（2 周）

可治理能力

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

Phase 3（持续）

商用规模化

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

观测指标

从运营、交易、财务三个视角定义可观测性。

Reliability

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

Commercial

履约率、承兑偏差、流动性深度

Financial

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

request_receivedcontract_match_resultrouting_decisionprovider_call_attemptfallback_triggeredusage_record_createdsettlement_writtensecondary_listing_createdsecondary_trade_matcheddelivery_acceptance_closed

商用推进建议

从三个维度建立商用信心：统一运营平面、可履约闭环、供需弹性机制。

统一运营平面。PAIK 将合约匹配、请求路由、用量计量、资金交割与财务结算整合为同一套运营系统，消除多供应商管理中的信息断层和重复对账成本。

可履约、可对账、可审计。一级申购锁定交割窗口与价格条件，二级市场提供额度流转通道，全链路事件记录支撑财务核算与合规审计。商用能力的衡量标准不是演示效果，而是持续履约的闭环验证。

供需弹性与价格发现。一级市场支撑容量预定与期限定价，二级市场通过权利流转释放存量流动性，形成持续收敛的供给-价格匹配机制。

下拉/下滑以加载更多