用途:查询华为云 MaaS(Model as a Service)用量统计,数据与华为云控制台一致,包含总 Token、提示 Token、补全 Token、总请求数与总错误数,可查询近7天、14天、30天或自定义时间范围(默认按预设服务查询)。
主要能力:基于 ShowStatistics API;支持永久/临时 AK/SK 及凭据文件;超过30天自动分段聚合;Token 单位由千换算为 M;输出表格含错误率;结果可与控制台比对(差异通常小于0.1%)。
使用方式:需 Python 3.8+,安装依赖 pip install huaweicloudsdkcore requests(UTC+8 时可加 -i https://mirrors.huaweicloud.com/repository/pypi/simple)。凭据通过环境变量 HW_ACCESS_KEY、HW_SECRET_KEY(临时凭据加 HW_SECURITY_TOKEN)或 --credentials-file 提供,不在对话中传递。核心命令:python3 scripts/maas_rest_usage_stats.py --from 2026-05-08 --to 2026-05-21,可加 --service-type(1 我的服务、2 预设服务、4 自定义端点)、--infer-type batch、--api-keys、--raw 等参数。签名使用 huaweicloudsdkcore.Signer,AK/SK 不出现在 ps -ef 中,禁止手写签名、禁止 hcloud configure set 传明文、禁止 service_type=3。
适用场景:MaaS 用量与错误率核查、与账单或控制台对账、按 API Key 或推理类型过滤统计。
限制:仅支持 cn-southwest-2(西南-贵阳一)区域;API 仅保留 30 天数据;限流总请求≤1000/分钟、单用户≤200/分钟;只读查询,不得修改或删除 MaaS 服务、端点或配置;需具备 ModelArts 监控及 IAM 读取权限。未提供的细节(如具体费用)暂未说明。