跳到主要内容

费用对账

费用对账接口用于查询当前账号的消费汇总、消费明细和当前余额。目前仅支持统计 API 项目产生的消费记录，后续将支持非 API 项目，以及充值、赠送、解冻等非消费流水。

需要认证: 是

费用汇总查询​

接口地址: POST /api/reconciliation/summary

接口描述: 查询指定日期范围内 API 项目的消费总金额和消费次数。返回结果会包含本次请求参数，便于客户侧对账落库。

请求参数​

Body 参数:

字段名类型必需描述示例值
startDateString是对账开始日期，格式：yyyy-MM-dd"2026-06-01"
endDateString是对账结束日期，格式：yyyy-MM-dd"2026-06-30"
aiModelString否AI 模型过滤条件，详见AI 平台列表；不传则查询全部模型"doubao"
taskIdString否API 任务 ID；传入后只统计该任务下的消费记录"e619e12d90d644ae9e64ea26472df007"

请求限制:

  • startDate 不能晚于 endDate
  • 单次查询日期范围最多支持 31 天
  • 目前仅支持统计 API 项目产生的消费记录，后续将支持非 API 项目及非消费流水

请求示例​

{
    "startDate": "2026-06-01",
    "endDate": "2026-06-30",
    "aiModel": "doubao",
    "taskId": "e619e12d90d644ae9e64ea26472df007"
}

curl 示例​

curl -X POST "https://business-api.molizhishu.com/api/reconciliation/summary" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2026-06-01",
    "endDate": "2026-06-30",
    "aiModel": "doubao",
    "taskId": "e619e12d90d644ae9e64ea26472df007"
  }'

响应结果​

成功响应:

{
    "success": true,
    "code": 200,
    "message": "操作成功",
    "data": {
        "startDate": "2026-06-01",
        "endDate": "2026-06-30",
        "aiModel": "doubao",
        "taskId": "e619e12d90d644ae9e64ea26472df007",
        "totalCount": 1280,
        "totalConsume": "356.80"
    }
}

响应字段说明:

字段名类型描述
startDateString请求参数：对账开始日期
endDateString请求参数：对账结束日期
aiModelString请求参数：AI 模型过滤条件；未传时为空字符串
taskIdString请求参数：API 任务 ID；未传时为空字符串
totalCountLong消费记录总条数
totalConsumeString消费总金额

费用明细查询​

接口地址: POST /api/reconciliation/records

接口描述: 分页查询指定日期范围内 API 项目的消费明细。接口使用传统分页，明细按交易时间倒序返回。

请求参数​

Body 参数:

字段名类型必需默认值描述示例值
startDateString是-对账开始日期，格式：yyyy-MM-dd"2026-06-01"
endDateString是-对账结束日期，格式：yyyy-MM-dd"2026-06-30"
aiModelString否-AI 模型过滤条件，详见AI 平台列表；不传则查询全部模型"doubao"
taskIdString否-API 任务 ID；传入后只查询该任务下的消费明细"e619e12d90d644ae9e64ea26472df007"
pageNumInteger否1页码，从 1 开始1
pageSizeInteger否100每页条数，最大 1000100

请求限制:

  • startDate 不能晚于 endDate
  • 单次查询日期范围最多支持 31 天
  • pageSize 最大支持 1000
  • 分页查询深度超过限制时会返回错误，请缩小时间范围或增加筛选条件后重试
  • 目前仅支持统计 API 项目产生的消费记录，后续将支持非 API 项目及非消费流水

请求示例​

{
    "startDate": "2026-06-01",
    "endDate": "2026-06-30",
    "aiModel": "doubao",
    "taskId": "e619e12d90d644ae9e64ea26472df007",
    "pageNum": 1,
    "pageSize": 100
}

curl 示例​

curl -X POST "https://business-api.molizhishu.com/api/reconciliation/records" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2026-06-01",
    "endDate": "2026-06-30",
    "aiModel": "doubao",
    "taskId": "e619e12d90d644ae9e64ea26472df007",
    "pageNum": 1,
    "pageSize": 100
  }'

响应结果​

成功响应:

{
    "success": true,
    "code": 200,
    "message": "操作成功",
    "data": {
        "records": [
            {
                "id": 10001,
                "taskId": "e619e12d90d644ae9e64ea26472df007",
                "subTaskId": 20001,
                "taskCreatedTime": 1781917200000,
                "taskCompletedTime": 1781919012000,
                "transactionTime": 1781920812000,
                "amount": "0.18",
                "description": "豆包（网页版）+深度思考",
                "aiModel": "doubao",
                "aiModelText": "豆包（网页版）",
                "question": "目前市场上销量较高的手机品牌有哪些"
            }
        ],
        "total": 1280,
        "currentPage": 1,
        "pageSize": 100,
        "totalPages": 13
    }
}

响应字段说明:

字段名类型描述
recordsArray消费明细列表
records[].idLong计费流水 ID
records[].taskIdStringAPI 任务 ID
records[].subTaskIdLongAPI 子任务 ID，对应子任务查询接口中的 subTaskId
records[].taskCreatedTimeLong任务创建时间，Unix 时间戳，单位秒
records[].taskCompletedTimeLong任务完成时间，Unix 时间戳，单位秒
records[].transactionTimeLong交易时间，Unix 时间戳，单位秒
records[].amountString消费金额
records[].descriptionString消费备注
records[].aiModelStringAI 模型原始值
records[].aiModelTextStringAI 模型展示名称
records[].questionString本次消费对应的问题
totalLong符合条件的消费记录总条数
currentPageInteger当前页码
pageSizeInteger本次查询每页条数
totalPagesInteger总页数

当前余额查询​

接口地址: GET /api/reconciliation/balance

接口描述: 查询当前账号可用余额。

请求参数​

无。

curl 示例​

curl -X GET "https://business-api.molizhishu.com/api/reconciliation/balance" \
  -H "Authorization: Bearer YOUR_TOKEN"

响应结果​

成功响应:

{
    "success": true,
    "code": 200,
    "message": "操作成功",
    "data": {
        "currentBalance": "1288.66"
    }
}

响应字段说明:

字段名类型描述
currentBalanceString当前账号可用余额

错误响应​

{
    "success": false,
    "code": 400,
    "message": "单次对账查询最多支持31天",
    "data": null
}

常见错误：

codemessage说明
400请选择对账时间范围startDate 或 endDate 为空
400开始时间不能晚于结束时间startDate 晚于 endDate
400单次对账查询最多支持31天查询日期范围超过 31 天
400pageSize 最大支持1000明细查询 pageSize 超过 1000
400查询结果较多，请缩小时间范围或增加筛选条件后重试明细查询分页深度超过限制