积分与计费
估算决策消耗,购买预付积分,了解退款规则。
请求消耗
决策积分与上游 token 不同。平台在推理前根据验证后的请求计算:
块数 = max(1, ceil(规范化请求 UTF-8 字节数 / 4096))
积分 = 问题数量 * 块数规范化 JSON 对对象键排序、保留数组顺序,并包含实际请求模型:显式别名或版本,省略时则采用部署默认值,未配置为 jev-latest。计费统计 整个规范化请求,包括状态、问题、名称、标准与扩展字段。必填的 state: null、省略或为 null 的 instructions,以及可为 null 的 Noul criteria 保留原始 JSON 含义。排版空白不额外计入规范化内容,但仍计入原始请求大小限制。UTF-8 字节数与字符数不同,中文尤其需要注意。
| 规范化请求大小 | 问题数 | 积分 |
|---|---|---|
| 1–4,096 字节 | 1 | 1 |
| 1–4,096 字节 | 3 | 3 |
| 4,097–8,192 字节 | 3 | 6 |
以上为算术示例,原始请求还必须满足独立的 64 KiB 限制。所有问题共享同一状态,但每道问题均按块数计费。上游 token 用量缺失时保持未知,不影响此公式。
预付积分包
| 积分包 | 积分 | 价格(美元) |
|---|---|---|
| Starter | 10,000 | $10 |
| Builder | 60,000 | $50 |
| Scale | 300,000 | $200 |
积分包为一次性购买,不自动续费。上表是仓库的默认配置,具体部署以其结账页面为准。价格和积分数量由服务端 config/plans.ts 决定,不由浏览器提交。
登录后在主站价格页选择积分包。配置 Stripe 后,结账沿用 TinyShip 的订单、支付和积分到账流程。服务端验证支付成功后才会增加积分,访问成功跳转地址不等于付款成功。重复履约不会再次赠送同一笔购买的积分。购买更新的余额与 API、Playground 使用的是同一账户余额。
欢迎积分
默认欢迎赠送为每账户一次 100 积分,需要 先验证邮箱,再进行一次使用会话认证的 System One 交互。运营者可将 SYSTEM_ONE_SIGNUP_CREDITS 设置为 0 到 10000,零表示关闭。实际配置和余额以控制台为准。新增密钥、重复登录和重复访问不会再次获得赠送。
本地开发可以允许未验证邮箱登录,但这不会将账户标记为已验证,也不会绕过欢迎积分条件。
预扣、退款与重放
服务在调用模型前,在共享 D1 账本中预扣积分。余额不足时返回 402 insufficient_credits。并发请求通过事务记账,不能重复花费同一份可用余额。
成功后预扣转为本次计费;普通推理失败先返还积分,再返回错误。认证、本地准入校验和上游未配置错误不会产生新推理扣费。除文档列出的安全替换外,原生上游错误保留原 4xx/5xx 状态与 JSON。上游 401 不代表平台会话失效,应检查错误分类响应头。中断预扣由定时任务对账,详见失败恢复。
成功的幂等重放不会再次预扣或收费。X-System-One-Credits 为 0,X-Idempotency-Replayed 为 true,X-Request-Id 指向原账本操作。计费只读这些响应头。新成功正文不注入平台计费或 ID;上游自己的 billing、request_id 或 replayed 不代表平台元数据。新缓存保留原文本、状态及允许的响应头;旧缓存有明确的升级限制。换新键或不提供幂等键,都代表新的潜在扣费请求。
确认退款后的扣费头同样为 0。503 request_reconciliation_pending 因余额未确定而省略该头,不能把缺失解释为零。TypeSafe 模型列表需要平台密钥,但不创建决策预扣或扣费。openrouter-adapted 评估使用同一平台账本,上游报告的用量成本与平台积分独立。
推理积分返还与 Stripe 现金退款是不同操作。现金退款、争议和拒付需要部署运营者核对订单与积分账本处理,本集成不承诺自动完成这些调整。
用量记录
控制台展示持久化余额和最近 30 个 UTC 日的决策活动,包括该窗口内最新 50 次请求。缺少数据时不会用演示用量替代。延迟仅反映对应请求的测量结果,不代表上游性能承诺。缺失的 token 计数不会被估算补齐。
请求异常或存在计费疑问时,保留 X-Request-Id 和有值时的 X-Upstream-Request-Id,并与部署运营者核对账本。请求元数据与重放缓存保留期限见数据处理。