账务接口

调用费用

默认在 usage.billing 中返回本次实际结算金额,保留原有 Token 用量。

接口说明

随响应返回本次消费

无需修改请求即可获取费用。非流式响应结算后在原 usage 中增加 billing 子字段,不增加顶层费用对象,不改 Token 数量。

接口地址POST/v1/chat/completions
Request headers请求头参数
1 项
X-Tokon-Include-Billingtrue | false选填

请求头,不是 JSON 参数。默认 true;传 false 时关闭费用扩展,恢复原有响应及发送时机。

Request body请求体参数
2 项
modelstring必填

当前 API Key 有权调用的模型 ID。

messagesarray必填

对话消息,其他生成参数沿用原接口。

Response body响应体参数
8 项
usage.billing.request_idstring选填

平台 Request ID,不是上游响应 id;用于查询最终费用。

usage.billing.statusstring选填

settled 为已结算;pending 为等待结算;unavailable 为暂不能确认金额。后两种不返回金额,不代表免费。

usage.billing.currencystring选填

金额币种,固定为 CNY。

usage.billing.total_amountstring选填

含服务费的实际总扣款,等于补贴支付加余额支付;人民币八位小数。

usage.billing.service_feestring选填

已包含在总金额内,不要重复相加。

usage.billing.subsidy_deductedstring选填

本次实际使用的补贴金额。

usage.billing.balance_deductedstring选填

本次实际扣除的团队自有余额。

usage.billing.request_statusstring选填

请求结果状态,与费用是否已结算分开;请求中断也可能已经产生费用。

注意支持已绑定团队 Key 的 /v1 文本接口及嵌入、审核、重排;只扩展原有 usage 对象,不伪造 Token 字段。无 usage、超过 4MiB 的 JSON、不支持的媒体任务或原生 Gemini 保留原样,改用费用查询。需要严格原协议时传 X-Tokon-Include-Billing: false。示例金额仅示意结构,不是示例 Token 的报价。