文档中心

费用中心

API参考

账单管理OpenAPI常见问题

Q1:账单API调用参考文档

官网参考文档：https://www.volcengine.com/docs/6269/1165274

Q2:接口请求调用示例

想要快速发起接口请求，可在OpenApi中心，选择需要调用的接口并输入请求的过滤参数，就可在SDK实例下生成可执行的代码。

Q3:账单openapi SDK下载地址

SDK 代码主要由两部分组成，分别是业务实现代码（一般位于 Service 目录下）和调用样例代码（一般位于 Example 目录下）。用户可以首先根据 README.md 文件中的介绍下载安装我们提供的 SDK，然后仿照我们提供的调用样例代码编写代码，调用火山引擎费用中心 - OpenAPI 接口。

火山引擎：https://github.com/volcengine

火山引擎 Golang SDK

火山引擎 Java SDK

火山引擎 Python SDK

火山引擎 PHP SDK

火山引擎 NodeJS SDK

Q4:账单支持接口

国内当前可使用的账单接口：

ListBillOverviewByCategory - 查询账单总览-账号汇总信息

ListBillOverviewByProd - 分页查询账单总览-产品汇总信息

ListBill - 分页查询账单

ListBillDetail - 分页查询账单明细

ListSplitBillDetail - 分页查询分账账单

ListAmortizedCostBillDetail - 查询成本账单明细

ListAmortizedCostBillMonthly - 查询成本账单总览

ListAmortizedCostBillDaily - 查询成本账单按天

国外当前可使用的账单接口：

ListBillOverviewByCategory- 查询账单总览-账号汇总信息

ListBillOverviewByProd- 分页查询账单总览-产品汇总信息

ListBillDetail- 分页查询账单明细

ListAmortizedCostBillDaily - 查询成本账单按天

Q5:接口调用频率限制

接口的限流情况为单账号 5 QPS，1s可以查询300次，能查到1500条数据。超过限流阈值请求会直接失败，需要考虑限流策略

Q6:接口鉴权逻辑

账单后端没有对权限做额外控制，只要能拿到AK、SK来访问open-api，就能看到跟控制台一样的结果。主账号可以通过iam来控制子账号能否查询分账账单，如果子账号有查看分账账单的权限，能拿到AK、SK就可以查到所有的分账账单，没有更细粒度的控制。

Q7:账单根据交易时间排序

接口查询的结果本身不存在按时间排序的逻辑，可以在接口请求中增加排序和过滤条件。需要注意的是，如果要按交易时间排序，只能使用按天查询的接口，查询明细接口可以获取到小时的数据，但是不支持排序。

Q8:账单中心openapi调用接口数据延迟时间是多久

通过openap调用账单接口查询到的数据与控制台和后台费用中心查询的数据是一致的，不存在延迟的说法。

Q9: 如何实现按天查询当天消费总额

查看消费总额可以调用ListBillDetail接口查询账单明细，调用时参数GroupPeriod传1，ExpenseDate传与账期相同的具体日期，就可以获取到按天的账单明细查询，最后最需要查询的金额字段进行汇总即可。

Q10:通过ListBillOverviewByCategory接口查询当月消费总额，返回的数据有重复

ListBillOverviewByCategory接口返回的数据包括一条合计的数据和按账号的消费、退款等数据，可以通过BillCategoryParent字段来查看，如果要看当月消费总额看BillCategoryParent=“合计”对应的金额就行。

Q11:请求结果中Total返回-1，怎么获取账单数

接口返回Total为-1，想要查询账单数量需要增加查询条件：NeedRecordNum=1(1：表示需要； 0：表示不需要；默认为0---传0返回-1；传1返回实际数据数量

Q12:控制台有账单，接口查询返回为空

Offset参数值设置大于账单数量值，会导致查询结果为空，可以对比查看参数Offset和Total的数量。

请求openapi时需要注意国内外域名不一致，通过官网下载账单SDK默认走国内域名，bp请求时需要检查请求是否有误。国内域名：open.volcengineapi.com 国外域名：open.byteplusapi.com。

成本账单、分账账单接口查不到数据，请检查控制台是否开通相关账单，成本账单和分账账单是开通型功能，需要用户手动在控制台开通菜单。成本账单开通后会自动生成当月的成本账单数据，第二天下午可见，同时支持历史成本账单回溯；分账账单开通后当月的分账账单数据会自动生成，历史月份无法回溯。

Q13:接口查询账单与控制台页面数据不一致

查询账单明细或分账账单明细时，若接口返回的字段值为空的情况，可以在账单页面查看确认是否一致，若不一致可能是页面数据查询的是计费项+明细维度，检查接口GroupTerm和GroupPeriod字段传参是否准确。

账单明细号字段在账单明细或分账账单明细下明细维度下才有值，账期维度和按天维度无法聚合。

项目、标签等字段，在账单明细和分账账单明细中有值，但在接口查询中没有值，需要注意查询维度是否与页面一致，明细维度下值不一样时，聚合到账期维度或按天维度下值为空。

offset为偏移量，需要批量捞取数据时需要对offset进行赋值，检查offset赋值是否正确。一次获取的数据量最多为300条，当limit=300时，可以设置offset+=300。

检查参数ignore_zero =1时表示忽略0元账单，即折后价为0，应付金额为0的账单会被忽略。若需要查询折后价、应付金额为0的账单，应设置ignore_zero=0。

Q14:接口返回的项目标签为空

查询账单明细的项目标签出现为空的情况，可能是查询到了项目标签为空的数据，可以在控制台账单管理查询。当账号下明细数据量过大时，可以增加入参，将数据范围缩小，查看结果是否与控制台一致，也可以增加查询范围，查询尽可能多的数据，去找到预期的账单。

Q15:接口请求返回字段缺少或与文档不一致

账单SDK会根据新功能的优化进行迭代，存在新增账单字段等情况，可在官网下载最新版SDK进行调用

https://www.volcengine.com/docs/6269/1165274?lang=zh

或在接口调试页面可直接查看当前所用语言的【SDK信息】，根据SDK安装命令升级到最新版本。

https://api.volcengine.com/api-explorer/?

接口报错对照

msg	解决思路
Code”:“MissingParameter”,“Message”:“The required parameter BillPeriod is missing.	检查签名中缺少BillPeriod或参数未被有效识别到，若签名正常传入值，可提账务财资-账单中心oncall进一步排查
Code”:“InvalidParameter”,“Message”:“The specified parameter Limit is invalid.	签名中缺少Limit。参数非必填时，会传默认值，签名字段要与传参一致。不同调用方式接口取值有差别，post调用时接口从Body获取参数，get调用时接口从Params获取参数，建议使用官网提供的SDK调用不容易出错。
CodeN’: 100027, ‘Code’: ‘AccountFlowLimitExceeded’, ‘Message’: ‘Request was rejected because the request speed of this openAPI is beyond the current flow control limit.’	接口调用限流为单账号5qps，出现被限流可能存在以下几种情况： 1.账单拨测，多个团队共用一个账号做查询，同1s多个团队的拨测请求同时发生，超过5qps会被限流。这种情况盲目调大qps会影响服务，也不能解决问题，可以团队间沟通请求策略和重试策略，避免各团队同一时间频繁的发送请求和重试，同时根据拨测的需要可以限定查询条件，减少查询的数据量，提高查询效率； 2.查询的数据量过大时，查询的时间会随数据量延长，批量查询请求过于频繁，1s超过5次会被限流。建议完成一次查询后再进行下一步查询； 3.若存在其他特殊情况，可提账务财资-账单中心oncall。
Internal Service is timeout.	调用接口时偶尔的超时或失败是正常的，需要在超时或失败之后使用同样的参数重试几次。
"json: cannot unmarshal number into Go struct field ListBillDetailOpenapiRequest.BillingMode of type []string"	请求参数中入参格式有问题。例如参数是Array of String格式，传参传成string
Invalid valve for "split_dimension . must not be None	参数不允许为空
Reason: {'CodeN': 100010, 'Code': 'SignatureDoesNotMatch', 'Message': 'The request signature we calculated does not match the signature you provided. Check your Secret Access Key and signing method. Consult the service documentation for details.'}	aksk不匹配，请检查aksk输入是否正确和完整

最近更新时间：2026.01.20 21:23:47

这个页面对您有帮助吗？

有用

无用