Skip to content

查询企业调用日志 ​

返回企业模式下的消费日志。按调用方权限范围过滤:企业管理员可查看全企业;非管理员按部门 / 本人可见范围过滤。

接口路径 ​

http
GET /api/open/log/enterprise

限流说明 ​

本接口限流:每用户每分钟最多 5 次,独立于其它 Open 限流。

花费计算说明 ​

最终花费(人民币)计算方式:

最终花费(¥) = quota ÷ quota_per_unit × usd_exchange_rate

其中:

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

若 quota_display_type = USD(美元),则去掉 × usd_exchange_rate。

请求参数 ​

字段类型是否必传说明限制条件备注
enterprise_idint是企业 ID业务校验必填(<=0 会报错)可从 查询我的企业信息 接口获取
start_timestampint64否开始时间戳(秒)与 end_timestamp 的差值不能超过 1 个自然月示例: 1711468800
end_timestampint64否结束时间戳(秒)与 start_timestamp 的差值不能超过 1 个自然月示例: 1711555200
token_namestring否Token 名称过滤精确匹配示例: ximi令牌2
organization_idint否组织(部门)ID 过滤须属于该企业;含子孙部门范围示例: 2001
member_idint否成员 ID 过滤须属于该企业可从 查询组织成员 接口获取;示例: 5001
billing_sourcestring否按扣费来源过滤消费日志支持单个值或逗号分隔多值;空或不传、或 -1 = 不过滤(返回全部来源,含权益类)见下文取值枚举
pint否页码默认 1示例: 1
page_sizeint否每页数量默认 10;最大 500示例: 20

billing_source 取值枚举

值含义典型场景
0余额按量扣费普通 API Key 现金/余额调用
1订阅席位权益订阅包席位调用
2权益包 / 资源包资源包调用
3免费免费额度调用

时间范围规则 ​

情景处理方式
start_timestamp 与 end_timestamp 均未传默认 start = now - 86400,end = now(最近 24 小时)
只传其一不套用默认 24 小时规则
开始时间与结束时间差值超过 1 个自然月请求失败

请求示例 ​

JSON
GET 'https://neolink.com/backend/api/open/log/enterprise?enterprise_id=1001&p=1&page_size=20'

返回信息 ​

字段类型是否必传说明备注
successbool是请求是否成功固定值
messagestring是错误提示信息(成功时为空)固定值
dataPageInfo是分页数据对象详见下表

PageInfo 对象

字段类型是否必传说明备注
pageint是当前页码
page_sizeint是每页条数
totalint是总条数
items[]LogItem是日志列表详见下表

LogItem 对象

字段类型是否必传说明备注
request_idstring是请求 ID
created_atint64是创建时间Unix 秒级时间戳
token_namestring是Token / API Key 名称
model_namestring是模型名称
quotaint是消耗配额花费计算见上文「花费计算说明」
prompt_tokensint是输入 Token 数
completion_tokensint是输出 Token 数
cache_tokensint64是缓存命中 Token 数
cache_creation_tokensint64是缓存创建 Token 数
use_timeint是请求耗时(秒)
is_streambool是是否流式true=流式;false=非流式
member_namestring是成员名称对应「成员」列
organization_namestring是部门名称对应「部门」列

返回示例 ​

JSON
成功响应
{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 1,
    "items": [
      {
        "request_id": "req_abc123",
        "created_at": 1747818790,
        "token_name": "ximi令牌2",
        "model_name": "gemini-1.5-pro",
        "quota": 442680,
        "prompt_tokens": 166833,
        "completion_tokens": 226,
        "cache_tokens": 0,
        "cache_creation_tokens": 0,
        "use_time": 1,
        "is_stream": false,
        "member_name": "user_390500_9128",
        "organization_name": "部门 2"
      }
    ]
  }
}
空列表
{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 0,
    "items": []
  }
}
错误响应
{
  "success": false,
  "message": "企业ID必填"
}
{
  "success": false,
  "message": "无权查看该部门日志"
}