API 密钥管理与计费透明：逐笔对帐的正确姿势

API Key Management and Billing Transparency

为什么逐笔对帐是第一指标

帐单争议的唯一解法是逐笔核对。可靠服务商的用量日志包含：request_id（可对照你的程式日志）、模型与对外别名、prompt／completion／cached token 分列、费用、状态码与错误分类、延迟与首字时间。

如果服务商只给一个总余额、查不到单笔——不管宣称多便宜，都建议敬而远之：你无法证明任何一笔收费是对的。

密钥管理的三原则

①按用途分密钥：测试、生产、不同专案各一把，日志才能归因；②设定上限：5 小时／单日／7 日消费上限＋并发上限，出事时自动停损；③最小权限：密钥只授权需要的模型分组，不用全开。

OlithmRouter 密钥页支持：label 标注、分组选择、rate_5h／1d／7d、并发上限、IP 白／黑名单、即时停用（revoked）与额度重置。

团队场景的额度治理

多人共用一个帐号是帐务混乱之源。正确做法：团队主帐号＋成员子帐号，每人独立密钥与限额；主帐号可看全队用量，成员看不到别人的。OlithmRouter 的团队功能支持成员上限、月度预算与冻结机制，预算触顶自动停用而不是欠费。

帐单异常的排查流程

五步法：①在用量页按时间＋密钥筛出异常时段；②看 prompt_tokens 是否异常膨胀（上下文失控）；③看状态码分布（大量失败＝上游故障期，应不计费）；④对照 request_id 与自己的程式日志；⑤仍有疑义时带 request_id 找客服——有逐笔记录的服务商才能快速结案。

常见问题

密钥泄漏了怎么办？

立即在控制台停用（revoke）该密钥并换新。OlithmRouter 的停用即时生效，已用额度在日志中可回溯。

cached token 为什么单独列出？

因为计价不同——缓存命中部分价格约为全价 1/10，分开列才能对帐。不列出 cached 的服务商，很可能把命中部分照全价收。

可以限制密钥只能用某些模型吗？

可以。建立密钥时选择分组，分组决定可用模型清单；密钥级模型清单会与分组取交集。

用量日志保留多久？

OlithmRouter 的日志长期保留可筛选查询，具体策略以控制台说明为准。

相关文章