账单与结算
月度服务费用结算单的读法——按密钥分项、含税合计、确认流程与确认期限、对账日,以及训练期折扣机制与发票事项
本页帮助您读懂平台出具的月度服务费用结算单:账单如何按密钥分项、含税合计如何构成、如何确认、确认期限是多久,以及对账日、训练期折扣机制与发票事项。
平台按结算月出具《服务费用结算单》。结算单的金额自下而上由逐条调用记录聚合而来——逐条之和 = 按密钥分项之和 = 当月含税合计,与 用量明细与计量说明 中的用量、与概览页的当月费用卡片完全同源、字字对得上。
结算周期与对账日
平台以自然月为结算周期,固定的对账日为每自然月 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,并已体现在对应密钥的折后小计中——也就是说,您看到的分项小计与合计已是折后含税金额,不会另起一张折扣表。逐条调用记录中亦会标注每次调用是否适用训练期折扣价及其比例,便于您逐条复核。逐条记录字段详见 用量明细与计量说明。
发票事项
平台按结算月开具增值税发票。
| 事项 | 说明 |
|---|---|
| 发票服务项目 | 固定为「信息技术服务费」 |
| 计税口径 | 结算单金额为含税口径,适用增值税率以服务协议与控制台为准 |
| 开票周期 | 按结算月,于该月结算单确认(或逾期视为确认)后开具 |
| 开票金额 | 与当月结算单含税合计一致 |
开票与确认的关系。 发票金额以当月结算单的含税合计为准;建议在结算单确认(或按确认期限视为确认)后开具,以保证票面金额与已对账金额一致。具体开票流程、抬头与税务信息以服务协议与控制台「账户设置」中的开票资料为准。
与其他页面的衔接
本页中的结算月、对账日、确认状态等为产品功能口径;具体税率、训练期折扣比例与天数、确认期限等商务数值不在文档中固化,以服务协议与控制台实时口径为准。