汇总使用历史

GET /auth/usage/history/v2/summary

获取轻量 usage events summary，用于账号页列表快速渲染。

REST API 概览 · OpenAPI JSON · OpenAPI YAML

接口契约

稳定性	认证	费用	Operation ID
已发布	Bearer API 密钥	免费	`get_usage_history_v2_summary_api_v1_auth_usage_history_v2_summary_get`

参数

名称	位置	必填	类型	说明
`start_date`	query	否	`string \| null`	开始日期 (YYYY-MM-DD)
`end_date`	query	否	`string \| null`	结束日期 (YYYY-MM-DD)
`event_type`	query	否	`string \| null`	事件类型过滤
`kind`	query	否	`string \| null`	事件分组过滤
`success`	query	否	`boolean \| null`	是否成功
`billable_success`	query	否	`boolean \| null`	是否可计费
`outcome`	query	否	`string \| null`	执行 outcome 过滤
`reason_code`	query	否	`string \| null`	执行 reason_code 过滤
`has_execution_outcome`	query	否	`boolean \| null`	是否存在 execution_outcome
`charge_outcome`	query	否	`string \| null`	收费结果过滤
`anomaly`	query	否	`string \| null`	异常类型过滤
`search_id`	query	否	`string \| null`	search_id 聚焦过滤
`execution_id`	query	否	`string \| null`	execution_id 聚焦过滤
`api_key_id`	query	否	`string \| null`	API Key 归因过滤
`cursor`	query	否	`string \| null`	下一页游标
`page_size`	query	否	`integer`	每页数量

请求体

此操作没有 JSON 请求体。

可运行示例

bash

curl --request GET \
  --url "https://qveris.ai/api/v1/auth/usage/history/v2/summary" \
  --header "Authorization: Bearer $QVERIS_API_KEY"

typescript

const response = await fetch("https://qveris.ai/api/v1/auth/usage/history/v2/summary", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.QVERIS_API_KEY}`,
  },
})

if (!response.ok) throw new Error(`QVeris request failed: ${response.status}`)
console.log(await response.json())

python

import os
import requests

response = requests.request(
    "GET",
    "https://qveris.ai/api/v1/auth/usage/history/v2/summary",
    headers={"Authorization": f"Bearer {os.environ['QVERIS_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

响应

状态码	含义	Schema
`200`	Successful Response	`APIResponse_UsageEventSummaryResponse_`
`422`	Validation Error	`HTTPValidationError`

成功响应示例

json

{
  "status": "string",
  "message": "string"
}

精确契约

稳定版 JSON: OpenAPI JSON
稳定版 YAML: OpenAPI YAML
版本化 JSON: OpenAPI v1 JSON
版本化 YAML: OpenAPI v1 YAML

汇总使用历史

接口契约

参数

请求体

可运行示例

响应

成功响应示例

精确契约

相关操作