用量与计费

用量费用

对话使用已登录用户的 HarperHarbor credits。获得授权的应用可以代用户发起对话，但不会获取或保管用户余额。

GET /open/v1/models 公布各模型的费率，输入、缓存输入和输出分别计价。服务按模型报告的 token 用量计算最终费用，完成一条回复至少收取 1 credit。

预留与结算

服务会在生成前，按输入和输出上限预留足够的 credits，因此可用余额可能需要高于最终费用；结算时会释放未使用的预留额度。

费用按模型的实际用量计算。回复被安全机制拦截、模型因内容而拒答、回复达到输出上限，或用户点击停止，只要模型已产生用量，就会按用量扣款；即使页面没有显示回复文字，也可能产生费用。

平台自身错误不收费，包括部署造成的中断；服务错误如果没有产生模型用量，也不收费。每次操作只结算一次，未使用的预留额度会释放；使用相同且内容不变的 clientOperationId 重发，不会重复扣款。

余额不足以预留时，会收到 402 insufficient_credits。应用可引导用户到账号余额查看可用 credits。

查询最终费用

GET /open/v1/conversation/operations/{operationId} 提供操作结果，请结合操作状态、settled 和 chargeCredits 查看；账号余额与账单明细提供对应记录。应用不应根据自行估算的 token 数量计算或承诺最终费用。

credits 套餐和当前开放的购买方式，请见套餐价格。

Agent 模式

Agent 准备过程会在每次调用模型前预留 credits，必要时追加预留额度，并在每次执行结束后，汇总模型报告的输入、输出、缓存读取和缓存写入用量，一次结算。Agent 执行按 token 计价，即使该模型的普通调用采用固定价格也是如此；模型目录的预估值代表单轮范围，不是多次调用的 Agent 执行费用上限。

用户停止或模型服务出错前，已完成的模型用量仍会计费；平台自身错误不收费。接续已保存的准备进度，只收取新增的模型用量；重新连接或重放同一次操作，不会重复扣款。自动记忆准备单独计费与结算。

账单明细会将这类费用标记为 Agent 模式，并另列实际使用的模型；最终费用以操作结果的 settled 和 chargeCredits 为准。