{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/llmintel-ai/json-schema/llmintel-ai-comparison-schema.json",
  "title": "Comparison",
  "description": "N-model comparison matrix. Performance fields are null unless the key is paid.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/llmintel-ai-openapi.json#/components/schemas/Comparison",
  "type": "object",
  "properties": {
    "performanceUnlocked": {
      "type": "boolean",
      "description": "Whether performance fields are populated for this key."
    },
    "analysisSource": {
      "type": [
        "string",
        "null"
      ]
    },
    "models": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "provider": {
            "type": "string",
            "enum": [
              "openai",
              "anthropic",
              "azure",
              "bedrock",
              "google",
              "vertex",
              "mistral",
              "cohere"
            ]
          },
          "displayName": {
            "type": "string"
          },
          "lifecycleState": {
            "type": "string",
            "enum": [
              "announced",
              "active",
              "legacy",
              "deprecated",
              "retiring",
              "retired"
            ]
          },
          "announcedDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "deprecatedDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "retirementDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "sourceUrl": {
            "type": "string",
            "format": "uri"
          },
          "openWeights": {
            "type": "boolean",
            "description": "The model ships downloadable weights. When true and the price fields are null, cost is infrastructure-derived rather than unknown."
          },
          "inputUsdPerMillion": {
            "type": [
              "number",
              "null"
            ]
          },
          "outputUsdPerMillion": {
            "type": [
              "number",
              "null"
            ]
          },
          "contextWindowTokens": {
            "type": [
              "integer",
              "null"
            ]
          },
          "maxOutputTokens": {
            "type": [
              "integer",
              "null"
            ]
          },
          "capabilityClass": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "flagship",
              "balanced",
              "lite",
              null
            ]
          },
          "tokensPerSecond": {
            "type": [
              "number",
              "null"
            ]
          },
          "timeToFirstTokenSeconds": {
            "type": [
              "number",
              "null"
            ]
          },
          "performanceLocked": {
            "type": "boolean"
          },
          "benchmarkSource": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  }
}