{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/llmintel-ai/json-schema/llmintel-ai-model-schema.json",
  "title": "Model",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/llmintel-ai-openapi.json#/components/schemas/Model",
  "type": "object",
  "required": [
    "id",
    "provider",
    "displayName",
    "aliases",
    "lifecycleState",
    "sourceUrl",
    "sourceTerm"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Canonical model id (provider/model)."
    },
    "provider": {
      "type": "string",
      "enum": [
        "openai",
        "anthropic",
        "azure",
        "bedrock",
        "google",
        "vertex",
        "mistral",
        "cohere"
      ]
    },
    "displayName": {
      "type": "string"
    },
    "aliases": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "lifecycleState": {
      "type": "string",
      "enum": [
        "announced",
        "active",
        "legacy",
        "deprecated",
        "retiring",
        "retired"
      ],
      "description": "- `announced` — Model has been announced by the provider but is not yet generally available.\n- `active` — Generally available. API calls succeed; recommended for new workloads.\n- `legacy` — Still callable, but superseded and no longer recommended for new workloads.\n- `deprecated` — No new customers/usage onboarding; existing API calls still succeed.\n- `retiring` — A hard retirement date is scheduled and imminent; calls still succeed until then.\n- `retired` — Shut down. API calls fail."
    },
    "announcedDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "deprecatedDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "retirementDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "sourceUrl": {
      "type": "string",
      "format": "uri",
      "description": "Primary provider source the record was verified against."
    },
    "sourceTerm": {
      "type": "string",
      "description": "Verbatim provider term that mapped to the canonical state."
    },
    "openWeights": {
      "type": "boolean",
      "description": "The model ships downloadable weights and can be self-hosted. Use this to tell a null `inputUsdPerMillion` that means \"no per-token rate exists\" apart from one that means \"not in our data yet\". Independent of pricing: a model may have public weights and a published per-token rate at the same time."
    },
    "lastVerifiedAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    }
  }
}