提供包含用量、价格、优惠折扣、计费规则等的计费明细信息；请于每月第2个自然日12点后获取上月完整账单数据；

注意事项

查询QPS限制为5QPS，超过限流将报错；

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ListBillDetail

要执行的操作，取值：ListBillDetail。

Version string 必选示例值：2022-01-01

API的版本，取值：2022-01-01。

PayerID long[] 可选示例值：[2100057673]

Payer账号ID

OwnerID long[] 可选示例值：[2100057673]

Owner账号ID

Project string[] 可选示例值：["project1","project2"]

项目筛选，目前只支持计费项明细维度生效，其他维度默认不生效。

TagKV object[] 可选示例值：[{ Key: "k1", Value: "v1" },{ Key: "k2", Value: "v2" }]

标签，最大支持传递20个

Key string 可选示例值：k1

标签键

Value string 可选示例值：v1

标签值

TagKVFilterMode integer 可选示例值：0

标签键值对筛选匹配模式。当传入多个 TagKV 条件时，用于控制条件之间的匹配逻辑。

0：任一匹配，满足任意一个标签键值对条件即可返回结果。

1：全部匹配，必须同时满足所有标签键值对条件才返回结果。

Product string[] 可选示例值：[ECS]

产品名称，默认不选为全部

BillingMode string[] 可选示例值：[1]

计费模式：1：包年包月，代表预付费；2：按量计费，代表后付费；3：合同计费，代表线下计费；4：履约计费；默认不选为全部；

BillCategory string[] 可选示例值：[consume-use]

账单类型：consume-use：消费-使用；consume-new：消费-新购；consume-renew：消费-续费；consume-formalize：消费-转正；consume-modify：消费-更配；consume-trial：消费-试用；refund-terminate：退款-退订；refund-modify：退款-更配；transfer-manual：调账-人工；transfer-system：调账-系统；默认不选为全部

Offset integer 可选示例值：10

用于在分页查询中指定“从结果集的第几条记录开始返回”（也就是先跳过多少条记录），通常与 limit 搭配使用实现翻页：例如每页 limit=300 时，第 1 页传 offset=0 获取第 1–300 条，第 2 页传 offset=300 获取第 301–600 条，第 3 页传 offset=600 获取第 601–900 条；因此每往后一页，offset 按固定步长累加：offset = offset + limit（等价于 offset = (page-1) * limit）。

Limit integer 必选示例值：10

数量：[1-300]，用于指定接口响应中返回记录的最大数量（上限），例如Limit=20表示每次请求最多返回20条

BillPeriod string 必选示例值：2023-08

账期：格式为YYYY-MM；仅支持单月查询；所查账期至多距今 24 个月

ExpenseDate string 可选示例值：2023-03-15

账单日期，在GroupPeriod=1或2时支持账单日期传参，必须与账期在同一月份。该参数可提升查询性能，建议填写。

GroupTerm integer 可选示例值：0

统计项：0：计费项；1：实例；2：产品；3：账号

GroupPeriod integer 可选示例值：0

统计周期；0：账期；1：按天；2：明细；不传时默认按月汇总费用，若需按天分别汇总每日费用可传1；

InstanceNo string 可选示例值：i-ycjlq77tdg8rx6ib4v1s

实例id：云产品计费实例id，承载购买的云资源或资产的计费实体；

IgnoreZero integer 可选示例值：1

是否忽略折后价为0的数据：0：不忽略；1忽略；默认为不忽略

NeedRecordNum integer 可选示例值：1

是否需要访问列表的总记录数：用于前端分页；1：表示需要； 0：表示不需要；默认为不需要，Total返回-1

SalesChannel string[] 可选示例值：1

售卖渠道枚举: 0=火山引擎(默认), 1=抖店

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

Warning string 示例值：The specified tags are not enabled for the current account. No data is available.

当请求可被处理但部分筛选条件被忽略、过滤或降级时返回；为空表示无提示。

List object[] 示例值：-

账单明细列表

ProjectDisplayName string 示例值：默认项目

项目中文名

Formula string 示例值：（333）【单价】 * （2419200秒）【使用时长】 * （1/2419200）【时长转化系数】 - （0.000000）【优惠金额】 - （0.000000）【抹零金额】 - （0.000000）【代金券抵扣】

应付金额计费公式

PosttaxAmount string 示例值：0.66

税后应付金额

CountryRegion string 示例值：CN

国家地区

Tax string 示例值：0.1

税额

SettleTax string 示例值：0

结算币种税额

TaxRate string 示例值：0

税率

PretaxRealValue string 示例值：0

税前真实金额

SettleRealValue string 示例值：0

结算币种真实金额

SettlePretaxRealValue string 示例值：0

结算币种税前真实金额

RealValue string 示例值：0

真实金额

PretaxAmount string 示例值：0

税前应付金额

SettlePosttaxAmount string 示例值：0

结算币种税后应付金额

SettlePretaxAmount string 示例值：0

结算币种税前应付金额

SavingPlanOriginalAmount string 示例值：621.946905

节省计划抵扣原价

SavingPlanDeductionSpID string 示例值：Spn-2000000036383219200

节省计划实例ID

SavingPlanDeductionDiscountAmount string 示例值：576.400000

节省计划抵扣金额

DiscountInfo string 示例值：节省计划：Spn-2000000036383219200,超额累进单价,(0,2),(200,1.8),CN202505201929261

优惠信息

PreTaxPayableAmount string 示例值：0.66

税前应付金额（定价币种）

SettlePayableAmount string 示例值：0.66

税后应付金额（结算币种）

SettlePreTaxPayableAmount string 示例值：0.66

税前应付金额（结算币种）

CurrencySettlement string 示例值：CNY

结算币种

ExchangeRate string 示例值：1.00

汇率

MainContractNumber string 示例值：xxxxxxx

合同号

OriginalOrderNo string 示例值：xxxxxxx

原订单号

ResourceID string 示例值：xxxxxxx

资源ID

ChargeItemCode string 示例值：hourly_sum

计费项code

SavingPlanDeductionDiscountTotalAmount string 示例值：576.400000

节省计划抵扣总额

PriceFactor string 示例值：有效因子:1;刊例价:0.000100;折后单价:0.010000;

算价因子

PickupVoucherCountUnit string 示例值： ""

提货券抵扣量单位

PickupVoucherID string 示例值： ""

提货券ID

PickupVoucherDeductCount string 示例值： ""

提货券抵扣量

TagRemark string 示例值： ""

标签备注

ProjectRemark string 示例值： ""

项目备注

PointDeductAmount string 示例值：0.00

积分抵扣金额

DiscountBizUnitPrice string 示例值：1.3

优惠价格/折扣

DiscountBizUnitPriceInterval string 示例值：1,2,3

优惠价格区间

DiscountBizMeasureInterval string 示例值：0,100,200

优惠用量区间

EffectiveFactor string 示例值：1

有效因子

PriceInterval string 示例值：1,2,3

单价价格区间

MeasureInterval string 示例值：0,100,200

单价用量区间

BillingMethodCode string 示例值：按加和量小时结

计费方式

DiscountBizBillingFunction string 示例值：全额累进单价

代表优惠类型；当DiscountBizBillingFunction为固定单价和单一折扣时，优惠内容取DiscountBizUnitPrice字段；当DiscountBizBillingFunction为阶梯价时，单价取DiscountBizMeasureInterval和DiscountBizUnitPriceInterval字段，表达各个用量区间的不同优惠内容

Price string 示例值：640.00

单价

MarketPrice string 示例值：2.716

市场价

BillingFunction string 示例值：固定单价

代表单价价格类型；当BillingFunction为固定单价时，单价取Price字段；当BillingFunction为阶梯价时，单价取MeasureInterval和PriceInterval字段，表达各个用量区间的不同价格

PreferentialBillAmount string 示例值：5.036185

优惠金额

InstanceName string 示例值：ECS-fEaG

实例名称

ConfigName string 示例值：低配

配置名称

Element string 示例值：BE000232

计费单元

Region string 示例值：华北2（北京

地域

Zone string 示例值：可用区B

可用区

Factor string 示例值：{"type":"zanya"}

影响因子

ExpandField string 示例值：按加和量小时结

扩展字段

PriceUnit string 示例值：块

单价单位

BusiPeriod string 示例值：2023-08

业务账期

Count string 示例值：0

用量

Unit string 示例值：GB

用量单位

BillDetailId string 示例值：Detail7039533873751019820

账单明细ID

DeductionCount string 示例值：0

资源包抵扣量

OriginalBillAmount string 示例值：5.711200

原价

RoundAmount double 示例值：0.00

抹零金额

DiscountBillAmount string 示例值：0.66

折后价

CouponAmount string 示例值：0.00

代金券抵扣

PayableAmount string 示例值：0.66

应付金额

Currency string 示例值：CNY

币种

SettlementType string 示例值：结算类型，settle：结算，non-settle：非结算，quota-settle：Quota结算

非结算

Project string 示例值：default

项目：资源实例所属的项目信息，通常可定义为企业内部的部门、业务线等以便厘清成本归属与进行分账管理；取值为结算周期所在小时末实例所属的项目；按天/账期聚合时，项目展示为最新的项目；

Tag string 示例值：{"voKey1":["v1"],"voKey101":["v5"],"voKey2":["v2"],"volc:vke:cluster-id":["valu3"],"volc:vke:createdby-vke-flag":["valu4"],"volc:vke:used-by-vke-cluster":["value5"]}

标签：资源实例的标识；同一资源可绑定多个标签键值对，如资源创建者、资源使用部门、资源应用系统或环境等来标识资源费用信息；取值为结算周期的最后一小时内资源实例存在过的标签信息；按天/账期聚合时，标签展示为最新的标签；

SellingMode string 示例值：0

售卖模式，0：普通实例，1：竞价实例

SolutionZh string 示例值：测试方案

解决方案中文名称

SubjectName string 示例值：北京火山引擎科技有限公司

主体名

OwnerUserName string 示例值：Doooo

Owner账户名

BillCategory string 示例值：消费-使用

账单类型

ReservationInstance string 示例值：0

售卖模式，0：普通实例，1：弹性预约实例

ElementCode string 示例值：BE000137

计费单元Code

RegionCode string 示例值：R000671

地域Code

ZoneCode string 示例值：Zone1

可用区Code

FactorCode string 示例值：{"type":"large"}

影响因子Code

ConfigurationCode string 示例值：ecs.g1.large

配置Code

DeductionUseDuration string 示例值：0.0

抵扣量

BillPeriod string 示例值：2023-08

账期

ExpenseDate string 示例值：2023-08-14

日期

PayerID string 示例值：2100153894

支付账号ID

PayerUserName string 示例值：Doooo

支付账户名

PayerCustomerName string 示例值：北京火山引擎科技有限公司

支付账号客户名称

SellerID string 示例值：3423

Seller账号ID

SellerUserName string 示例值：火山引擎

Seller账户名

SellerCustomerName string 示例值：北京火山引擎科技有限公司

Seller账号客户名称

OwnerID string 示例值：2100153894

Owner账号ID

OwnerCustomerName string 示例值：北京火山引擎科技有限公司

Owner账号客户名称

BusinessMode string 示例值：普通业务

业务类型

Product string 示例值：ECS

产品英文名称

ProductZh string 示例值：云服务器

使用的产品/服务的商品中文名称；

BillingMode string 示例值：按量计费

计费模式：1：包年包月，代表预付费；2：按量计费，代表后付费；3：合同计费，代表线下计费；4：履约计费；

ExpenseBeginTime string 示例值：2023-08-14

消费开始时间

ExpenseEndTime string 示例值：-

消费结束时间

UseDuration string 示例值：0

使用时长

UseDurationUnit string 示例值：秒

时长单位

TradeTime string 示例值：2023-08-01 01:28:14

交易时间，格式：2006-01-02 15:04:05

BillID string 示例值：Bill7262035879529697551

订单号/账单号

InstanceNo string 示例值：i-ycjlq77tdg8rx6ib4v1s

实例ID

SalesChannel string 示例值：火山引擎

火山引擎(默认)或抖店

Total integer 示例值：100

总数，默认返回-1（NeedRecordNum=0时）

Limit integer 示例值：100

步长

Offset integer 示例值：0

偏移量

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	RequestInvalid	Request Invalid
500	InternalError	Service has some internal Error. Pls Contact With Admin.	服务内部异常

费用中心