Skip to main content
按日期和 API 汇总当前账户的请求次数与实际扣除额度,适合制作月报、趋势图和成本分析。需要逐条排错时使用调用记录列表,需要完整离线明细时使用调用量导出。

准备工作

  1. 登录 AceDataCloud 平台。
  2. 在 Account Token 控制台创建账户令牌,并立即保存。
  3. 如需缩小范围,从服务申请列表、API 凭证列表或API 列表获取相应 ID。
完整令牌说明见管理账户令牌。本接口使用 Account Token,不使用业务 Credential。

接口概览

查询参数

start_time / end_time 作为旧客户端兼容别名仍可使用,新接入统一使用 created_at_from / created_at_to。日期形式的 created_at_to 会包含该自然日,即按下一日零点作为边界。

请求示例

查询北京时间本月每日/API 汇总,并附带模型维度:
查询指定 Application 的一周用量:
Python 示例:

响应示例

响应字段

额度单位取决于相关 Application 的 service.unit。若查询包含不同单位的服务,请先按 service_id 或 application_id 分开统计,避免直接比较或相加。 结束时间不大于开始时间时,接口返回完整空结构:items=[]、total=0、apis={}、requests=0、models=[]。

错误与性能建议

  • 默认不要开启 include_models;只有报表确实需要模型拆分时再启用。
  • 大范围查询优先按 service_id 或 application_id 分开,既避免混合单位,也降低查询成本。
  • 没有调用的日期不会自动补零,绘图前由客户端补齐日期轴。

下一步