计费与配额
八个计价单位、档位怎么定、接口里的金额怎么读、预扣与结算、余额流水与对账口径。
内容最后核对: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 是同一套整数。
预扣与结算
同步调用(文本、图片、语音)按响应里的用量当场结算。异步任务(视频、音乐)分三步:
- 提交时按上限冻结一笔(
reserveQuota)—— 这是冻结,不是扣款。 - 终态时按上游回报的实际用量结算(
settleQuota),多退少补。 - 失败一律全额释放:
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);界面上没有导出按钮,需要批量导出请联系管理员。