计费、用量与限流
在模型目录查看价格,在工作台查余额、调用明细和限流额度。停止客户端等待后,视频任务仍可能继续运行并按最终结果扣费。
计费:可能产生费用
视频生成成功后按适用价格扣费,查询或下载不会创建新任务。使用折扣套餐时,具体价格和适用规则参见折扣套餐计价说明。
停止本地等待(比如客户端超时放弃轮询)不会取消远端已创建的任务,是否扣费按任务最终结果处理。
查余额和用量
查询账户数据请登录工作台。直接调用以下账户 API 时使用登录访问令牌。
代码
GET /api/v1/balance 余额(amount/frozen_amount/currency)
GET /api/v1/balance/transactions 余额流水(充值/扣费/退款等明细,分页)
GET /api/v1/usage/records 调用明细(按调用记录 token 数与花费,可按模型/日期筛选)usage/records 里每条记录都有 status 字段,三个取值:
| 取值 | 含义 | 计费影响 |
|---|---|---|
confirmed | 已确认,可对账 | 正常扣费,计入 total_cost |
pending | 异步计费还没落定(视频任务等可能先出现此状态,稍后复查结果) | 暂不计入 total_cost,等落定 |
served_unbilled | 已服务 · 未计费——调用真的执行了(token 消耗是真实的),本次调用未扣费 | 不计入 total_cost 汇总,但 token 消耗量仍计入用量统计 |
served_unbilled 可通过调用明细的 price_source 和相关信息排查。
组织预算
组织预算与账户资金分开展示。预算按 UTC 自然日划分周期:每日为当天,每周为周一至周日,每月为自然月,起止日期均包含在周期内。界面时区不会改变预算周期。
周期结束后,后台自动保留旧周期记录,并按原限额接续当前周期。新周期单独累计由组织支付的费用,不会把旧周期的已用金额搬到新周期,也不会增加余额或授信。组织页保留历史预算;用量页展示当期组织预算,两处按相同日期判断当期。
页面跨日或恢复到前台后会刷新预算。若周期尚待更新或读取失败,页面会分别提示,避免把旧周期数字当成今天的用量。
查限流额度
代码
GET /api/v1/rate-limits/me返回你此刻实际生效的 rpm(每分钟请求数上限)与 tpm(每分钟 token 消耗上限)——这是动态值,不是写死的常量,不要拿文档里的数字硬编码限速逻辑。超限时收到 429 并带 Retry-After,按它退避重试是安全的,不会因此被限制。
完整规则(含你自己能不能调低/调高额度、多协议共享同一限流桶等细节)见调用频率限制。