Python脚本可一键查询大模型API余额,自动调用/v3/billing/usage接口获取账户及多项目Token消耗、剩余配额,并支持时间窗口筛选、超标告警、本地缓存比对与轻量部署。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
怎么监控公司大模型api余额?这是不少技术团队运维人员近期高频提问的问题,接下来由php小编为大家带来python一键查询token消耗额度脚本,感兴趣的开发者一起随小编来瞧瞧吧!https://api.example-ai-platform.com/v3/billing/usage
账户级用量聚合视图
1、脚本自动调用平台提供的/v3/billing/usage接口,拉取当前主账户下所有子项目在自然月内的累计Token消耗总量,涵盖输入与输出双向计费维度。
2、返回数据结构包含精确到毫秒的时间戳、各模型名称(如llm-pro-v2、embed-32k)、对应模型的input_tokens与output_tokens独立数值,便于按模型类型做横向对比分析。
3、支持通过query参数传入start_date与end_date,实现任意时间窗口内用量回溯,例如可单独提取上周五至本周四的增量消耗趋势。
4、响应体中附带quota_remaining字段,实时显示当前计费周期剩余可用额度,单位统一为千Token,避免人工换算误差。
多项目令牌隔离追踪
1、脚本内置project_id白名单机制,允许配置多个业务线专属项目标识,每次请求自动轮询各项目独立用量端点,生成分项目明细报表。
2、每个项目返回结果均携带project_name与project_tag标签,方便与内部CMDB系统中的服务树节点做映射,快速定位高消耗微服务模块。
3、当某项目单日消耗超过预设阈值(如50万tokens),脚本自动触发告警逻辑,将项目ID、超标倍数、最近三次调用峰值时间写入本地日志文件。
4、支持导出CSV格式快照,列名包括:项目标识、模型版本、日期、输入Token数、输出Token数、总消耗、剩余配额,适配BI工具直接拖拽分析。
本地缓存与差量比对
1、脚本首次运行时会创建.cache/usage_history目录,将每次获取的完整JSON响应以日期命名保存,形成不可篡改的本地用量审计链。
2、后续执行自动读取昨日缓存文件,与当前接口返回值做字段级diff,仅高亮显示input_tokens或output_tokens变动幅度超15%的模型条目。
3、缓存文件采用gzip压缩存储,单日用量数据体积控制在8KB以内,连续保存30天仅占用约240KB磁盘空间,不影响低配服务器运行。
4、当检测到接口响应异常(如HTTP 503或空body),脚本优先加载最新有效缓存并标注“数据延迟”,保障监控流程不中断。
轻量依赖与部署适配
1、仅需requests与python-dateutil两个第三方包,无图形界面依赖,可在Docker容器、Kubernetes CronJob或老旧CentOS 7服务器上原生运行。
2、认证方式采用标准Bearer Token头传递,Token从环境变量AI_API_KEY读取,规避代码硬编码风险,符合企业密钥管理规范。
3、脚本默认启用HTTP连接池复用与3秒超时重试策略,面对平台偶发抖动具备基础容错能力,单次完整执行耗时稳定在1.2秒内。
4、提供--dry-run参数开关,启用后仅打印将要发起的请求URL与Headers,不真实调用API,适合灰度验证阶段反复调试。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











