计费与用量

积分是 Agent 调用 Beatra skills 时消耗的独立额度和计费单位，不存在固定的积分与法币汇率。各市场的充值套餐决定一笔付款获得多少积分；公开模型价格决定一次操作消耗多少积分。

扣费方式

创作、语音合成、音色、音乐以及独立图片/视频理解任务都采用预付费。提交时按已接受的任务价格扣下积分；最终用量可变的创作任务在成功后按实测用量结算。理解任务的完整图片张数或向上取整的视频秒数在开始生成前已经确定，因此提交时扣下的积分就是精确金额。公开社交数据读取（beatra.social.execute）同样预付费：价格为 6、12、30 或 60 积分，并在创建任务前确定。

余额不足以支付预付金额时，API 返回 402 insufficient_balance，任务不会创建。

AI 导演（beatra.speech.prepare_script、POST /v1/audio/speech/scripts）采用后付费：成功后按实际使用的输入、输出和推理 token 扣费。提交时，余额需不低于所提交文字的预估费用，即按能力目录中的每千字预估价和字数折算（不足 1,000 字按 1,000 字计）；如果本账号还有一个 AI 导演任务正在进行，还要加上它的预估费用。余额不足时 API 返回 402 insufficient_balance，details.reason 为 director_estimate，任务不会创建。最终按实际用量扣费，通常低于预估；如果超过当时的余额，最多扣到余额为止。

同时做几个

套餐	同时做几个
未买套餐	2
入门	4
进阶	6
专业	8
工作室	8

已经有这么多个在进行时，新请求不会开始、也不会扣费。等其中一个结束后用同一请求再试，或选能同时做更多的套餐。REST 的每分钟次数上限见限流页。

ElevenLabs 合成另有单独的上限：不论套餐，每个账号同时最多 2 个 ElevenLabs 合成任务在进行，免费的克隆试听也计入；MiniMax 和豆包的任务不计入。第 3 个请求返回 429 rate_limited，details.reason 为 speech_inflight_limit，不扣费。

AI 导演也有单独的上限：不论套餐，每个账号同时最多 2 个 AI 导演任务在进行，全平台同时进行的数量也有上限。第 3 个请求返回 429 rate_limited，details.reason 为 director_inflight_limit（通过 MCP 调用时，上面的套餐上限可能先生效）；AI 导演当前繁忙时返回 429，details.reason 为 director_busy。两种情况都不会开始任务，也不扣费。遇到 director_inflight_limit 时，请等本账号的一个 AI 导演任务结束后再提交；遇到 director_busy 时，请在 details.retry_after_seconds 秒后重试（REST 的 Retry-After 响应头给出相同的秒数）。

理解任务预付费

POST /v1/images/responses 按已接受的 image_count 每张 5 积分计费，最多 8 张。
POST /v1/videos/responses 按已接受的 input_video_seconds 每秒 0.4 积分计费，毫秒向上取整到整秒。
detail 和供应商 token 用量都不会改变价格。
理解任务失败，或取消得到确认时，提交时扣下的积分会按预付费退款原路退回。

预付费任务成功结算

当最终计费量取决于实际接收的媒体或上游输出时，提交时的扣款只是估算。任务成功后，Beatra 使用提交时锁定的价格快照，按权威实测用量结算：

实际用量较少时，未使用的估算额计入 refunded_credits；
实际用量相同时，无需调整钱包；
在已接受的请求契约内，实际有效用量较多时，差额作为补扣计入 charged_credits。

如果实测用量与其输入/输出拆分不一致，或超过已接受请求及模型的时长上限， Beatra 不会将其记为实际用量，也不会补扣；提交时的原预扣保持不变，任务进入待结算状态交由运营审查。

最终净扣费由 billing.net_charged_credits 直接返回（等于 billing.charged_credits - billing.refunded_credits）。成功任务的超额用量可能使钱包余额低于零；产物仍然有效，但充值前不能创建新的付费任务。

失败自动退款

任务 failed，或取消得到确认且任务进入 canceled 时，预扣的积分 自动原路退回，无需申请。取消冲突表示任务仍在运行，不会触发退款：

"billing": {
  "charged_credits": 48.0,
  "refunded_credits": 48.0,
  "net_charged_credits": 0.0
}

响应中的计费字段

每个任务响应都带：

字段	说明
`usage.credits`	成功任务最终净消耗的积分
`usage.image_count`	图片理解里接受的图片张数，或图片生成的成功输出张数
`usage.video_seconds`	结算后的权威输出计费秒数（等于 `usage.output_video_seconds`；计费的输入分量单独在 input 字段报告）
`usage.input_video_seconds` / `usage.output_video_seconds`	可用时的权威输入/输出秒数拆分；`null` 表示没有权威拆分，不能按 0 推断
`billing.net_charged_credits`	实际用量结算与退款后的最终钱包净扣费
`billing.charged_credits` / `billing.refunded_credits`	累计扣款 / 累计退款；两者相减得到最终净扣费

余额与充值

积分购买是一次性支付，以人民币计价，用微信支付。在 console.beatra.cn/wallet?intent=buy 查看余额并充值。

积分属于充值时登录的账号，Agent 只能用它连接的那个账号里的积分。充值页会写明「充值到：…」；你有两个账号时，见账号与合并。