云凡智联

首页/开放能力

Consumption

消费记录

用于查询当前 Token 对应账号在指定日/月范围内的接口消费汇总。该接口返回聚合后的任务数和总消耗积分，不分页、不返回逐条任务明细。

GET/api/third-party/user/consumption-summary

请求头

字段	类型	必填	说明
X-API-Token	string	是	平台提供的调用凭证，用于识别当前账号或租户。

Query 参数

字段	类型	必填	说明
period	string	是	统计周期，可选 day 或 month。
date	string	是	查询日期。period=day 时传 YYYY-MM-DD；period=month 时传 YYYY-MM。

按日查询示例

bash

curl -X GET "https://yunfanzhilian.com/api/third-party/user/consumption-summary?period=day&date=2026-03-31" \
  -H "X-API-Token: your_token"

按月查询示例

bash

curl -X GET "https://yunfanzhilian.com/api/third-party/user/consumption-summary?period=month&date=2026-03" \
  -H "X-API-Token: your_token"

响应字段

字段	类型	必填	说明
data.period	string	-	本次查询的统计周期。
data.date	string	-	本次查询的统计日期。
data.startDate	string	-	统计开始时间，ISO 8601 格式。
data.endDate	string	-	统计结束时间，ISO 8601 格式。
data.totalTasks	number	-	该周期内的任务总数。
data.totalConsumedCoins	number	-	该周期内消耗的总积分。
data.items[]	object[]	-	按能力类型聚合的消费明细。

响应示例

json

{
  "code": 200,
  "message": "获取三方消费记录成功",
  "data": {
    "period": "day",
    "date": "2026-03-31",
    "startDate": "2026-03-30T16:00:00.000Z",
    "endDate": "2026-03-31T16:00:00.000Z",
    "totalTasks": 2,
    "totalConsumedCoins": 54,
    "items": [
      {
        "apiType": "genDetail",
        "totalTasks": 1,
        "totalConsumedCoins": 50
      },
      {
        "apiType": "genImage",
        "totalTasks": 1,
        "totalConsumedCoins": 4
      }
    ]
  },
  "timestamp": "2026-03-31T10:05:00.000Z"
}

参数说明

text

说明：
- period=day 时，date 使用 YYYY-MM-DD
- period=month 时，date 使用 YYYY-MM
- 返回字段中 totalConsumedCoins 为当前日/月的总消费积分