Skip to main content

UsageByModel

Usage attributed to a single model within one generation run.

Usage profiles​

UsageFields and validation
In webhook payloadsView fields

In webhook payloads​

Webhook JSON uses protobuf field names (snake_case).

FieldTypePresenceMeaning
modelstringOptionalModel identifier as recorded on the assistant message that produced it.
callsinteger (int32)OptionalProvider completions attributed to this model within the run. Minimum: -2147483648. Maximum: 2147483647.
usageUsageOptionalSame shape as the run aggregate, scoped to this model.

Where used​

ReferenceRelationship
llm.generation_completedWebhook JSON uses protobuf field names (snake_case).
LLMGenerationCompletedEventNested in model

Download the public reference contract.

Document: DOC-API-MODEL-usage-by-model.