用量 API

跟踪您的 API 使用情况、积分消耗,并获取 API 调用的详细分析。

GET/v1/usage

参数

参数类型必填描述
start_datestring可选起始日期,格式为 YYYY-MM-DD
end_datestring可选结束日期,格式为 YYYY-MM-DD
endpointstring可选按特定端点过滤

响应

Response
{
  "records": [
    {
      "date": "2025-01-15",
      "endpoint": "/v1/paper-search/google",
      "calls": 45,
      "credits_used": 45
    },
    {
      "date": "2025-01-15",
      "endpoint": "/v1/citation/verify",
      "calls": 12,
      "credits_used": 24
    }
  ],
  "total_credits_used": 69
}

示例

import requests

response = requests.get(
    "https://api.qinyanai.com/v1/usage",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={
        "start_date": "2025-01-01",
        "end_date": "2025-01-31",
    }
)

data = response.json()
print(f"Total credits used: {data['total_credits_used']}")