BI 数据接入
支付、退款、模型估算成本与 AI 功能调用的只读取数指南。
本接口供汉印美照 BI 看板读取本平台已记录的数据。服务地址为 https://aiapi.hprtcloud.com，接口前缀为 /api/v1/bi。本文描述当前契约；上线及账号交付以实际环境验收为准。
| 数据 | 接口 | 范围 |
|---|---|---|
| 支付与退款汇总 | GET /payments | 支付额、退款受理、已确认退款、退款撤销、净交易额，按日及渠道汇总 |
| 订单 | GET /payment-orders | 订单号、渠道、产品、金额、当前状态及时间 |
| 支付与退款流水 | GET /payment-events | 事件 ID、订单号、事件类型、金额及确认时间 |
| AI 功能与模型成本 | GET /usage | 功能调用量、成功失败率、每日统计与模型费用估算 |
| 功能调用明细 | GET /calls | 调用 ID、功能代码、功能名称、状态与创建／开始／完成时间 |
账号角色为 bi_reader，可读取平台全部支付、退款及上述 AI 统计。不提供用户身份、照片、提示词、输入输出、错误原文、执行步骤或供应商原始响应；不授予下单、退款、发放权益、任务操作或平台管理权限。自动采集 Key 只开放上述五类读取；人工账号可通过兼容登录方式修改自己的密码。
本入口的目录、搜索、接口参考及下载契约只包含 BI 接入内容。文档本身公开可读，阅读文档不会获得接口权限；每次接口请求均验证账号状态、当前角色及 Key 有效期／撤销状态，兼容账号方式另检查会话版本。App 接入文档与内部运维文档分别维护，新增接口默认不会进入 BI 契约。
历史系统订单、独立支付测试服务和未进入本平台的收入不包含在此范围内。平台空结果表示所选范围暂无记录，不证明其他系统没有收入。
建议每 60 秒更新一次汇总。初次导入按日期窗口分批；单次最多 366 天，明细每页最多 200 条。日期按北京时间，时间字段为带时区的 ISO 8601。跨币种分别取数，不自动汇率换算。