AiBillingSettings

Singleton resource representing paid security token billing settings for AI features on an instance.

JSON representation
{
  "name": string,
  "billingModel": enum (BillingModel),
  "paidTokenEnabled": boolean,
  "dailyPaidTokenLimit": string
}
Fields
name

string

Identifier. The resource name of the AiBillingSettings. Format: projects/{project}/locations/{location}/instances/{instance}/aiBillingSettings

billingModel

enum (BillingModel)

Output only. The billing model for the customer (governs paidTokenEnabled eligibility).

paidTokenEnabled

boolean

Optional. Whether the customer has opted their tenant in to Paid Security Tokens. Enabling paid tokens (paidTokenEnabled = true) is only permitted when billingModel is not BILLING_MODEL_UNSPECIFIED (otherwise UpdateAiBillingSettings returns FAILED_PRECONDITION).

dailyPaidTokenLimit

string (int64 format)

Optional. Daily paid token limit (-1 = unlimited, 0 = no paid tokens when paidTokenEnabled is false, > 0 = finite daily cap in paid Security Tokens). Values < -1, or 0 when paidTokenEnabled is true, are rejected with INVALID_ARGUMENT. If left unset when updateMask is omitted, the existing limit is preserved (defaulting to -1 on initial creation), which is distinct from explicitly setting 0.

BillingModel

The billing model describes how the customer is billed for paid token overages based on the purchased contract/subscription SKU.

Enums
BILLING_MODEL_UNSPECIFIED Default unspecified billing model. Indicates the customer's contract is not eligible for paid token overages.
SUBSCRIPTION Subscription-based billing model (eligible under a pre-purchased or subscription token SKU).
PAYGO Pay-As-You-Go overage billing model via Cloud Billing.