TranscriptionUsage

__construct(int $inputTokens = 0, int $outputTokens = 0, int|null $cacheReadInputTokens = null, int|null $cacheWriteInputTokens = null, int|null $reasoningTokens = null, float|null $audioSeconds = null)

Create transcription usage data.

totalTokens()

Get the total number of input and output tokens.

toArray()

Get the instance as an array.

jsonSerialize()

Get the JSON serializable representation of the instance.

fromArray(array $data)

Reconstruct an instance from a previously serialized toArray() payload.

uncachedInputTokens()

Get the input tokens that were neither read from nor written to a prompt cache.

add(TextUsage $usage)

Add the given usage to the current usage and return a new usage instance.

sum(int|null $a, int|null $b)

Sum two optional counts, preserving null when neither was reported.

from(TextUsage $usage, float|null $audioSeconds = null)

Create a transcription usage instance from the given usage.