Skip to main content
Version: 21 R3 BETA

OpenAIChatCompletionsResult

Inherits

Computed properties

PropertyTypeDescription
choicesCollectionReturns a collection of OpenAIChoice from the OpenAI response.
choiceOpenAIChoiceReturns the first OpenAIChoice from the choices collection.
usageObjectReturns token usage information (inherited from OpenAIResult).

usage

The usage property returns an object containing token usage information for chat completions.

FieldTypeDescription
prompt_tokensIntegerNumber of tokens in the prompt.
completion_tokensIntegerNumber of tokens in the completion.
total_tokensIntegerTotal tokens used (prompt + completion).
prompt_tokens_detailsObjectBreakdown of prompt tokens (optional).
completion_tokens_detailsObjectBreakdown of completion tokens (optional).

prompt_tokens_details

FieldTypeDescription
cached_tokensIntegerNumber of tokens served from cache.
audio_tokensIntegerNumber of audio tokens (if applicable).

completion_tokens_details

FieldTypeDescription
reasoning_tokensIntegerTokens used for reasoning (e.g., o1 models).
audio_tokensIntegerNumber of audio tokens (if applicable).
accepted_prediction_tokensIntegerTokens from accepted predictions.
rejected_prediction_tokensIntegerTokens from rejected predictions.

Example response:

{
"prompt_tokens": 19,
"completion_tokens": 10,
"total_tokens": 29,
"prompt_tokens_details": {
"cached_tokens": 0,
"audio_tokens": 0
},
"completion_tokens_details": {
"reasoning_tokens": 0,
"audio_tokens": 0,
"accepted_prediction_tokens": 0,
"rejected_prediction_tokens": 0
}
}

Note: The *_tokens_details objects may not be present in all responses or from all providers.

See also