BeefAPI用量与计费
理解企业人民币钱包、预扣、最终结算和按请求对账。
企业版使用独立人民币预付费钱包。在 钱包 查看余额和充值记录，在 用量 查看调用费用。登录账号相同不意味着企业、国内和海外钱包余额互通。
调用前确认两项额度
企业钱包需要有可用余额，API Key 也需要在有效期内并有可用额度。Key 额度不是额外资金。充值完成后以企业钱包到账和订单状态为准，支付页面打开、二维码显示或浏览器跳转本身都不证明已经到账。
价格单位
| 类型 | 如何计价 |
|---|---|
| 文本 | 输入、输出按各自每百万 token 单价；缓存和长上下文按模型报价说明 |
| Seedance | 实际视频 token ÷ 1,000,000 × 相应分辨率单价；带参考视频选择对应价格档 |
| Grok 视频 | 时长 × 相应分辨率秒价，加报价规定的参考图片费用 |
| 可灵视频 | 输出秒数 × 720p 秒价；首帧图片不计费 |
| 图片 | 按实际生成的张数计费 |
| 语音合成 | 按实际合成的字符数计费 |
| 音乐 | 按首计费 |
| 语音识别 | 按音频时长计费，时长由服务端读取文件得出 |
| 按次型号 | 仅当企业价格页明确按次展示时按对应单位计算 |
企业模型与价格 是当前报价入口。不要把其他站点币种、旧截图或某个型号的秒价套到所有视频上。调用量里的 input_tokens、output_tokens 也不能替代缓存、阶梯或视频的完整结算规则。
预扣与最终结算
异步任务提交时预留额度，完成后依据最终用量结算，多余预留退回，实际费用高于预留时可能补扣。预扣是估算，不是最终价格上限。确认失败并完成账务处理后，退回记录反映到企业钱包。
客户端断开、等待超时、空白响应或下载错误，都不能单独证明任务未执行或已经退款。先查任务状态与同一请求的账务状态；执行状态不明时不要重复提交。
按当前 Key 查询
汇总接口 返回 currency: CNY，金额为十进制字符串：
| 字段 | 含义 |
|---|---|
settled_amount | 已结算记录汇总，可能包含负向调整 |
pending_amount | 仍待结算的预留金额 |
refunded_amount | 已记录退回的金额 |
unknown_records | 尚无法确认账务状态的记录数 |
不能简单用 settled_amount - refunded_amount 再算消费，退回可能已经体现在结算投影中。汇总是记录视图，不是钱包余额或充值金额。
请求记录接口 的 billing_status 区分 pending、settled、refunded、unknown。amount: null 表示没有确定金额，不是免费。usage_estimated: true 表示用量包含估算。
有疑问时如何对账
保留企业域名、时间及其时区、模型、Request ID、视频任务 ID 和错误正文。先用创建请求的 Key 查询对应 request_id，再查看任务最终状态和企业控制台记录。记录暂未出现时，适当等待并核对查询时间范围；空列表不证明没有产生费用。
向支持人员提供上述标识和脱敏记录，不要发送完整 Key、付款敏感信息或完整签名下载链接。若支付状态与余额不一致，还需提供企业充值订单号。