Atomically reserve weekly input-character quota before a billable provider action

POST

/v1/internal/quota/reservations

请求参数

Body 参数application/json必填

示例

{
    "idempotencyKey": "string",
    "service": "ai.refine",
    "feature": "electron.hotkey.dictation",
    "estimatedInputChars": 0,
    "reserveRemaining": false,
    "ttlSeconds": 1800
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/internal/quota/reservations' \
--header 'Content-Type: application/json' \
--data '{
    "idempotencyKey": "string",
    "service": "ai.refine",
    "feature": "electron.hotkey.dictation",
    "estimatedInputChars": 0,
    "reserveRemaining": false,
    "ttlSeconds": 1800
}'

返回响应

🟢200成功

application/json

Reservation decision returned.

Bodyapplication/json

示例

{
    "endpoint": "POST /v1/internal/quota/reservations",
    "allowed": true,
    "reason": "string",
    "quota": {
        "state": "available",
        "usedChars": 0,
        "reservedChars": 0,
        "limitChars": 0,
        "remainingChars": 0,
        "periodStart": "2019-08-24T14:15:22.123Z",
        "resetsAt": "2019-08-24T14:15:22.123Z"
    },
    "reservation": {
        "reservationId": "string",
        "idempotencyKey": "string",
        "usageIdempotencyKey": "string",
        "userId": "string",
        "service": "ai.refine",
        "feature": "electron.hotkey.dictation",
        "reservedInputChars": 0,
        "actualInputChars": 0,
        "status": "active",
        "expiresAt": "2019-08-24T14:15:22.123Z"
    }
}

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

Check whether the current user can use a service or feature

Commit actual input characters for a completed quota reservation