定价与计费 - DeckFlow 开发者

DeckFlow 开发者用量计费基于与 API 密钥关联的账户或工作区。Tools 用量使用两种配额货币计量：credit 和 spark。

计费原理

每个 Tools 任务可能包含固定基础费用和按量计费两部分：

总费用 = baseFee + meteredUnits * meterFee.unitPrice

如果一个工具同时使用 credit 和 spark，DeckFlow 将分别扣减两种货币。例如，压缩任务可能以 spark 计收启动费，再以 credit 按文件大小计量。

API 密钥计费： 用量将计入拥有该 API 密钥的账户或工作区。服务器任务、MCP 调用、CLI 运行和 CI 自动化使用同一密钥时，均消耗相同工作区的配额。

单位	用途
`credit`	标准处理工作，包括 OCR、幻灯片操作、格式转换、图片调整大小，以及大多数基于页面或文本的工具。
`spark`	更重型或高级工作，包括压缩和面向视频的处理。部分工具仅收取 Spark 基础费，其他工具也以 Spark 计量。

最终扣费金额基于服务器实测的文件大小、文本长度或页数。建议在提交大型任务前显示估算费用，任务完成后使用响应数据展示最终配额消耗。

工具	基础费用	计量费用
`file.compress`	`1 spark`	`2 credit / size_10mb`
`video.compress`	`1 spark`	`2 credit / size_10mb`

工具	基础费用	计量费用
`convertor.html2png`	`1 credit`	`2 credit / text_1k`
`convertor.markdown2png`	`1 credit`	`2 credit / text_1k`

file.compress 收取 1 spark 基础费，再按每 10 MB 收取 2 credit。文件按 3 个计量单位计算：

1 spark + (3 × 2 credit) = 1 spark + 6 credit

convertor.ppt2pdf 收取 2 credit 基础费，再按每页收取 2 credit：

2 credit + (12 × 2 credit) = 26 credit

convertor.ppt2video 的基础费和页数计量均使用 Spark：

1 spark + (10 × 1 spark) = 11 spark

Tasks 响应应在任务接受或完成时包含配额用量。使用这些字段向用户显示清晰的消费明细。

{
  "quota_usage": {
    "credits_used": 26,
    "sparks_used": 0,
    "remaining_credits": 974,
    "remaining_sparks": 100
  }
}

工作区配额不足： 如果工作区配额不足，DeckFlow 将在任务处理前予以拒绝。若收到配额不足的错误响应，请勿在代码循环中高频重试；建议直接提示用户补充配额、升级套餐或减小任务规模。