Consume quota

POST

/v1/billing/quota-consumptions

Records billing quota consumption and emits a billing ledger entry.

请求参数

Body 参数application/json必填

示例

{
    "sessionID": "11111111-1111-1111-1111-111111111111",
    "userID": "local-user-001",
    "quotaSource": "pro",
    "consumedSeconds": 18.4,
    "consumeReason": "session_usage"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/billing/quota-consumptions' \
--header 'Content-Type: application/json' \
--data '{
    "sessionID": "11111111-1111-1111-1111-111111111111",
    "userID": "local-user-001",
    "quotaSource": "pro",
    "consumedSeconds": 18.4,
    "consumeReason": "session_usage"
}'

返回响应

🟢200成功

application/json

Quota consumption recorded.

Bodyapplication/json

示例

{
    "endpoint": "POST /v1/billing/quota-consumptions",
    "entry": {
        "id": "22222222-2222-2222-2222-222222222222",
        "userID": "local-user-001",
        "quotaSource": "pro",
        "consumedSeconds": 18.4,
        "consumeReason": "session_usage",
        "linkedSessionID": "11111111-1111-1111-1111-111111111111",
        "createdAt": "2026-04-01T16:20:00Z"
    }
}

修改于 2026-08-26 04:04:36

Check quota availability

Reconcile an entitlement snapshot