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.

• outputTokensDetails

   final Optional<BetaOutputTokensDetails> outputTokensDetails()

  Breakdown of output tokens by category.

  output_tokens remains the inclusive, authoritative total used for billing. This object provides a read-only decomposition for observability — for example, how many of the billed output tokens were spent on internal reasoning that may have been summarized before being returned to you.

• 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.

• _outputTokensDetails

   final JsonField<BetaOutputTokensDetails> _outputTokensDetails()

  Returns the raw JSON value of outputTokensDetails.

  Unlike outputTokensDetails, 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()

  Validates that the types of all values in this object match their expected types recursively.

  This method is not forwards compatible with new types from the API for existing fields.

• 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()
  .outputTokensDetails()
  .serverToolUse()
  .serviceTier()
  .speed()