天枢星通Docs
用量·计费·额度

账单与结算

月度服务费用结算单的读法——按密钥分项、含税合计、确认流程与确认期限、对账日,以及训练期折扣机制与发票事项

本页帮助您读懂平台出具的月度服务费用结算单:账单如何按密钥分项、含税合计如何构成、如何确认、确认期限是多久,以及对账日、训练期折扣机制与发票事项。

平台按结算月出具《服务费用结算单》。结算单的金额自下而上由逐条调用记录聚合而来——逐条之和 = 按密钥分项之和 = 当月含税合计,与 用量明细与计量说明 中的用量、与概览页的当月费用卡片完全同源、字字对得上。

结算周期与对账日

平台以自然月为结算周期,固定的对账日为每自然月 25 日。每个结算月在对账日生成当月《服务费用结算单》,供您核对与确认。

概念说明
结算月YYYY-MM 标识的自然月计费周期
对账日每自然月 25 日,生成当月结算单、随单完成对账
应付合计当月各密钥折算金额的含税合计

对账日的意义。 结算单在对账日定格当月用量与金额。在对账日之前,控制台展示的当月用量与费用为实时累计的展示口径,可随调用持续变动;对账日生成结算单后,该月金额即定格为正式应付口径,供确认与开票。

结算单的构成

一张月度结算单包含抬头与结算月、按密钥分项的明细表、含税合计,以及确认状态。其字段结构如下(以产品 API 形态示意;具体数值以控制台为准):

{
  "billing_month": "<结算月 YYYY-MM>",
  "title": "服务费用结算单",
  "settlement_date": "<对账日 YYYY-MM-DD>",
  "line_items_by_key": [
    {
      "api_key_id": "<子账户密钥标识>",
      "dimension": "<部门 / 业务线 / 成本中心>",
      "subtotal": "<该密钥当月折算金额小计(含税)>"
    }
  ],
  "total_payable": "<当月应付服务费合计(含税)>",
  "tax_rate": "<增值税率>",
  "invoice_item": "信息技术服务费",
  "metering_version": "<当期统一计价词元计量口径版本号>",
  "training_discount_flag": "<训练期折扣标识汇总>",
  "confirm_status": "<确认状态>"
}

各字段的读法:

字段读法
billing_month本结算单对应的结算月
settlement_date本月对账日,即结算单生成与定格之日
line_items_by_key按密钥(子账户)分项的明细,每项含该密钥所属维度与含税小计
subtotal单个密钥当月折算金额小计,已含税;由该密钥的逐条调用记录按 6 档计量口径折算聚合而来
total_payable各密钥小计之和,即当月应付服务费含税合计
tax_rate当期适用的增值税率,以服务协议与控制台为准
invoice_item发票服务项目栏,固定为「信息技术服务费」
metering_version本月计量与计价所依据的统一计价词元计量口径版本号
training_discount_flag本月训练期折扣标识汇总(详见下文「训练期折扣机制」)
confirm_status当前确认状态:待确认 / 已确认 / 视为确认

按密钥分项

结算单的明细按密钥(子账户)逐项列示。您为不同部门、业务线或成本中心申请的每一把密钥,其当月用量都独立归属、独立折算为含税小计,便于您按内部维度归集成本。

含义
子账户密钥当月产生用量的密钥标识
维度该密钥所属的部门 / 业务线 / 成本中心
当月折算金额(含税)该密钥逐条调用按 6 档计量口径折算后的含税小计
合计各密钥小计之和 = 当月应付含税合计

分项与合计的核对。 每把密钥的当月小计,可在 用量明细与计量说明 中按密钥筛选逐条调用记录复核;各密钥小计相加即为结算单合计。分项、合计与用量明细三处数字同源,便于您逐层核对。密钥的申请、变更与注销详见 API 密钥管理

含税合计

结算单中的金额均为含税口径。

  • 各密钥小计已含税,结算单合计 total_payable 为各密钥含税小计之和。
  • 适用的增值税率以服务协议与控制台展示为准,结算单的税率字段会随单标注当期税率。
  • 计量与计价所依据的口径版本随结算单一并标注(metering_version),便于您确认本月按哪一版计量口径出具。

金额口径速读。 结算单金额以人民币元为单位、含税列示。其底层即逐条调用记录中各次的含税折算金额,按密钥聚合、再合计。统一计价词元的 6 档计量与单价口径详见 用量明细与计量说明具体单价以服务协议与控制台为准

确认流程与确认期限

结算单生成后进入待确认状态,您可在核对无误后确认。

curl -X POST https://<平台入口地>/api/v1/billing/statements/<结算>/confirm \
  -H "Content-Type: application/json"

确认状态有三种取值:

状态含义
待确认结算单已生成、尚未确认,可在核对后确认
已确认您已确认本月结算单
视为确认超过确认期限仍未确认,按服务协议默认视为确认

确认期限。 结算单生成后设有确认期限,逾期未确认的,按服务协议约定默认视为确认。确认期限以工作日计,具体天数以服务协议与控制台为准。建议您在对账日后及时核对并确认,以便后续开票。

历史各结算月的结算单可在控制台「账单与结算」页按结算月查看与确认,亦可通过控制平面接口拉取:

curl https://<平台入口地>/api/v1/billing/statements?page=1&page_size=20

返回各结算月单据摘要(结算月、应付含税合计、确认状态);按结算月拉取单张结算单详情:

curl https://<平台入口地>/api/v1/billing/statements/<结算>

训练期折扣机制

为便于您在接入初期试用与磨合,平台对首个密钥的训练期提供优惠计收。训练期折扣已并入当期结算单,无需另行申请,逐条折后金额直接计入分项与合计。

训练期折扣遵循三条规则:

规则说明
首个密钥训练期优惠您首次接入的首个密钥,在其启用后的训练期内,用量按优惠比例计收(标准单价的一个折扣比例,例如八折)
其后新密钥标准计首个密钥之外、其后新启用的密钥,其训练期内用量按标准单价计收,不再享受首个密钥的训练期优惠
模型评测用量不计费平台为模型评测使用固定测试集所产生的少量用量,不计入计费、不并入任何结算月

训练期的范围。 训练期为密钥启用后的一段自然日窗口,其起算以密钥启用日为准。训练期折扣比例、训练期天数等以服务协议与控制台为准;机制层面,首个密钥训练期享优惠、其后新密钥全额、模型评测用量不计费这三条规则保持一致。

在结算单中,训练期折扣以标识形式汇总于 training_discount_flag,并已体现在对应密钥的折后小计中——也就是说,您看到的分项小计与合计已是折后含税金额,不会另起一张折扣表。逐条调用记录中亦会标注每次调用是否适用训练期折扣价及其比例,便于您逐条复核。逐条记录字段详见 用量明细与计量说明

发票事项

平台按结算月开具增值税发票。

事项说明
发票服务项目固定为「信息技术服务费」
计税口径结算单金额为含税口径,适用增值税率以服务协议与控制台为准
开票周期按结算月,于该月结算单确认(或逾期视为确认)后开具
开票金额与当月结算单含税合计一致

开票与确认的关系。 发票金额以当月结算单的含税合计为准;建议在结算单确认(或按确认期限视为确认)后开具,以保证票面金额与已对账金额一致。具体开票流程、抬头与税务信息以服务协议与控制台「账户设置」中的开票资料为准。

与其他页面的衔接

您想做的前往
复核某把密钥的逐条用量与折算金额用量明细与计量说明
按部门 / 业务线申请独立密钥用于成本归集API 密钥管理
了解信用额度、达额暂停与提额额度管理
查看当月用量与费用的实时概况文档中心

本页中的结算月、对账日、确认状态等为产品功能口径;具体税率、训练期折扣比例与天数、确认期限等商务数值不在文档中固化,以服务协议与控制台实时口径为准

On this page