计费与积分
托管 System One API 的积分如何计费、如何管理账单。新账号注册即送 100 积分，积分永不过期。
System One 托管 API 使用预付积分进行评估。Playground 和你的 API 连接共用同一账户余额。开源 SDK 本身不要求这些积分；通过 SDK 直连其他服务时，适用相应服务的计费。调用托管服务前，请先在控制台检查账户余额。
常见问题
Q: System One API 积分如何运作？
A: 托管 API 按积分计量。新账号注册即送 100 积分，积分永不过期。在账户控制台管理账单。
查看所选模型的价格
不同模型可能有不同价格。在 Playground 中选择模型，点击下拉框旁的 模型信息 按钮查看当前单价与限制，不要假定每次请求都只需一个积分。详情默认隐藏，点击后弹出；价格页用于购买积分包。可用模型和价格可能变化；选择模型介绍了需要比较的事项。
Playground 会在提交前估算当前请求的费用。加载示例不算一次计费评估，运行示例则会发起真实请求。
请求费用如何计算
费用取决于三个因素：
- 问题数量： 请求中的每个问题都会计入费用。
- 完整请求大小： 按所选模型的
pricing.bytesPerBlock指定的 UTF-8 字节数分块，不足一块向上取整，最少按一块计算。 - 所选模型的单价： 每问题、每块所需的积分。
blocks = max(1, ceil(canonicalRequestUtf8Bytes / selectedModelBytesPerBlock))
credits = questionCount × blocks × selectedModelRate公式中的 blocks 是块数，questionCount 是问题数，selectedModelRate 是所选模型的单价。canonicalRequestUtf8Bytes 指「规范化请求」的 UTF-8 字节数。
「规范化请求」是指解析后以统一形式表示的完整请求，而不只是要审核的消息。它包括所选模型、上下文、问题、选项名称、标准和受支持的附加字段。用于排版的空格不增加计费大小，文本内容中的空格则会计入。UTF-8 字节数不等于字符数，中文和表情符号可能每个字符占用多个字节。
假设价格的计算示例
仅为说明计算方式，假设某个模型的计费块为 4,096 字节，价格是 每问题、每块 2 积分。这不是当前模型价格，也不是报价。
| 完整规范化请求大小 | 问题数 | 块数 | 示例费用 |
|---|---|---|---|
| 1–4,096 字节 | 1 | 1 | 1 × 1 × 2 = 2 积分 |
| 1–4,096 字节 | 3 | 1 | 3 × 1 × 2 = 6 积分 |
| 4,097–8,192 字节 | 3 | 2 | 3 × 2 × 2 = 12 积分 |
所有问题共享上下文，但每个问题都按完整请求的块数计费。评分或概率不会改变费用：计算依据是请求，而不是你是否认可答案。显示的 token 数量属于另外的用量信息，不会替代这套积分公式。
完整提交内容还须符合所选模型的 limits.bytes：Jev 与 HTTP 模式保留 64KB（65,536 字节）；已迁移 Clef／Clef Flash 条目最高 13MB（13,631,488 字节），管理员设置的更小限制仍保留。即使排版字符不增加计费大小，也计入提交大小限制。整个 images 字段（包括 base64 字符串和媒体类型）计入解析后请求的计费大小，不是仅计算解码后的图片大小。图片数量与解码字节限制另行校验。运行前查看图片限制及更新后的 Playground 估算；图片不是固定单价附件。
模型可用性、默认选择、限制及价格可能调整。开始新操作前请查询当前目录。已经受理的操作保留原预扣金额，失败时按原金额退款；即使之后调价或模型从公开目录下架，成功操作的同键重放仍不再次收费。
购买一次性积分包
登录后打开价格页，或控制台计费页面的购买区域。选择积分包，在付款前核对结账页面的金额、币种和积分数量。
积分包是 一次性购买，不是自动续费订阅。当前结账页面为准，本文不固定积分包额度或价格。确认付款后，请在账户余额中检查积分是否到账。如果付款看似已完成但积分未到账，请携带订单参考信息联系支持，不要立即重复付款。
欢迎积分
新账号注册即送 100 积分。每个账户只发放一次。创建更多 API 密钥或再次登录，都不会再增加欢迎积分。
计费块如何计算
费用按请求大小算：每 4KB 算一块，不足 4KB 也按一块。费用 = 块数 × 问题数 × 模型单价。
例如：一份 6KB 的请求、2 个问题，用 Jev（每块 1 积分）= 2 块 × 2 × 1 = 4 积分。
积分不会过期
积分不会过期。你可以在控制台查看近期用量记录。之后查看更早的记录也不会改变账户余额。
失败、重复请求与不确定结果
| 发生了什么 | 对你意味着什么 |
|---|---|
| 请求在评估前因登录、输入或余额不足而被拒绝。 | 不产生新的评估费用。先解决原因再尝试。 |
| 评估失败，且已确认积分返还。 | 该次评估的积分已返还。这是积分调整，不是现金退款。 |
| 服务提示费用仍在处理中。 | 最终扣费尚未确定。查看用量，如持续未解决请联系支持。 |
| 浏览器或应用超时、断线或被关闭。 | 这不能证明请求失败或免费，它可能已经完成。再次提交前先查看用量。 |
| API 连接使用原请求和重放标识成功恢复答案。 | 恢复的答案不会再次计费。这是重放，不是新评估。 |
| 再次运行 Playground 或发起新的 API 请求。 | 即使问题看起来相同，也可能构成一次新的计费评估。 |
重放标识在 API 中称为 幂等键（idempotency key）。每个新业务操作生成新键，与完整请求一起保存；仅在重试同一操作时复用二者。键按账户隔离，切换 API 密钥不会创建独立的重放范围。在保留窗口内，同键但请求改变会返回 409 idempotency_conflict，不新增评估费用；成功后使用同键和原请求会重放旧答案，不再次收费，也不会重新评估。
成功答案可以在 从请求创建起的 24 小时内 恢复。这不是永久防重复机制，过期后再次提交可能产生新费用。重试响应中的 X-System-One-Credits: 0 只表示本次 HTTP 尝试没有新增扣费，不表示原业务操作免费，也不表示原请求尚在处理的积分已返还。处理中、失败和结果不确定时如何处理，见请求恢复。
不要把缺失的扣费数值当成零，也不要认为每个错误都表示积分已返还。尤其在 Playground 请求中断后，应避免反复点击运行。
购买积分包的现金退款，与评估失败后的积分返还是不同事项。购买问题请联系 support@system-one.dev，本文不承诺自动现金退款。
查看用量并获取帮助
控制台显示余额和最近 30 个 UTC 日的活动，包括该范围内最新 50 次请求。UTC 的日期边界可能与你的本地时间不同。这是近期视图，不是完整的历史记录。
如对扣费有疑问，请保留可用的请求 ID、大致时间，以及与购买相关的订单参考信息，并发送至 support@system-one.dev。不要发送 API 密钥、登录验证码或完整银行卡信息。
请求异常或存在计费疑问时，保留 X-Request-Id 和有值时的 X-Upstream-Request-Id，并联系支持核对账本。请求元数据与重放缓存保留期限见数据与隐私。
在「积分与账单 → 余额与流水」中，余额概览区分当前可用积分、累计获得（充值与赠送）和累计消耗（退款前）。「在线流水」展示积分变动及变动后的余额，可选每页 10／25／50／100 条，切换条数后回到第一页。通过首尾页和相邻页码导航，也可输入有效页码并按 Enter 或「跳转」直接到达。日期时间使用本地时区；桌面采用表格，手机采用紧凑记录布局，说明不截断。切换「历史归档」可获取本人的旧记录，返回在线流水时保留页码及每页条数，刷新后恢复默认分页；归档日期筛选使用 UTC。
更早的用量记录
积分不会过期。控制台显示近期用量记录。更早的记录之后可能不再出现在近期列表里；可用积分和累计总额不变。你可以在账单页下载自己的更早记录，其他账户无法下载。