账单查询API
⚠️ 说明：对于后付费的月结企业用户，实时查询接口的账单仅用于日常计费参考，平台每月初会对上个月账单进行自动校对，实际账单以下个月1号14:00之后的数据为准。
若接入本接口，请您对每月账单进行下月初复合查询的逻辑。
日账单明细（计费项粒度）查询
请求参数
字段 | 类型 | 是否必填 | 示例 | 描述 |
Action | String | 是 | DescribeBillDayDetail | 公共参数，取值：DescribeBillDayDetail |
BillingCycle | String | 是 | 2025-06-09 | 账期，格式 yyyy-MM-dd |
Offset | Integer | 否 | 0 | 偏移量，默认值为0 |
Limit | Integer | 否 | 20 | 数量，最大值为100，默认值为20 |
BillingMethod | String | 否 | post_paid | 计费方式 |
ProdCode | String | 否 | WANQING | 主产品编码 |
返回参数
参数名称 | 类型 | 描述 |
Total | Integer | 账单明细总量 |
Offset | Integer | 当前偏移量 |
Limit | Integer | 当前数量 |
Billings | Array of DayDetailItem | 日账单明细列表 |
DayDetailItem
参数名称 | 类型 | 描述 |
BillingCode | String | 账单编码 |
CustomerId | String | 账号ID |
ProjectId | String | 项目ID |
BillingCycle | String | 账期 yyyy-MM-dd |
ProdName | String | 所属产品名称 |
GoodsName | String | 所属子产品名称 |
FeeItemName | String | 所属计费名称(计费项) |
Factors | String | 影响因子，所属计费规格 |
StartTime | Long | 开始时间(毫秒时间戳) |
EndTime | Long | 结束时间(毫秒时间戳) |
BillingMethod | String | 计费方式 |
TotalUsage | String | 用量 |
Unit | String | 用量单位 |
PubPrice | String | 刊例价 |
PubPriceUnit | String | 价格单位 |
Discount | String | 折扣 |
DiscountPubPrice | String | 折后单价 |
SourcePrice | String | 账单原价 |
PayableAmount | String | 折后价（精度到分） |
CouponDeductAmount | String | 代金券抵扣 |
RemainingPayableAmount | String | 应付金额 |
CashPaymentAmount | String | 现金支付 |
CurrencyUnit | String | 币种 CNY/USD |
FeeItemVersion | Long | 计费项版本号 |
API示例
请求示例
curl -X POST 'https://bill.streamlakeapi.com/?Action=DescribeBillDayDetail' \
-H 'Content-Type: application/json' \
-H 'TenantCode: your_tenant_code' \
-d '
{
"BillingCycle": "2025-06-09",
"Limit": 5
}
'
返回示例
HTTP/1.1 200 OK
Content-Type: application/json
{
"ResponseMeta": {
"RequestId": "rB05A2Lp6Lo123456789",
"ErrorMessage": "",
"ErrorCode": ""
},
"ResponseData": {
"Total": 1,
"Offset": 0,
"Limit": 5,
"Billings": [
{
"BillingCode": "123456789a1d4578682de987654321",
"BillingCycle": "2026-06-15",
"CustomerId": "123456789",
"ProdName": "快手万擎",
"GoodsName": "基础模型推理",
"FeeItemName": "Gemini-3-Pro-Image-在线推理",
"BillingMethod": "post_paid",
"TotalUsage": "1.120000",
"Unit": "per_1000_tokens",
"SourcePrice": "0.9542400000",
"Discount": "1.0000000000",
"DiscountPrice": "0.0000000000",
"PayableAmount": "0.9500000000",
"RemainingPayableAmount": "0.9500000000",
"CouponDeductAmount": "0.0000000000",
"CashPaymentAmount": "0.0000000000",
"PubPrice": "0.8520000000",
"DiscountPubPrice": "0.8520000000",
"PubPriceUnit": "￥/per_1000_tokens",
"Factors": "customTokenType=图片输出",
"ProjectId": "P123456789default987654321",
"CurrencyUnit": "CNY",
"StartTime": 1781452800000,
"EndTime": 1781539259000,
"FeeItemVersion": 123
}
]
}
}