跳转到主要内容
POST
/
api-user
/
usage
/
search
查询 API 使用记录
curl --request POST \
  --url https://dk.mountsea.ai/api-user/usage/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "dateRange": {
    "start": 1767801600000,
    "end": 1773071999999
  },
  "page": 1,
  "limit": 10,
  "serviceId": "<string>"
}
'

​
响应示例

{
  "items": [
    {
      "id": 52,
      "serviceName": "chat",
      "apiPath": "/v1/chat/completions",
      "apiMethod": "POST",
      "apiKey": "3a43****a987",
      "amount": 15,
      "statusCode": 200,
      "traceId": "1d110e91-9d69-4325-bd42-b55583ae6dc5",
      "metadata": {
        "model": "gpt-5.1"
      },
      "createdAt": "2025-08-06T09:36:54.083Z"
    }
  ],
  "meta": {
    "totalItems": 256,
    "itemCount": 10,
    "itemsPerPage": 10,
    "totalPages": 26,
    "currentPage": 1
  }
}

​
响应字段

​
items[] — 使用日志记录

字段类型描述
idnumber记录 ID
serviceNamestring服务名称（如 chat、gemini）
apiPathstringAPI 请求路径
apiMethodstringHTTP 方法（GET、POST 等）
apiKeystring使用的 API Key（已脱敏）
amountnumber消耗的积分
statusCodenumberHTTP 响应状态码
traceIdstring请求追踪 ID，用于问题排查
metadataobject | null附加元数据（如模型名称、token 使用量）
createdAtstring创建时间（ISO 8601）

​
meta — 分页信息

字段类型描述
totalItemsnumber总记录数
itemCountnumber当前页记录数
itemsPerPagenumber每页大小
totalPagesnumber总页数
currentPagenumber当前页码
dateRange 参数是必填的。最大日期范围跨度为 90 天。时间戳单位为毫秒。

授权

​
X-API-Key
string
header
必填

请求体

application/json
​
dateRange
object
必填

日期范围（毫秒时间戳，最大跨度90天）

​
page
number
默认值:1

页码

​
limit
number
默认值:10

每页条数

​
serviceId
string

服务ID（可选，不传则查全部）

响应

201 - undefined