{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/orq/json-schema/orq-classify-usage-schema.json",
  "title": "ClassifyUsage",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/orq-classify-api-openapi.yml#/components/schemas/ClassifyUsage",
  "additionalProperties": false,
  "properties": {
    "input_cost": {
      "description": "Cost (USD) of input tokens. Present when billing was computed for this request.",
      "format": "double",
      "type": "number"
    },
    "input_tokens": {
      "description": "The number of input tokens processed.",
      "format": "int64",
      "type": "integer"
    },
    "input_tokens_details": {
      "$ref": "#/$defs/ClassifyInputTokensDetails",
      "description": "Provider-reported cache token usage. OpenAI Decisions does not charge for cache reads or writes."
    },
    "output_cost": {
      "description": "Cost (USD) of output tokens. 0 for native classify providers, including OpenAI Decisions. Present when billing was computed for this request.",
      "format": "double",
      "type": "number"
    },
    "output_tokens": {
      "description": "The number of output tokens generated. Free for native classify providers, billed at the model rate for emulated chat models.",
      "format": "int64",
      "type": "integer"
    },
    "total_cost": {
      "description": "Total cost (USD) of the request. Present when billing was computed for this request.",
      "format": "double",
      "type": "number"
    }
  },
  "required": [
    "input_tokens",
    "output_tokens"
  ],
  "type": "object",
  "$defs": {
    "ClassifyInputTokensDetails": {
      "additionalProperties": false,
      "properties": {
        "cache_write_tokens": {
          "description": "Input tokens written to cache.",
          "format": "int64",
          "type": "integer"
        },
        "cached_tokens": {
          "description": "Input tokens read from cache.",
          "format": "int64",
          "type": "integer"
        }
      },
      "required": [
        "cached_tokens",
        "cache_write_tokens"
      ],
      "type": "object"
    }
  }
}