ChatGPT · Schema
CompletionUsage
AgentsAIChatGPTEmbeddingsFine-TuningGPT-4GPT-5Language ModelOpenAIRealtime
Properties
| Name | Type | Description |
|---|---|---|
| prompt_tokens | integer | Number of tokens in the prompt. |
| completion_tokens | integer | Number of tokens in the generated completion. |
| total_tokens | integer | Total number of tokens used in the request. |
| completion_tokens_details | object | Breakdown of tokens used in a completion. |
| prompt_tokens_details | object | Breakdown of tokens used in the prompt. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/CompletionUsage",
"title": "CompletionUsage",
"type": "object",
"required": [
"prompt_tokens",
"completion_tokens",
"total_tokens"
],
"properties": {
"prompt_tokens": {
"type": "integer",
"description": "Number of tokens in the prompt.",
"example": 10
},
"completion_tokens": {
"type": "integer",
"description": "Number of tokens in the generated completion.",
"example": 10
},
"total_tokens": {
"type": "integer",
"description": "Total number of tokens used in the request.",
"example": 10
},
"completion_tokens_details": {
"type": "object",
"description": "Breakdown of tokens used in a completion.",
"properties": {
"reasoning_tokens": {
"type": "integer",
"description": "Tokens generated by the model for reasoning."
},
"accepted_prediction_tokens": {
"type": "integer",
"description": "Tokens from a prediction that appeared in the completion.\n"
},
"rejected_prediction_tokens": {
"type": "integer",
"description": "Tokens from a prediction that did not appear in the\ncompletion.\n"
}
},
"example": "example_value"
},
"prompt_tokens_details": {
"type": "object",
"description": "Breakdown of tokens used in the prompt.",
"properties": {
"cached_tokens": {
"type": "integer",
"description": "Cached tokens in the prompt."
},
"audio_tokens": {
"type": "integer",
"description": "Audio input tokens in the prompt."
}
},
"example": "example_value"
}
}
}