All Implemented Interfaces:


public final class BetaUsage

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`public final class`	`BetaUsage.Builder`	A builder for BetaUsage.
`public final class`	`BetaUsage.BetaIterationsUsageItems`	Token usage for a sampling iteration.
`public final class`	`BetaUsage.ServiceTier`	If the request used the priority, standard, or batch tier.
`public final class`	`BetaUsage.Speed`	The inference speed mode used for this request.

Field Summary

Fields
Modifier and Type	Field	Description

Constructor Summary

Constructors
Constructor	Description

Enum Constant Summary

Enum Constants
Enum Constant	Description

Method Summary

Modifier and Type	Method	Description
`final Optional<BetaCacheCreation>`	`cacheCreation()`	Breakdown of cached tokens by TTL
`final Optional<Long>`	`cacheCreationInputTokens()`	The number of input tokens used to create the cache entry.
`final Optional<Long>`	`cacheReadInputTokens()`	The number of input tokens read from the cache.
`final Optional<String>`	`inferenceGeo()`	The geographic region where inference was performed for this request.
`final Long`	`inputTokens()`	The number of input tokens which were used.
`final Optional<List<BetaUsage.BetaIterationsUsageItems>>`	`iterations()`	Per-iteration token usage breakdown.
`final Long`	`outputTokens()`	The number of output tokens which were used.
`final Optional<BetaServerToolUsage>`	`serverToolUse()`	The number of server tool requests.
`final Optional<BetaUsage.ServiceTier>`	`serviceTier()`	If the request used the priority, standard, or batch tier.
`final Optional<BetaUsage.Speed>`	`speed()`	The inference speed mode used for this request.
`final JsonField<BetaCacheCreation>`	`_cacheCreation()`	Returns the raw JSON value of cacheCreation.
`final JsonField<Long>`	`_cacheCreationInputTokens()`	Returns the raw JSON value of cacheCreationInputTokens.
`final JsonField<Long>`	`_cacheReadInputTokens()`	Returns the raw JSON value of cacheReadInputTokens.
`final JsonField<String>`	`_inferenceGeo()`	Returns the raw JSON value of inferenceGeo.
`final JsonField<Long>`	`_inputTokens()`	Returns the raw JSON value of inputTokens.
`final JsonField<List<BetaUsage.BetaIterationsUsageItems>>`	`_iterations()`	Returns the raw JSON value of iterations.
`final JsonField<Long>`	`_outputTokens()`	Returns the raw JSON value of outputTokens.
`final JsonField<BetaServerToolUsage>`	`_serverToolUse()`	Returns the raw JSON value of serverToolUse.
`final JsonField<BetaUsage.ServiceTier>`	`_serviceTier()`	Returns the raw JSON value of serviceTier.
`final JsonField<BetaUsage.Speed>`	`_speed()`	Returns the raw JSON value of speed.
`final Map<String, JsonValue>`	`_additionalProperties()`
`final BetaUsage.Builder`	`toBuilder()`
`final BetaUsage`	`validate()`
`final Boolean`	`isValid()`
`Boolean`	`equals(Object other)`
`Integer`	`hashCode()`
`String`	`toString()`
`final static BetaUsage.Builder`	`builder()`	Returns a mutable builder for constructing an instance of BetaUsage.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
- Method Detail
  - cacheCreation
```
 final Optional<BetaCacheCreation> cacheCreation()
```
    Breakdown of cached tokens by TTL
  - cacheCreationInputTokens
```
 final Optional<Long> cacheCreationInputTokens()
```
    The number of input tokens used to create the cache entry.
  - cacheReadInputTokens
```
 final Optional<Long> cacheReadInputTokens()
```
    The number of input tokens read from the cache.
  - inferenceGeo
```
 final Optional<String> inferenceGeo()
```
    The geographic region where inference was performed for this request.
  - inputTokens
```
 final Long inputTokens()
```
    The number of input tokens which were used.
  - iterations
```
 final Optional<List<BetaUsage.BetaIterationsUsageItems>> iterations()
```
    Per-iteration token usage breakdown.
    Each entry represents one sampling iteration, with its own input/output token counts and cache statistics. This allows you to:
    Determine which iterations exceeded long context thresholds (>=200k tokens)
    Calculate the true context window size from the last iteration
    Understand token accumulation across server-side tool use loops
  - outputTokens
```
 final Long outputTokens()
```
    The number of output tokens which were used.
  - serverToolUse
```
 final Optional<BetaServerToolUsage> serverToolUse()
```
    The number of server tool requests.
  - serviceTier
```
 final Optional<BetaUsage.ServiceTier> serviceTier()
```
    If the request used the priority, standard, or batch tier.
  - speed
```
 final Optional<BetaUsage.Speed> speed()
```
    The inference speed mode used for this request.
  - _cacheCreation
```
 final JsonField<BetaCacheCreation> _cacheCreation()
```
    Returns the raw JSON value of cacheCreation.
    Unlike cacheCreation, this method doesn't throw if the JSON field has an unexpected type.
  - _cacheCreationInputTokens
```
 final JsonField<Long> _cacheCreationInputTokens()
```
    Returns the raw JSON value of cacheCreationInputTokens.
    Unlike cacheCreationInputTokens, this method doesn't throw if the JSON field has an unexpected type.
  - _cacheReadInputTokens
```
 final JsonField<Long> _cacheReadInputTokens()
```
    Returns the raw JSON value of cacheReadInputTokens.
    Unlike cacheReadInputTokens, this method doesn't throw if the JSON field has an unexpected type.
  - _inferenceGeo
```
 final JsonField<String> _inferenceGeo()
```
    Returns the raw JSON value of inferenceGeo.
    Unlike inferenceGeo, this method doesn't throw if the JSON field has an unexpected type.
  - _inputTokens
```
 final JsonField<Long> _inputTokens()
```
    Returns the raw JSON value of inputTokens.
    Unlike inputTokens, this method doesn't throw if the JSON field has an unexpected type.
  - _iterations
```
 final JsonField<List<BetaUsage.BetaIterationsUsageItems>> _iterations()
```
    Returns the raw JSON value of iterations.
    Unlike iterations, this method doesn't throw if the JSON field has an unexpected type.
  - _outputTokens
```
 final JsonField<Long> _outputTokens()
```
    Returns the raw JSON value of outputTokens.
    Unlike outputTokens, this method doesn't throw if the JSON field has an unexpected type.
  - _serverToolUse
```
 final JsonField<BetaServerToolUsage> _serverToolUse()
```
    Returns the raw JSON value of serverToolUse.
    Unlike serverToolUse, this method doesn't throw if the JSON field has an unexpected type.
  - _serviceTier
```
 final JsonField<BetaUsage.ServiceTier> _serviceTier()
```
    Returns the raw JSON value of serviceTier.
    Unlike serviceTier, this method doesn't throw if the JSON field has an unexpected type.
  - _speed
```
 final JsonField<BetaUsage.Speed> _speed()
```
    Returns the raw JSON value of speed.
    Unlike speed, this method doesn't throw if the JSON field has an unexpected type.
  - _additionalProperties
```
 final Map<String, JsonValue> _additionalProperties()
```
  - toBuilder
```
 final BetaUsage.Builder toBuilder()
```
  - validate
```
 final BetaUsage validate()
```
  - isValid
```
 final Boolean isValid()
```
  - equals
```
 Boolean equals(Object other)
```
  - hashCode
```
 Integer hashCode()
```
  - toString
```
 String toString()
```
  - builder
```
 final static BetaUsage.Builder builder()
```
    Returns a mutable builder for constructing an instance of BetaUsage.
    The following fields are required:
    .cacheCreation() .cacheCreationInputTokens() .cacheReadInputTokens() .inferenceGeo() .inputTokens() .iterations() .outputTokens() .serverToolUse() .serviceTier() .speed()

Class BetaUsage

Nested Class Summary

Field Summary

Constructor Summary

Enum Constant Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Method Detail

cacheCreation

cacheCreationInputTokens

cacheReadInputTokens

inferenceGeo

inputTokens

iterations

outputTokens

serverToolUse

serviceTier

speed

_cacheCreation

_cacheCreationInputTokens

_cacheReadInputTokens

_inferenceGeo

_inputTokens

_iterations

_outputTokens

_serverToolUse

_serviceTier

_speed

_additionalProperties

toBuilder

validate

isValid

equals

hashCode

toString

builder