TokenUsage schema

FieldType and description
prompt_tokensinteger

Tokens in the prompt.

completion_tokensinteger

Tokens in the generated completion.

total_tokensinteger

Total tokens used.

reasoning_tokensinteger

Tokens consumed by the model's reasoning trace. Returned by some models only; check for its presence rather than assume it.

prompt_tokens_detailsobject | null

Breakdown of prompt token consumption. May be null or omitted.

FieldType and description
cached_tokensinteger

Number of prompt tokens served from cache.