接入文档 / 计费与排错

计费说明

价格怎么算、失败会不会扣费、余额与套餐的扣费顺序。

价格怎么算

• 按量计费的模型以「美元 / 百万 Tokens」计价，输入、输出分别计费；支持缓存的模型，缓存读取与缓存写入单独计价（通常缓存读取远低于输入价）。
• 实际扣费 = 模型单价 × 分组倍率。密钥绑定分组，各分组倍率在「模型价格」页可见。
• 部分模型采用阶梯计费：单次请求的输入超过某个长度后整次按更高一档计价，档位在模型详情里标出。
• 按次计费的模型（如部分图像模型）每次调用固定价格。
• 充值时按 ¥1.00 / 美元换算为余额；每次调用的实际扣费以控制台「用量」为准，每条记录都能展开查看计费明细。

失败会不会扣费

• 请求在发出前会按预估额度先冻结一部分；最终失败（包括重试后仍失败）时，冻结的额度会全部退回，不收费。
• 例外：少数渠道在上游判定为严重违规内容（如涉及未成年人的违法内容）时，若站点开启了违规扣费，会额外收取一笔固定费用，在用量明细中作为单独一条「Violation fee charged」记录。
• 成功的请求按实际用量结算，多退少补。

余额与套餐

• 同时有余额和套餐时，按「套餐 → 扣费顺序」里的设置扣费：优先套餐（默认）、优先余额、只用套餐、只用余额。
• 有多个生效中的套餐时，先用最早到期的那个。
• 用量明细的计费明细里会写明本次扣的是余额还是哪个套餐。

密钥额度

每把密钥可以单独设置额度上限和过期时间。密钥额度用完或过期后，该密钥的请求会返回 401，不影响账户里的其他密钥。