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.
View JSON Schema on GitHub

JSON Schema

chatgpt-completionusage-schema.json Raw ↑
{
  "$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"
    }
  }
}