计费与点数

秒做点数

• 开放 API 的调用费用从 Key 所属秒做账号的点数中扣除，与在秒做官网创作共用同一个点数账户。
• 点数可通过充值、开通会员、兑换码、活动等方式获得，在秒做官网充值。
• 点数精确到小数点后三位。接口中的点数字段以字符串返回（如 "12.000"），避免浮点误差。
• 不同来源的点数可能有有效期（例如会员点数当期有效）。扣点时先扣即将到期的点数。
• 渠道账户可能有授信额度：点数不够时在授信额度内继续调用，形成的欠款在下次充值时优先归还。

先冻结、后结算

1. 1报价

   按你提交的参数（规范化后的 input）和适用价格算出所需点数，价格快照写入任务。

2. 2冻结

   从可用点数中冻结这笔点数。点数不足直接返回 402，不创建任务。

3. 3结算

   任务成功后结算：按报价结算的扣报价；按实际用量结算的多退少补；多张只成功一部分的按成功数扣。

4. 4退回

   失败、取消、结果未通过审核或超时，冻结的点数全额退回。

任务对象里的 points 字段记录了这笔任务的点数变化：

价格

• 每个模型的计价单位与单价见模型文档；用 Key 调 GET /v1/pricing 可以拿到这个 Key 适用的全部价格。
• 计价单位随模型而定：按张、按秒（可按分辨率分档）、按千字、按次，文本模型按输入 / 输出百万 Token 分别计价。
• 数量从参数里来：如生成张数、视频时长；参考素材类模型按上传素材的时长计算。各模型文档页的「计费说明」写明了算法。
• 适用价格自动判定：已审核的渠道按所属等级价，有效会员按会员价，其他按原价；有活动折扣时取较低者。
• 价格快照：提交时的单价写入任务，之后即使调价，这笔任务仍按快照结算。
• 需要开通的场景应用要先开通才能通过 API 调用，开通费用同样从点数中扣除。

额度与拒绝

• 点数不足（含授信额度用完）时返回 402 insufficient_points，不创建任务、不扣点。
• Key 设置了额度上限时，冻结前检查「已用 + 本次冻结」是否超出，超出返回 402 key_quota_exceeded。额度可按日 / 周 / 月自动重置；任务失败退点时，Key 的已用额度同步退回。
• 用 GET /v1/balance 查询余额与当前 Key 的额度，开放平台的「用量」页可以看到每次调用的扣点明细。