计费规则
本页详细说明 primerouter 的计费机制、边界情况、退款政策。
计费时点
| 阶段 | 行为 |
|---|---|
| 请求进来 | 按估算上限预扣配额(防止超额使用) |
| 请求成功 | 按真实 usage 结算,多退少补 |
| 请求失败 | 已预扣全额退回 |
| 流式中断 | 按已收到的 chunk 实际 token 数结算 |
预扣系数 = max_tokens × 1.2(默认;由站点管理员在后台调整)
token 怎么数
primerouter 不自己数 token——直接用上游响应的 usage 字段:
- prompt_tokens:上游统计的输入 token
- completion_tokens:上游统计的输出 token
- 与上游账单字节级一致
详见 用量统计。
多模态怎么计费
| 类型 | 计费维度 | 备注 |
|---|---|---|
| 文本 | input + output tokens | 标准做法 |
| 图像输入(vision) | 计入 input tokens | 各家 token 化策略不同,按上游折算 |
| 图像生成 | 张数 × 单张价 | 与 token 无关 |
| 视频生成 | 时长(秒)× 单价 | 异步任务,按完成结果计 |
| 音频 TTS | 字符数 × 字符价 | |
| 音频 STT | 输入音频秒数 × 秒价 |
失败 / 重试
如果 primerouter 路由到上游 A 失败、又自动尝试上游 B 成功,只对 B 计费一次。
中途失败的所有上游侧消耗(如 A 已经流出几十个 token 才挂掉),由 primerouter 内部承担——不会双重扣你。
限流不计费
被限流(429)的请求不计费。
取消请求
| 情形 | 行为 |
|---|---|
| 流式调用客户端断连 | 上游通常继续生成完成——按真实输出计费 |
显式 abort | 立即关闭上游 socket(如上游支持),按已生成 token 计费 |
| 异步任务(视频/音乐)取消 | 未真正进入「生成中」前取消免费;已开始视上游能否取消,否则按真实消耗结算 |
流式请求要省钱:客户端 abort 时主动关闭 HTTPS socket——等待自然 timeout 期间上游仍在生成。
退款政策
primerouter 默认不支持充值退款——配额仅可用于消耗,不可提现。
例外:
- 重复扣费:系统 bug 导致同一请求扣多次——通过 日志 提供 trace_id 给客服,确认后退回配额
- 客服判定的差错:如管理员误删余额、错误调倍率等
- 加密充值的链上错位(转错链等):尽力恢复,详见 加密支付 FAQ
退款只退到站内配额(增加余额),不退到原支付方式。
长任务的预扣回写
视频 / 音乐这类长任务:
- 提交时按估算预扣(如 5 美元)
- 任务完成后按真实结果结算(如 4.2 美元)
- 差额(0.8 美元)退回余额
任务失败:全额退回。
跨日 / 月对账
按结算时刻计入对应日期。流式请求的 token 全部归到完成时刻那一天,即使开始横跨午夜。
配额单位
站点可配置使用的内部单位:
- USD:直接显示美元(站点默认)
- CNY:人民币
quota:内部抽象单位(与货币 1:1 或固定比例)
具体的基础货币由站点管理员在后台配置。
最低充值
各支付方式有各自的最低充值阈值(典型 $5-10)。低于阈值的支付不入账——加密充值会保留链上记录但不结算。
余额到期?
标准账户余额不过期。但:
- 账号被删除:余额作废
- 长期不活跃账号:站点保留按合规要求清理的权利(≥ 12 个月不活跃)
计费透明性
每条 日志 都可点开查看:
- 你的请求 → 路由到哪个上游 → upstream usage 字段 → 实际扣费
如发现实际扣费不等于 usage × 单价 × 倍率,请把 trace_id 发给客服。这是 架构原理 中描述的「不膨胀 token」承诺的可程序化验证。
