文档目录

计费与配额

八个计价单位、档位怎么定、接口里的金额怎么读、预扣与结算、余额流水与对账口径。

内容最后核对:2026-11-18

本页目录

价格不是「一条倍率」

它是三件事相乘:单位 × 单价 × 档位。单位只有八个,档位由请求里决定成本的参数决定。

八个计价单位

单位用在哪计数从哪来常见坑
per_token文本上游 usage;上游未回报时按估算估算与上游口径可能略有差异,快照里会标记为 estimated
per_1k_tokens文本(上游价目按 1K 报)同上 ÷1000先取整再乘单价会把 1000 token 以下的请求抹成 0
per_1k_chars语音合成输入文本字符数不能用 token 近似:百炼自己写明 1 字符 = 1.5 token,差 50%
per_call按次(一次性调用、任务提交)请求数—
per_image按张上游实际返回的张数要 2 张只回 1 张时按 1 张收,usage.shortfall 写差额
per_track音乐按首实际产出的音轨数有的音乐上游一次返回两首,按次计价会少收一半
per_second视频 / 音频按时长上游回报的实际时长上游不回报时退回请求值,并按估算标记
per_minute音乐按分钟物理秒数 ÷60整除会在 3 分 47 秒这种长度上每单少收十几秒

金额按高精度计算,只在最终结果上取整。

档位(tier)

同一个模型不同档不同价。档位来自请求里那几个「决定成本」的参数:

模态档位依据
文本没有档位(按 token 直接乘单价)
图片size 档:1K / 2K / 4K,或 1024x1024 这类具体尺寸
视频分辨率档(480P / 720P / 1080P / 4K)+ 是否含视频输入(+VIDEO_IN)
语音 / 音乐没有档位:只认「档位为空」的那行价目表

两件事要记住:

  • 档位写非标准值会被忽略。 1792x1024 既不是 1080p 也不是 720p,猜成任何一个都是取错价;要走默认档,并在定价页看到「这个尺寸没有精确档位」。想要精确成本就写 720P / 1080P。
  • +VIDEO_IN 是复合档。 请求里带视频类输入(参考视频、续写)时,上游按「输入 + 输出时长」计费,所以档位变成 720P+VIDEO_IN 这种形式。判据是 video_url / referenceVideos / inputVideo 这类键任一存在且非空。

接口里的金额怎么读

接口里的金额是整数,换算口径由本站配置决定,不要写死在客户端:

curl -s <网关地址>/api/meta
{"currency": "USD",
 "billing": {"quota_per_unit": 500000, "rounding": "HALF_EVEN", "scale": 34},
 "balance_display": {"display_type": "CNY", "usd_exchange_rate": "6.6749", "fraction_digits": 2}}

于是 金额 = 数值 ÷ quota_per_unit,再按 balance_display 换成显示货币。控制台里看到的金额已经换算过;接口返回的 cost_quota / reserveQuota / settleQuota 是同一套整数。

预扣与结算

同步调用(文本、图片、语音)按响应里的用量当场结算。异步任务(视频、音乐)分三步:

  1. 提交时按上限冻结一笔(reserveQuota)—— 这是冻结,不是扣款。
  2. 终态时按上游回报的实际用量结算(settleQuota),多退少补。
  3. 失败一律全额释放:settleStatus=RELEASED、settleQuota=0。这就是「一分钱没扣」的凭据。

settleStatus 四个取值:NONE(还没结算)、SETTLED(已按实际结算)、RELEASED(失败全额释放)、REFUNDED(已退款)。

改价不影响已下单的任务。 每次下单会把当时的定价记进 priceSnapshot(单位、单价、档位、秒数),结算只读快照 —— 所以一笔跑 20 分钟的单子不会因为中途改价而变账。

余额不足为什么是 402

SDK 通常把 4xx 当「你请求错了」,会展示成「改参数重试」;而 402 的语义是「要钱」,主流 SDK 见到它会停止重试并提示充值。这是唯一一处刻意不用 400 的地方。

服务不透支:余额不足时同步调用直接失败,异步任务在预扣阶段就失败,不会先跑完再告诉你付不起。

余额、流水、订单

在哪能看到什么
余额与账单 → 余额当前余额、累计消耗、本月用量
余额与账单 → 流水每一笔增减:原因(调用 / 冻结 / 结算 / 释放 / 充值 / 退款 / 邀请奖励)、模型、时间、金额
余额与账单 → 订单充值订单与状态;管理员可补单与退款
余额与账单 → 套餐可购买的套餐(停用的套餐不再出现,但历史订单仍可查)

对账建议

  • 用 priceSnapshot 核历史账单,不要用「现在价目表上的价」:后者可能已经改过。
  • 使用日志每行带 cost_quota(金额)、unit(计价单位),也带失败原因(error_code / error_message)—— 失败请求同样有行,但没有费用。
  • 「平均延迟」的口径是上游给出回应的时间:同步请求是整次调用,流式是首帧,异步任务是提交受理的耗时(不是产物时长)。
  • 大批量对账用 GET /api/logs 按 page 翻(pageSize 上限 200);界面上没有导出按钮,需要批量导出请联系管理员。