上游透明与扣费口径

11API 不做神秘低价池，也不做用户不可见的模型替换。每个可售卖模型都必须能追溯到明确上游、模型名称、分组倍率和成本口径。

公开上游目录

支付服务提供只读接口：

bash

curl -fsS https://pay.11api.top/api/upstreams | python3 -m json.tool

接口只返回候选上游、分类、用途和运营备注，不返回任何 API key。

当前上游分为：

core-official：OpenAI、Anthropic、Gemini、xAI 等官方渠道
broad-aggregator：OpenRouter 等聚合渠道
value-openai-compatible：Groq、Together AI、Fireworks、Cerebras 等低价或高速兼容渠道
cn-official：DeepSeek、通义千问、智谱、月之暗面、MiniMax、火山方舟、SiliconFlow 等国内或中国友好渠道

授权边界

OpenAI / Anthropic 纯 API 额度公开转售前，必须取得书面授权或完成法律确认。没有授权前，只允许：

用户 BYOK 自带官方 key
内部测试
官方允许的集成或授权额度
帮客户用自有账号和付款方式配置官方席位

不允许把共享 key、共享账号、买来的成品号包装成 API 额度。

授权证据登记

候选上游目录只说明“可以研究或接入哪些供应商”，不等于可以公开售卖额度。公开售卖 Authorized Credits 前，生产服务器必须登记机器可读授权证据：

bash

cd /opt/11api/deploy
mkdir -p runtime
cp static/ops-templates/upstream-authorizations.example.json runtime/upstream-authorizations.json
vim runtime/upstream-authorizations.json

每条可用于授权额度的记录至少需要：

providerId
scope=included_credit/resale/integration_distribution
status=approved
validUntil 未过期
evidence 指向合同、邮件、工单、法务备忘录或供应商后台授权截图
summary.readyForAuthorizedCredits=true
summary.blockers=[]

不要把合同正文、API key、支付密钥或客户信息放进这个文件，只保留证据引用和审核记录。byok_only、pending、本地 E2E mock、OpenAI/Anthropic 未授权额度都不会通过 Go/No-Go。

同一份文件也是支付服务的运行时销售门禁。缺失或未就绪时，授权额度套餐会显示为暂不可购买，订单接口会拒绝创建 Authorized Credits 订单；BYOK Developer 和 Seat Setup 不受影响。

扣费公式

基础公式：

text

人民币扣费 = 上游美元成本 x 7.5 x 1.35

7.5 是汇率缓冲，1.35 是试营业目标毛利倍率。低价模型可以单独设置倍率，但必须在后台和文档里透明记录。

毛利口径

试营业 KPI 先按直接成本估算：

text

直接成本毛利 = 已收款金额 - 直接上游成本/直接交付成本
直接成本毛利率 = 直接成本毛利 / 已收款金额

后台 /admin 和 /api/admin/launch-metrics 会展示：

30 天收入
30 天直接成本
30 天毛利
30 天毛利率
缺成本订单数
是否达到 25% 目标毛利

人工、税费、支付手续费、退款损耗和售后时间不自动计入该指标，月度复盘必须另行扣减。若直接成本毛利率已经低于 25%，应立即停止扩大投放。

单笔成本修正

每笔订单创建时会保存套餐成本快照。若真实上游扣费、赠金抵扣、人工交付成本和估算不同，运营可在后台订单行点击“修正成本”。

也可以使用接口：

bash

curl -fsS -X POST "https://pay.11api.top/api/admin/orders/<order_no>/cost" \
  -H "Content-Type: application/json" \
  -H "X-Pay-Admin-Token: $PAY_ADMIN_TOKEN" \
  -d '{
    "estimatedDirectCostCny": 22.3,
    "costBasis": "OpenRouter 实扣折算人民币",
    "note": "每日对账修正"
  }' | python3 -m json.tool

修正成本不会改变用户额度，也不会修改 New API 已发兑换码，只影响财务台账、KPI 和 CSV 导出。

脱敏上游账单对账

如果要证明“账单与上游成本误差 <1%”，运营需要先从上游后台导出原始成本 CSV，再用导入器生成 deploy/runtime/upstream-costs.csv：

bash

cd deploy
./scripts/sanitize-upstream-costs.sh --in /path/to/raw-upstream-costs.csv

最终 CSV 只保留对账字段：

csv

order_no,cost_cny
11A1,22.2

也可以使用美元成本：

csv

order_no,cost_usd,fx_rate
11A1,2.96,7.5

不要在账单文件里保存 API key、Token、Authorization header、客户 prompt、body、response、完整合同正文或上游账号密钥。上线证据包会生成 billing-reconciliation-report.md/json：只有 upstreamCosts.provided=true 且 upstreamCosts.withinTolerance=true 时，才可以对外使用 1% 成本误差说法；否则只能说“平台保存订单成本快照并支持导出复核”。

上线验收

上线前必须跑：

bash

cd /opt/11api/deploy
./scripts/smoke-public-catalog.sh
./scripts/smoke-launch-metrics.sh
./scripts/smoke-admin-exports.sh
./scripts/capture-launch-evidence.sh

通过后再看证据包里的 go-no-go-summary.txt。只有 Decision: GO 时，才开始邀请制收款。若 upstream_authorization 失败，先停止 Authorized Credits 收款，只保留 BYOK 和 Seat Setup。

上游透明与扣费口径 ​

公开上游目录 ​

授权边界 ​

授权证据登记 ​

扣费公式 ​

毛利口径 ​

单笔成本修正 ​

脱敏上游账单对账 ​

上线验收 ​

上游透明与扣费口径

公开上游目录

授权边界

授权证据登记

扣费公式

毛利口径

单笔成本修正

脱敏上游账单对账

上线验收