计价与配额规则

深旋科技（Atomelody）生物计算平台实行按需计费、预占结算、透明可控的算力计量体系。

平台使用算力点数作为度量结构预测与虚拟筛选任务消耗的统一凭证。本文将详细介绍任务计价阶梯、分子序列 Token 计算规则与规格限制、点数扣费与退还生命周期，以及额度不足时的申请流程。

核心计费原则

• 统一计量凭证：所有预测计算任务均通过账户内的算力点数进行结算。
• 按 Token 区间计价：结构预测按所有输入分子的有效 Token 总数确定基础费用，再乘以推理种子数量 num_seeds（默认 1）；虚拟筛选对每个“靶点 + 候选”组合分别计价后求和。
• 先预占、后结算：任务创建时系统冻结相应点数，成功后正式扣除；虚拟筛选仅结算成功组合。任务失败或在可取消阶段被取消时，预占点数会自动释放。

序列 Token 规则与限制

为保障服务稳定性，平台以 Token 总数 衡量任务计算规模，并对单次任务设有如下规格限制：

序列 Token 计算说明

结构预测任务的 Token 总数由输入中各序列项累加得出；虚拟筛选在每个“靶点 + 候选”组合内按相同方式计算。单个序列/分子项的计算公式如下：

单个序列项 Token = (序列残基长度 + 分子全原子数) × 链标识 (id) 数量

• 蛋白质 / DNA / RNA（生物大分子）：以其实际氨基酸残基数或核苷酸碱基字符数作为序列长度（全原子数计为 0），乘以链标识数量。
  例如：蛋白质单链序列长度为 300，链标识 id 为 ["A", "B"]（同源二聚体），则该项贡献 Token 为 300 × 2 = 600。
• 小分子配体与无机离子（ligand / ion）：以分子的全原子数（优先由 SMILES 解析获取，无 SMILES 时由 CCD 编码解析获取，序列长度计为 0），乘以链标识数量。ion 仅适用于支持该类型的模型，具体以模型能力表为准。 例如：小分子配体全原子数为 30，链标识 id 为 ["L"]，则该项贡献 Token 为 30 × 1 = 30。
• 多分子复合物体系：同一复合物中所有蛋白质链、核酸链、小分子配体及离子的 Token 贡献累加求和，即为该复合物的序列 Token 总数。

任务计价阶梯表

结构预测按所有 sequences 贡献的 Token 总数所在区间确定基础费用。下表为 num_seeds=1 时的费用：

结构预测费用 = Token 阶梯基础费用 × num_seeds

input.num_seeds 默认为 1，支持 1～20。先按实际 Token 数确定阶梯，再乘以种子数量；不将 Token 数乘以种子数量后重新套用阶梯。询价的 base_cost 返回单份基础费用，quantity 返回实际种子数量；estimated_cost 和创建时预占的点数均已包含此倍数。虚拟筛选不支持该参数。

费用测算示例

以下前三个示例均使用默认的 num_seeds=1。

• 示例 1：单链靶点蛋白
  输入单条蛋白质序列长度为 420 个氨基酸（id 为 ["A"]）。
  → 任务 Token = 420 × 1 = 420 ≤ 500，扣除 10 点。

• 示例 2：激酶-底物-配体复合物体系
  包含链 A（激酶结构域，450 aa）、链 B（底物肽，180 aa）以及小分子配体（全原子数 30，id 为 ["L"]）。
  → 任务总 Token = 450 + 180 + 30 = 660（落在 501 ～ 1,000 区间），扣除 30 点。

• 示例 3：抗体-抗原同源三聚体复合物
  包含抗原链（同源三聚体，单链 350 aa，标识为 ["A", "B", "C"]）以及单克隆抗体单链（220 aa，标识为 ["D"]）。
  → 任务总 Token = 350 × 3 + 220 = 1270（落在 1,001 ～ 1,500 区间），扣除 60 点。

• 示例 4：使用 20 个种子预测：与示例 1 使用相同输入，设置 input.num_seeds 为 20。Token 仍为 420，费用为 10 × 20 = 200 点。

虚拟筛选计费

虚拟筛选（task_type=2）将靶点分别与各候选组合，每个组合按上方阶梯单独计价，再累加为本次任务的预占点数：

单个组合 Token = 靶点 Token + 当前候选 Token
整批预估费用 = 各组合按 Token 阶梯计算的费用之和
最终扣费 = 成功组合的费用之和

靶点的 Token 在每个组合中分别计入。询价返回的 token_num 是全部组合的 Token 数之和，可以超过 2,000；每个组合仍须满足 1～2,000 Token，整批预估费用不得超过 1,000 点。

例如靶点为 450 Token，两个候选分别为 20 和 100 Token，则组合分别为 470 和 550 Token，预估费用为 10 + 30 = 40 点，不是将 1,020 Token 合并套用一次阶梯。

部分成功的筛选任务状态为 COMPLETED，请结合 summary.csv 查看各候选结果，并通过任务详情中的 billing_order.charged 确认实际扣费。完整输入和询价示例见虚拟筛选使用指南。

点数生命周期与扣费流程

平台采用先预占、后结算机制：结构预测失败或筛选全部失败时，全额解冻；筛选部分成功时，按成功组合扣费并释放其余预占。

状态流转详细说明

1. 创建与冻结（Freeze）： 任务提交时，系统计算出应扣点数并从账号的可用点数中转入冻结预占。此时总资产不变，但该部分点数不可再用于其他并发任务。
2. 结算与扣除（Settle）： 结构预测正常完成（状态为 COMPLETED）时，系统正式扣除该笔预占点数；虚拟筛选完成时，仅扣除成功组合的费用，其余预占点数释放。
3. 释放预占（Unfreeze）： 若任务失败（状态为 FAILED），或用户在允许取消的阶段取消任务（状态为 CANCELLED），系统会全额释放预占点数。状态同步可能需要短暂时间，可在额度明细中确认处理结果。

免费额度与周期重置规则

在控制台 额度管理 中，您可以实时监控账户资产与额度消耗明细：

额度指标说明

• 可用点数：当前可自由支配并用于新提交计算任务的有效点数。
• 冻结预占：当前正在排队或推理中的任务所冻结的点数。
• 总点数：账户当前持有的点数总和（总点数 = 可用点数 + 冻结预占）。
• 周期额度上限：平台分配给您当前周期的额度上限，默认值为 10,000 点；请以控制台显示的实际额度为准。

免费额度与重置机制

• 默认周期额度：新账号的默认周期额度上限为 10,000 点，特定账号的额度可能有所不同。
• 周期边界：每个额度周期从北京时间（UTC+8）每周一 00:00 开始；控制台会显示准确的下次重置时间。
• 重置计算规则：
  • 重置时以恢复账号当前的周期额度上限为准；
  • 重置时不会重置或释放已冻结额度，未完成任务的预占点数继续保留；
  • 重置后新的可用额度计算公式为：新可用点数 = 周期额度上限 - 当前已冻结点数
• 计算示例：
  • 重置前：可用额度为 1,000 点，已冻结 500 点（此时总额度为 1,500 点）。
  • 重置后：总额度恢复为 10,000 点，已冻结保持 500 点，新的可用额度更新为 9,500 点（即 10,000 - 500）。

常见问题 (FAQ)

Q1: 任务中包含小分子配体（SMILES）或离子，如何计费？

按照分子的全原子数计入 Token。 平台会解析小分子配体（优先使用 SMILES，无 SMILES 时使用 CCD）及无机离子的全原子数，按照“全原子数 × 链标识数量”计算 Token，并与同一复合物中的蛋白质、核酸序列 Token 汇总求和，按阶梯计费。虚拟筛选对每个“靶点 + 候选”组合分别计算。

Q2: 任务如果预测超时或报错，会扣除我的点数吗？

结构预测失败不扣费；虚拟筛选中失败的候选组合不扣费，但成功组合仍会结算。状态为 FAILED 或 CANCELLED 的任务会自动释放全部预占点数；额度明细更新可能需要短暂时间。

Q3: 如何在提交任务前预估费用？

您可以调用任务询价接口（POST /v1/tasks/quote），提供拟提交任务的模型、任务类型和分子输入，获取 Token 总数、基础费用 base_cost、计费数量 quantity 与预估所需点数 estimated_cost。虚拟筛选的基础费用为各组合基础费用之和，计费数量为 1，并通过 candidate_costs 列出每个组合的 Token 数与费用。请以 estimated_cost 作为本次报价，无需自行乘算。询价不会创建任务、执行推理，也不会预占或扣除点数。

询价结果仅供参考，不锁定价格。实际扣费可能发生变化，请以实际创建任务时的费用为准。创建任务后，可通过响应中的 billing_order.frozen 查看本次任务实际预占的点数。