查询企业账户用量

接口路径

GET /api/open/data/enterprise

配额计算说明

quota 为内部额度单位，换算成金额（人民币）的方式：

金额(¥) = quota ÷ quota_per_unit × usd_exchange_rate

其中：

• quota：来自本接口返回的 data[].quota
• quota_per_unit、usd_exchange_rate、quota_display_type：来自 查询换算参数 接口（GET /api/open/status）

若 quota_display_type = USD（美元），则去掉 × usd_exchange_rate。

请求参数

字段	类型	是否必传	说明	限制条件	备注
start_timestamp	int64	否	开始时间戳（秒）	与 end_timestamp 配合使用；默认为最近7天	示例: 1711468800
end_timestamp	int64	否	结束时间戳（秒）	与 start_timestamp 配合使用；默认为当前时间	示例: 1712073600
enterprise_id	int	是	企业ID	可选，若传入则查询指定企业的数据	示例: 1001
organization_id	int	否	部门ID	可选，若传入则查询指定部门的数据	示例: 1001
member_id	int	否	成员ID	查自己的时候传入	示例: 234

返回信息

字段	类型	是否必传	说明	备注
success	bool	是	请求是否成功	固定值
message	string	是	错误提示信息（成功时为空）	固定值
data	[]QuotaData	是	配额统计数据数组	详见下表

QuotaData 对象

字段	类型	是否必传	说明	备注
id	int	是	记录 ID	数据库唯一标识
user_id	int	是	用户 ID	操作者用户 ID
username	string	是	用户名	用户登录名
model_name	string	是	模型名称	如 "gpt-4"、"gpt-3.5-turbo"
created_at	int64	是	创建时间	Unix 秒级时间戳
token_used	int64	是	消耗 Token 数	本周期内消耗的 Token 总数
quota	int64	是	配额额度	本周期分配的配额；换算见上文「配额计算说明」
count	int	是	调用次数	本周期的总调用次数
enterprise_id	int	是	企业 ID	所属企业
organization_id	int	是	部门 ID	所属部门
member_id	int	是	成员 ID	企业内部的成员 ID
token_id	int	是	Token ID	关联的 Token 记录 ID；0 表示无关联

返回示例

成功响应
{
  "success": true,
  "message": "",
  "data": [
    {
      "id": 1,
      "user_id": 100,
      "username": "john_doe",
      "model_name": "gpt-4",
      "created_at": 1711497600,
      "token_used": 12500,
      "quota": 62500,
      "count": 25,
      "enterprise_id": 1001,
      "organization_id": 2001,
      "member_id": 101,
      "token_id": 0
    }
  ]
}
错误响应
{
  "success": false,
  "message": "权限不足，需要企业管理员或拥有者权限"
}