Skip to content

API

Read-only data about AI models as each provider and access method exposes them: limits, prices, prompt caching, and what providers.dev measured. The baseline is imported from models.dev (MIT); everything providers.dev adds is under the providers_dev key. No key is needed.

Version 1.0.0 · OpenAPI JSON

Requests and pagination

Four resources: providers, entries (a model at a provider and access method), models (canonical: a model as its lab names it) and evaluations (of the cache at /evaluations/cache, of limits at /evaluations/limits). Limits, prices and caching belong to an entry, because the same model differs from one provider to the next.

No authentication is required. GET and HEAD are supported; OPTIONS answers CORS preflights. Public requests read a published snapshot and never fetch upstream providers.

Every collection returns { meta, total, limit, offset, next_offset, data }. Use limit from 1 to 200 (default 50) and continue with next_offset until it is null. Every single resource returns { meta, data }, /meta and /catalog included. Only /openapi.json and the compatibility export /api.json return their documents directly.

Filters combine with AND. Unknown parameters, duplicate parameters and invalid values return 400 with details. URL-encode each provider/model path segment; model ids may contain slashes. Keep dataset_version and generated_at when joining pages; restart pagination if either changes.

Stability

/api/v1 only grows. Nothing in it is removed, renamed or retyped: every path, parameter, property, schema and enumerated value of version 1.0.0 stays, with the same type. A property that is always present stays present, one that is never null stays so, and an allowed value of a parameter stays allowed. What can be added: a path, an optional parameter, an allowed value of a parameter, a property, a schema, a value of an enumerated field.

A client must ignore keys it does not know, and must tolerate a value of an enumerated field that it does not know, for example by reading it as unknown. A client that refuses either can break on a change /api/v1 allows.

A change that removes, renames or retypes something would be /api/v2, published beside /api/v1, which is kept.

The version of this document, info.version, is the version of the structure of /api/v1. It started at 1.0.0 with the first public release. A release that adds something takes a minor step: 1.1.0, then 1.2.0. A correction of the text alone can take a patch step. The major number stays 1 within /api/v1.

X-Dataset-Version, and dataset_version of /meta, are about the data, not about the structure: they change when the data changes, as a rule every day. They are not this version.

Unknown values

Null means no value is known. Zero is a real value. Unsupported means explicitly unavailable; not_applicable means the field has no meaning for this access method. Limits are tokens; max_output is a maximum, not a default.

One structure. An entry summary, the providers_dev record of an entry or a provider, an evaluation, a correction and a piece of evidence each have the same keys on every object: an unknown value is null and an empty list is [], never a missing key. The answer of an endpoint has the same keys whatever its parameters: /providers/{provider} has models: null until view=full asks for it. The fields imported from models.dev (limit, cost, capabilities, modalities and the like) keep the models.dev shape, where an absent field means models.dev has no value.

Unknown limits do not match minimum filters. Unknown release dates do not match max_age_months. sort=cache_short and sort=cache_long order entries by cache_lifetime.short.safe_s and cache_lifetime.long.safe_s: an unknown safe lifetime (null) comes last in either order, and 0 is a value. lifetime_basis=documented or measured keeps the entries whose short or long safe lifetime has that basis. Cache mode support is separate for automatic and manual caching. Evaluations do not establish documented parameter support.

Input window

Every entry has one input window record, providers_dev.limits.input_window, and every summary the same object as input_window. Its tokens is the most input a request can carry on the entry: the number a client should take as its input budget on this provider and access method, in tokens as the provider counts them, the client's own system prompt and tools included. It is null where that is not known, and never 0. The rest of the record says what the number rests on.

The rule. Where an input limit or a context window is documented for the entry, that is the value (basis documented), unless a limit evaluation of the entry clearly contradicts it; then the value is the measured one (basis measured). Where nothing is documented, the value is the measured one. Where several clients were measured, the lowest value decides, and each client's own value is an item of measurements. Where nothing is known, tokens is null and basis is none. An evaluation contradicts a documented value D when it names a window below D; when it names a window other than D and D is a limit.context; when it refused an input at or below 99 % of D (for 922,000: 912,780 or less) above an accepted one; or when it accepted an input at or above 101 % of D (931,220 or more) that was below a refusal or read to the end. A window the route names is exact and has no margin; a refused or accepted size has a margin of 1 %, because a refused size is the probe's own count and routes add tokens of their own. A measurement can raise the value above a documented one. documented_status says what the rule found where both a documented and a measured value exist: contradicted (tokens is measured_tokens) or not_contradicted (tokens is documented_tokens); not contradicted is not confirmed.

bound. limit: the value is the limit, as documented or as the route names it. at_least: the value is the largest input seen accepted, and the real limit is that or more; where an input was refused above it, measured_refused gives the smallest one, and the limit is below that. A documented value is always limit.

scope. window: the value is a context window that input and output share (limit.context, or a window the route names), so the response is counted against the same figure, and a client that wants room for a reply takes it off itself. input: the value is a figure for the input alone (limit.input, or an input size seen accepted); compare limit.context and limit.output of the entry for the room left for the reply.

What is read as documented: the entry's own limit.input where it is a number above 0, else its limit.context where it is one and is not a measured value (a field named in limits.from_measurement is a measurement, read as one). 0 is "none stated", not a limit: an image or audio model with a window of 0 gets null, unless it states an input. Nothing is read from another entry: an entry providers.dev added takes no limit from the entry it names. documented_source is models.dev with the import date, or providers.dev with the newest evidence date where providers.dev corrected the field or added the entry.

What is read as measured: the entry's limit evaluations, providers_dev.limits.measured, nothing else, so every value can be redone from the entry. One evaluation gives a value of one of three kinds. window: the route's own answer named its context window (context), and no smaller input was refused; the value is that window, bound limit. bracket: an input was accepted (input_accepted) and a larger one refused (input_refused); the value is the accepted one, bound at_least. accepted: an input was accepted and the reply showed it was read to the end (input_read), with nothing refused and no window named; the value is input_read, bound at_least. An evaluation that fits none of these counts for nothing: a refusal with nothing accepted, an accepted size with no refusal, no named window and no read check (a route can answer a request it did not read), or the output alone. It stays in limits.measured and /evaluations/limits, is in no item, and /meta lists it as the notice limit-not-counted.

Nothing that existed before changes. limit of an imported entry stays models.dev's, and limit.context and limit.output of an added entry stay what a measurement stated. context, input and max_output of a summary are limit as published; measured_input_accepted, measured_input_refused and measured_limit_count stay the widest accepted, the narrowest refused and the number of limit evaluations, whether they count for the input window or not.

The limits of the evidence. A measurement is one account on one route on one date: another plan, region or account can have another limit, and a provider can change it the next day, so every measured value carries its date and goes stale as all providers.dev evidence does. A walk sends few requests: the real limit lies between the accepted size and the refused one, and an at_least value is lower than the limit by as much as that gap. Where no refusal was seen, nothing shows where the limit is, only that it is not below the value. A refused size is the probe's count, not the provider's. The requests were short questions over filler text with replies of a few tokens: a window that input and output share has less room for input when a long reply is asked for. A window a route names is its total; a cap on the input inside it shows only as a refusal. The documented value is models.dev's unless marked.

Pricing and request controls

Every entry summary has pricing and request_controls, identical to providers_dev.pricing and providers_dev.request_controls on the full entry. This includes entries nested in provider, model and catalog responses. Provider and model list items do not aggregate prices across entries.

Coverage is unknown, partial, complete or not_applicable. Imported pricing is partial. rules: null means unknown; an empty array proves no conditions only with complete coverage. Unrecognized source fields remain in unparsed. Original cost, capabilities and api fields are preserved.

Each rate identifies its meter, operation, amount, currency and billing unit. The meter is the kind of content and what is charged for it: text.input, text.cache_read, audio.input, image.output, video.output, and web_search for web searches. The unit is the source's: 1,000,000 tokens or characters, 1 second, minute, image or megapixel, 1,000 searches. price_in and price_out are the text prices per million tokens only. A rule with when: null is a base rate. Conditions can combine context size, cache lifetime, service tier, region, date, the day and hour in UTC, and what a request for an image, a video or a transcription asks for (resolution, quality, duration and the like) with all, any and not. Unknown conditions retain their raw source shape. An imported rule holds for the whole request that matches its condition (applies_to: all_usage), because that is how models.dev evaluates one; an authored rule can say above_threshold, and null means it is not established.

A set rule replaces a rate and a multiply rule scales it. rule_order: listed means apply matching rules in listed order. Imported records are listed: base rates first, then the overrides in models.dev's order, then every matching multiplier, which is how models.dev defines a price. Null means precedence is unconfirmed.

A multiply rule carries resulting_rates: each base rate in its scope times the factor, which is the price when that rule applies and no other conditional rule does. A set rule has resulting_rates: null, because its amount is the rate. Nothing combines several conditional rules for you: this API describes rates and is not a quote calculator.

Peak and off-peak. A rule whose condition reads request.utc_hours or request.utc_days has a period: peak where it raises the base rate in its window, off_peak where it lowers it. The base rate is the price outside the window. Every other rule has period: null.

Controls bind to headers, body fields or query parameters. Body paths are JSON Pointers relative to the stated scope. Options preserve the provider's actual values and may include companion headers or body fields. profile: short or long is a display grouping, not a universal duration; retention_s gives a known duration.

Every entry includes cache.retention and service_tier controls. Unknown bindings, options and defaults are null. A known default wraps { value: ... }, so an explicit null value is distinct from an unknown default. Control support and option availability may have conditions. Controls are never inherited across access methods.

A subscription entry is not paid per token, so it has no price of its own. Its pricing is the API list price of the same model: billing is reference and reference_ref names the API entry, which is the entry a providers.dev entry inherits from, or else the entry of the lab's own provider for the same canonical model. price_in, price_out and price_from of the summary say the same. Where the catalog has no such API entry, billing is not_applicable and rules is null; where the source lists a price for the entry all the same, billing is unknown. An imported entry's own cost field stays as models.dev has it.

Component examples below use fictional rates, endpoints and headers.

Cache lifetimes

Every entry has one cache lifetime record, providers_dev.cache.lifetime, and every summary the same object as cache_lifetime. Its list lifetimes holds every lifetime known for the entry, documented and measured, as items of one shape: retention_profile (short or long), basis (documented or measured), source (models.dev or providers.dev), date and lifetime_s in seconds. A documented item is one lifetime the source documents for one way of caching (mode, and documented_as, the text as written, such as 5m); the shortest lifetime the entry documents is short, every other is long. A measured item is one client with one retention setting: client, client_label, parameter and value, the evaluations it is made from (evaluation_ids, as in /evaluations/cache), checks, hits, tested_from_s, first_miss_s and results. The keys of the other kind are null, 0 or [], and basis says which half to read. An empty list means no lifetime is known.

short and long each give a safe value, safe_s, with its basis, source and date, and beside it the two lifetimes it was chosen from. documented_s is the lowest documented lifetime of the profile and measured_s the lowest measured one. Where the provider documents a lifetime, it is the safe value, unless an evaluation of the profile contradicts it: at an age up to and including documented_s, the control included, fewer than half of that evaluation's checks hit (1 of 3 contradicts; 1 of 2 and 2 of 3 do not). Then the safe value is measured_s. Where nothing is documented, it is measured_s. Where nothing is documented or measured, it is null. The safe value is never above documented_s, and a measurement never raises it.

documented_status is what the rule found of the documented lifetime, published where a lifetime above 0 is documented and one is measured: contradicted (safe_s is measured_s) or not_contradicted (safe_s is documented_s; not contradicted is not confirmed). It is null where nothing is documented, nothing is measured, or documented_s is 0: a provider that documents that it does not cache is never called contradicted, and measured_s says what was measured beside it.

Read the case from basis, documented_status, documented_s and measured_s: documented and not measured (basis documented, measured_s null); documented, measured and not contradicted (documented_status not_contradicted, basis documented, and hits_inside of checks_inside: the checks at ages up to documented_s and how many hit); documented and contradicted (documented_status contradicted, basis measured, safe_s equal to measured_s); measured with nothing documented (basis measured, documented_s null); documented as not caching (documented_s 0, basis documented, documented_status null). basis none exactly when safe_s is null.

0 is a value and null is not. safe_s 0 with basis documented: the provider documents that the entry does not cache (two documented items of 0 seconds, mode and documented_as null). safe_s 0 with basis measured: no age at which every check hit; first_miss_s 0 means the immediate re-send already missed. safe_s null: nothing is known; caching may be documented without a lifetime, which cache and providers_dev.cache.documented say.

A measured lifetime is strict. For one evaluation, it is the oldest age through which every check hit, walking the control and then the ages in order and stopping at the first age where any check missed; a later hit does not raise it. An evaluation with no timed check whose control hit says nothing about how long and is in no item. An item's lifetime_s is the lowest over its evaluations, and measured_s is the lowest over the clients: one client whose cache did not hold lowers it, and each client's own value is its item. tested_from_s is the youngest age checked: no younger age was tested.

A measured item's results are its evaluations' results added up by exact age. lifetime_s is read from each evaluation on its own and the lowest taken, so where an item has several evaluations the added-up results can show full hits at an older age than lifetime_s, never a younger one. The sums over different clients are not published as a value.

The record states what the documentation says and what evaluations found on their dates, through the clients named. It is not a guarantee of how long a provider keeps a prompt. Every value is worked out once, when the data is built; the website prints it as published.

Cache evaluations

Results by age are published in two places: on each evaluation (providers_dev.cache.evaluations of the full entry, and /evaluations/cache), and on each measured item of the lifetime record (results of an item in cache_lifetime.lifetimes, the same object as providers_dev.cache.lifetime.lifetimes), where the evaluations of one client with one retention setting are added up age by age. Short and long are separate items, and so is each client. A profile with no measured item has no lifetime measured: its evaluations count is 0, never a zero hit rate. An evaluation whose control hit and that has no timed check is published, but counts for no lifetime. Results added up over different clients are not published.

Each result records kind, exact age_s, hits, checks and hit_rate_pct. kind: control at age_s: 0 means the immediate resend. A check at 450 seconds remains 7.5 minutes. /meta lists shared display ages; other measured ages remain in results. Missing ages were not checked.

Each measured item names its evaluations in evaluation_ids. /evaluations/cache and the full entry retain the client, route, date, request settings and raw evidence. Results describe that access method and date, not a guaranteed cache lifetime.

Dates and staleness

Every piece of providers.dev evidence has a date: a correction, an evaluation, a measured lifetime, and verified, the newest of an entry. stale_after_days of /meta is the threshold: evidence whose date is more than this many days before today is shown as stale. It is set once when the data is built. The API publishes the dates and this number, never a stale flag, because a flag fixed when the data is built would go wrong as days pass; a reader applies the number to its own date, as the website does. Imported models.dev values carry no such date.

Versions and caching

X-Dataset-Version identifies the catalog and summaries. X-Dataset-Generated-At identifies publication time. Each response has an opaque ETag; reuse it only for the same URL. A 304 has no body. Fresh responses can be cached for 300 seconds with stale-while-revalidate for 3600 seconds.

HTML pages are rendered on request from API responses pinned to one publication. The browser sends filters to /api/v1/entries. Publishing data updates the API and pages without rebuilding page templates. Reference text is built with templates and available at /api/v1/docs/{document}.

Errors and exports

Errors return { error: { code, message, details? } }. 400 means invalid parameters, 404 an unknown resource, 405 an unsupported method, and 503 an incomplete or unavailable snapshot. Errors are not cached.

/api.json is the provider-keyed compatibility export without an envelope. /api/v1/catalog returns the same catalog as { meta, data }. Both preserve the models.dev structure and additions under providers_dev. Added entries can lack upstream-required fields. Data is MIT licensed; retain attribution and notices.

Endpoints

GET /api/v1/entries

Search and filter entries

An entry is a model at a provider and access method. Returns entry summaries. The order is fixed: the sort key, then provider id, then model id.

ParameterLocationValueMeaning
qquerystringWords to find in the provider id or name, the model id or name, the family or the canonical id. Every word must match.
providerquerystringProvider ids, comma-separated. An entry matches any of them.
familyquerystringExact model family, for example claude-opus.
canonical_idquerystringExact canonical model, for example anthropic/claude-opus-5-5: every access method to that model.
typequerystringModel types, comma-separated, for example chat or embedding.
accessquerystringHow the provider is reached: an API key billed by use, a subscription login or plan, or not classified. Allowed: api, subscription, unknown.
originquerystringupstream = as imported from models.dev; modified = imported, with providers.dev corrections or evaluations; added = an entry models.dev does not have. Allowed: upstream, modified, added.
cachequerystringPrompt caching as documented. unknown means the source says nothing, which is not the same as no. Allowed: yes, no, unknown.
cache_modequerystringimplicit = the provider caches on its own; explicit = the request marks what to cache. Allowed: implicit, explicit.
lifetime_basisquerystringThe basis of the safe cache lifetime (cache_lifetime.short.basis, cache_lifetime.long.basis). An entry matches when the basis of its short or of its long profile is one of the values. An entry with no safe lifetime in either profile (basis none) does not match. Allowed: documented, measured.
min_contextqueryintegerSmallest context window, in tokens, that this provider exposes for the model (limit.context). Entries with an unknown window do not match.
min_outputqueryintegerSmallest maximum response size, in tokens (limit.output). A maximum, not a default. Entries with an unknown maximum do not match.
max_age_monthsqueryintegerOnly models released in the last N months, counted back from today (UTC), 1 to 600. A release date given only to the month counts when that month is in range. Entries with an unknown release date do not match.
evaluatedquerybooleantrue = only entries with providers.dev cache evaluations; false = only entries without.
sortquery"provider" | "model" | "name" | "context" | "max_output" | "price_in" | "price_out" | "release_date" | "verified" | "cache_short" | "cache_long"Sort key. cache_short and cache_long sort by the safe cache lifetime in seconds, cache_lifetime.short.safe_s and cache_lifetime.long.safe_s; 0 is a value. Ties are broken by provider id, then model id. Entries with no value for the key (null) come last in either order.
orderquery"asc" | "desc"Sort direction.
limitqueryinteger
Default: 50
Entries per page, 1 to 200. Default 50.
offsetqueryintegerEntries to skip. Default 0.
Response schemas and headers
{
  "200": {
    "description": "A page of entries",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "total",
            "limit",
            "offset",
            "next_offset",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "total": {
              "type": "integer",
              "description": "How many items match."
            },
            "limit": {
              "type": "integer"
            },
            "offset": {
              "type": "integer"
            },
            "next_offset": {
              "type": [
                "integer",
                "null"
              ],
              "description": "The offset of the next page. Null on the last page."
            },
            "data": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/EntrySummary"
              }
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/entries/{provider}/{model}

One entry in full

The provider is the first path segment; the model id is the rest of the path and may contain slashes. URL-encode each segment.

ParameterLocationValueMeaning
provider *pathstringThe provider id.
model *pathstringThe model id at that provider. It may contain slashes.
Response schemas and headers
{
  "200": {
    "description": "The entry",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "data": {
              "type": "object",
              "required": [
                "provider",
                "summary",
                "entry"
              ],
              "additionalProperties": false,
              "properties": {
                "provider": {
                  "$ref": "#/components/schemas/ProviderSummary"
                },
                "summary": {
                  "$ref": "#/components/schemas/EntrySummary"
                },
                "entry": {
                  "$ref": "#/components/schemas/Entry"
                }
              }
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  },
  "404": {
    "description": "No such entry",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/providers

List providers

ParameterLocationValueMeaning
qquerystringWords to find in the provider's id or name. Every word must match.
accessquerystringHow the provider is reached. Allowed: api, subscription, unknown.
originquerystringupstream = imported from models.dev; added = a provider models.dev does not list. Allowed: upstream, added.
limitqueryinteger
Default: 50
Items per page, 1 to 200. Default 50.
offsetqueryintegerItems to skip. Default 0.
Response schemas and headers
{
  "200": {
    "description": "A page of providers",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "total",
            "limit",
            "offset",
            "next_offset",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "total": {
              "type": "integer",
              "description": "How many items match."
            },
            "limit": {
              "type": "integer"
            },
            "offset": {
              "type": "integer"
            },
            "next_offset": {
              "type": [
                "integer",
                "null"
              ],
              "description": "The offset of the next page. Null on the last page."
            },
            "data": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/ProviderSummary"
              }
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/providers/{provider}

One provider with its entries

ParameterLocationValueMeaning
provider *pathstringThe provider id.
viewquery"summary" | "full"summary (default) = the provider and the summaries of its entries; models is null. full = also every entry in full, under models.
Response schemas and headers
{
  "200": {
    "description": "The provider",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "data": {
              "type": "object",
              "required": [
                "provider",
                "entries",
                "models"
              ],
              "additionalProperties": false,
              "properties": {
                "provider": {
                  "$ref": "#/components/schemas/ProviderSummary"
                },
                "entries": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EntrySummary"
                  },
                  "description": "The provider's entries, by name."
                },
                "models": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "additionalProperties": {
                    "$ref": "#/components/schemas/Entry"
                  },
                  "description": "With view=full: the entries in full, by model id. Null with view=summary, so that the answer has the same keys in both views."
                }
              }
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  },
  "404": {
    "description": "No such provider",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/models

List canonical models

A canonical model is a model as its lab names it. Several entries can serve the same one.

ParameterLocationValueMeaning
qquerystringWords to find in the model's id or name. Every word must match.
labquerystringExact lab, the first part of the id, for example anthropic.
limitqueryinteger
Default: 50
Items per page, 1 to 200. Default 50.
offsetqueryintegerItems to skip. Default 0.
Response schemas and headers
{
  "200": {
    "description": "A page of canonical models",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "total",
            "limit",
            "offset",
            "next_offset",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "total": {
              "type": "integer",
              "description": "How many items match."
            },
            "limit": {
              "type": "integer"
            },
            "offset": {
              "type": "integer"
            },
            "next_offset": {
              "type": [
                "integer",
                "null"
              ],
              "description": "The offset of the next page. Null on the last page."
            },
            "data": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/CanonicalModel"
              }
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/models/{lab}/{model}

One canonical model with every entry that serves it

ParameterLocationValueMeaning
lab *pathstringThe first part of the canonical id.
model *pathstringThe rest of the canonical id.
Response schemas and headers
{
  "200": {
    "description": "The model",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "data": {
              "$ref": "#/components/schemas/CanonicalModelDetail"
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  },
  "404": {
    "description": "No such model",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/evaluations/cache

List cache evaluations

Every cache evaluation, newest first, each with the entry it was made on.

ParameterLocationValueMeaning
providerquerystringProvider ids, comma-separated.
entryquerystringExact entry, provider/model.
clientquerystringClient ids, comma-separated, for example direct or cliproxyapi.
retention_profilequery"short" | "long"Only evaluations with this retention profile.
limitqueryinteger
Default: 50
Items per page, 1 to 200. Default 50.
offsetqueryintegerItems to skip. Default 0.
Response schemas and headers
{
  "200": {
    "description": "A page of cache evaluations",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "total",
            "limit",
            "offset",
            "next_offset",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "total": {
              "type": "integer",
              "description": "How many items match."
            },
            "limit": {
              "type": "integer"
            },
            "offset": {
              "type": "integer"
            },
            "next_offset": {
              "type": [
                "integer",
                "null"
              ],
              "description": "The offset of the next page. Null on the last page."
            },
            "data": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/CacheEvaluationRecord"
              }
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/evaluations/limits

List limit evaluations

Every limit evaluation, newest first, each with the entry it was made on.

ParameterLocationValueMeaning
providerquerystringProvider ids, comma-separated.
entryquerystringExact entry, provider/model.
clientquerystringClient ids, comma-separated, for example direct or cliproxyapi.
limitqueryinteger
Default: 50
Items per page, 1 to 200. Default 50.
offsetqueryintegerItems to skip. Default 0.
Response schemas and headers
{
  "200": {
    "description": "A page of limit evaluations",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "total",
            "limit",
            "offset",
            "next_offset",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "total": {
              "type": "integer",
              "description": "How many items match."
            },
            "limit": {
              "type": "integer"
            },
            "offset": {
              "type": "integer"
            },
            "next_offset": {
              "type": [
                "integer",
                "null"
              ],
              "description": "The offset of the next page. Null on the last page."
            },
            "data": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/LimitEvaluationRecord"
              }
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/meta

The dataset: version, counts, freshness, the stale threshold, what is left out, open issues

Response schemas and headers
{
  "200": {
    "description": "The dataset",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "data": {
              "$ref": "#/components/schemas/Meta"
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/catalog

Everything in one file

{ meta, data }, where data is keyed by provider id and each provider holds models keyed by model id. Includes full pricing and request controls; use paginated resources when a full download is unnecessary.

Response schemas and headers
{
  "200": {
    "description": "The catalog",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "data": {
              "type": "object",
              "description": "Keyed by provider id.",
              "additionalProperties": {
                "$ref": "#/components/schemas/Provider"
              }
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  }
}

GET /api/v1/openapi.json

This document

Response schemas and headers
{
  "200": {
    "description": "OpenAPI 3.1",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object"
        }
      }
    }
  }
}

GET /api/v1/facets

Catalog filter options and counts

Response schemas and headers
{
  "200": {
    "description": "Filter options and counts",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "data": {
              "$ref": "#/components/schemas/Facets"
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/corrections

Corrections grouped by identical change and evidence

ParameterLocationValueMeaning
providerquerystringExact provider id.
limitqueryinteger
Default: 50
Items per page, 1 to 200. Default 50.
offsetqueryintegerItems to skip. Default 0.
Response schemas and headers
{
  "200": {
    "description": "A page of corrections",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "total",
            "limit",
            "offset",
            "next_offset",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "total": {
              "type": "integer",
              "description": "How many items match."
            },
            "limit": {
              "type": "integer"
            },
            "offset": {
              "type": "integer"
            },
            "next_offset": {
              "type": [
                "integer",
                "null"
              ],
              "description": "The offset of the next page. Null on the last page."
            },
            "data": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/Correction"
              }
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api/v1/docs/{document}

Authored reference documentation

The methodology, licensing and contributing text shown by the website. Compiled with the templates; contains no dataset values. API documentation is generated from /api/v1/openapi.json.

ParameterLocationValueMeaning
document *pathstringmethodology, licensing or contributing.
Response schemas and headers
{
  "200": {
    "description": "Reference text",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "meta",
            "data"
          ],
          "additionalProperties": false,
          "properties": {
            "meta": {
              "$ref": "#/components/schemas/BriefMeta"
            },
            "data": {
              "$ref": "#/components/schemas/Documentation"
            }
          }
        }
      }
    }
  },
  "304": {
    "description": "Not modified"
  },
  "400": {
    "description": "A parameter is unknown or not valid",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  },
  "404": {
    "description": "No such document",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Error"
        }
      }
    }
  }
}

GET /api.json

Compatibility export

The merged catalog keyed by provider id, in the models.dev v2 structure, with no envelope. Added entries may lack fields that models.dev requires; every entry carries providers_dev. The dataset version is in the X-Dataset-Version header.

Response schemas and headers
{
  "200": {
    "description": "Provider-keyed catalog",
    "headers": {
      "ETag": {
        "schema": {
          "type": "string"
        },
        "description": "An opaque validator for this response representation, including metadata. Send it back to the same URL as If-None-Match to get 304. It is not the dataset version."
      },
      "X-Dataset-Version": {
        "schema": {
          "type": "string"
        }
      },
      "X-Dataset-Generated-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      },
      "X-Upstream-Fetched-At": {
        "schema": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/Provider"
          }
        }
      }
    }
  }
}

Response schemas

BriefMeta

Which dataset the answer is from.

Field (* required)TypeMeaning
dataset_version*string
generated_at*string
upstream_fetched_at*string
Full JSON Schema
{
  "type": "object",
  "properties": {
    "dataset_version": {
      "type": "string"
    },
    "generated_at": {
      "type": "string"
    },
    "upstream_fetched_at": {
      "type": "string"
    }
  },
  "required": [
    "dataset_version",
    "generated_at",
    "upstream_fetched_at"
  ],
  "additionalProperties": false,
  "description": "Which dataset the answer is from."
}

Evidence

A source for something providers.dev publishes.

Field (* required)TypeMeaning
kind*"documented" | "measured" | "listed"documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it.
url*string
date*stringWhen the source was read or the measurement taken.
note*string | nullWhat the source says. Null = no note.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "documented",
        "measured",
        "listed"
      ],
      "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "When the source was read or the measurement taken."
    },
    "note": {
      "description": "What the source says. Null = no note.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "kind",
    "url",
    "date",
    "note"
  ],
  "additionalProperties": false,
  "description": "A source for something providers.dev publishes."
}

Facets

Catalog filter options and counts, calculated by the API.

Field (* required)TypeMeaning
providers*object[]Provider options, ordered by name then id.
types*string[]Known entry types, sorted alphabetically.
evidence_entries*integer
subscription_providers*integer
Full JSON Schema
{
  "type": "object",
  "properties": {
    "providers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "additionalProperties": false
      },
      "description": "Provider options, ordered by name then id."
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Known entry types, sorted alphabetically."
    },
    "evidence_entries": {
      "type": "integer",
      "minimum": 0
    },
    "subscription_providers": {
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "providers",
    "types",
    "evidence_entries",
    "subscription_providers"
  ],
  "additionalProperties": false,
  "description": "Catalog filter options and counts, calculated by the API."
}

Correction

An identical correction grouped across entries.

Field (* required)TypeMeaning
provider*string
change*objectOne correction by providers.dev to a field imported from models.dev.
entry_refs*string[]Entries with this exact correction, original value and evidence.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string"
    },
    "change": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "The field, for example limit.context."
        },
        "op": {
          "type": "string",
          "enum": [
            "set",
            "unknown",
            "delete"
          ],
          "description": "set = a value is published; unknown = published as unknown on purpose; delete = removed."
        },
        "value": {
          "description": "The published value. Null unless op is set.",
          "$ref": "#/components/schemas/Correction/$defs/__schema0"
        },
        "had_upstream": {
          "type": "boolean",
          "description": "Whether models.dev has a value for the field."
        },
        "upstream": {
          "description": "What models.dev says. Null unless had_upstream is true.",
          "$ref": "#/components/schemas/Correction/$defs/__schema0"
        },
        "reason": {
          "type": "string"
        },
        "evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "documented",
                  "measured",
                  "listed"
                ],
                "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "date": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "When the source was read or the measurement taken."
              },
              "note": {
                "description": "What the source says. Null = no note.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "kind",
              "url",
              "date",
              "note"
            ],
            "additionalProperties": false,
            "description": "A source for something providers.dev publishes."
          }
        }
      },
      "required": [
        "path",
        "op",
        "value",
        "had_upstream",
        "upstream",
        "reason",
        "evidence"
      ],
      "additionalProperties": false,
      "description": "One correction by providers.dev to a field imported from models.dev."
    },
    "entry_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Entries with this exact correction, original value and evidence."
    }
  },
  "required": [
    "provider",
    "change",
    "entry_refs"
  ],
  "additionalProperties": false,
  "description": "An identical correction grouped across entries.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Correction/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Correction/$defs/__schema0"
          }
        }
      ]
    }
  }
}

Documentation

The reference text displayed by the website.

Field (* required)TypeMeaning
title*string
description*string
lead*string
toc*object[]
body_html*stringAuthored reference content as an HTML fragment, compiled with the site templates. It contains no dataset values.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "lead": {
      "type": "string"
    },
    "toc": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "label"
        ],
        "additionalProperties": false
      }
    },
    "body_html": {
      "type": "string",
      "description": "Authored reference content as an HTML fragment, compiled with the site templates. It contains no dataset values."
    }
  },
  "required": [
    "title",
    "description",
    "lead",
    "toc",
    "body_html"
  ],
  "additionalProperties": false,
  "description": "The reference text displayed by the website."
}

EntrySummary

One provider-model entry in short: what the lists return and what the tables of the website show. Every summary has every field; a value no source gives is null.

Field (* required)TypeMeaning
ref*stringprovider/model. Provider ids never contain a slash, so the first slash ends the provider.
provider*string
model*stringThe model's id at this provider.
name*string
type*string | nullchat, embedding, image and so on, as models.dev records it. Null = unknown.
family*string | null
canonical_id*string | nullThe canonical model this entry serves, as in /api/v1/models. Null = none is recorded.
status*string | nullalpha, beta or deprecated. Null = none of these.
release_date*string | nullWhen the model was released, as models.dev records it. Null = unknown.
access*"api" | "subscription" | "unknown"
origin*"upstream" | "modified" | "added"upstream = as imported. modified = imported, with providers.dev corrections or evaluations. added = an entry models.dev does not have.
context*number | nulllimit.context in tokens: the window this provider exposes for the model. Null = unknown.
input*number | nulllimit.input in tokens, stated where the input limit is lower than the window. Null = not stated.
max_output*number | nulllimit.output in tokens: the most one response can hold. A maximum, not a default. Null = unknown.
input_window*objectHow much input a request can carry on this entry, documented or measured, and what that rests on: the same object as providers_dev.limits.input_window of the full entry. context, input and max_output beside it are limit as published, unchanged.
cache*"yes" | "no" | "unknown"Prompt caching as documented. unknown = the source says nothing, which is not the same as no.
cache_modes*"implicit" | "explicit"[]implicit = the provider caches on its own. explicit = the request marks what to cache.
cache_mode_support*objectSupport for each mode, from providers_dev.cache.documented.modes. An omitted mode stays unknown.
cache_retention*"supported" | "unsupported" | "unknown"Whether a request can ask for a cache lifetime: providers_dev.cache.retention.support of the full entry.
cache_lifetime*objectEvery cache lifetime of the entry, documented and measured, and the safe value of each retention profile: the same object as providers_dev.cache.lifetime of the full entry.
evaluation_count*integerHow many cache evaluations this entry has.
price_in*number | nullThe base price of text input in US dollars per million tokens, before any conditional rate. On a subscription entry it is the API reference price named by price_from. Null = unknown, or priced in another unit.
price_out*number | nullThe same for output.
price_from*string | nullOn a subscription entry: the ref of the API entry whose list price this is. The entry itself is not paid per token. Null = the price is the entry's own.
pricing*objectThe same normalized pricing record as providers_dev.pricing on the full entry, including all conditions and unparsed source fields.
request_controls*objectThe same controls as providers_dev.request_controls on the full entry. Unknown and unsupported are distinct.
measured_input_accepted*number | nullTokens: the largest input a limit evaluation saw accepted. The real limit is at least this. Null = not measured.
measured_input_refused*number | nullTokens: the smallest input a limit evaluation saw refused. The real limit is below this. Null = not measured.
measured_limit_count*integerHow many limit evaluations this entry has.
overridden_fields*string[]The imported fields providers.dev corrected.
verified*string | nullThe newest date of providers.dev evidence. Null = the entry has none.
shard*integerWhich file under /data/entries/<provider>/ holds the full entry.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "provider/model. Provider ids never contain a slash, so the first slash ends the provider."
    },
    "provider": {
      "type": "string"
    },
    "model": {
      "type": "string",
      "description": "The model's id at this provider."
    },
    "name": {
      "type": "string"
    },
    "type": {
      "description": "chat, embedding, image and so on, as models.dev records it. Null = unknown.",
      "type": [
        "string",
        "null"
      ]
    },
    "family": {
      "type": [
        "string",
        "null"
      ]
    },
    "canonical_id": {
      "description": "The canonical model this entry serves, as in /api/v1/models. Null = none is recorded.",
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "description": "alpha, beta or deprecated. Null = none of these.",
      "type": [
        "string",
        "null"
      ]
    },
    "release_date": {
      "description": "When the model was released, as models.dev records it. Null = unknown.",
      "type": [
        "string",
        "null"
      ]
    },
    "access": {
      "type": "string",
      "enum": [
        "api",
        "subscription",
        "unknown"
      ]
    },
    "origin": {
      "type": "string",
      "enum": [
        "upstream",
        "modified",
        "added"
      ],
      "description": "upstream = as imported. modified = imported, with providers.dev corrections or evaluations. added = an entry models.dev does not have."
    },
    "context": {
      "description": "limit.context in tokens: the window this provider exposes for the model. Null = unknown.",
      "type": [
        "number",
        "null"
      ]
    },
    "input": {
      "description": "limit.input in tokens, stated where the input limit is lower than the window. Null = not stated.",
      "type": [
        "number",
        "null"
      ]
    },
    "max_output": {
      "description": "limit.output in tokens: the most one response can hold. A maximum, not a default. Null = unknown.",
      "type": [
        "number",
        "null"
      ]
    },
    "input_window": {
      "type": "object",
      "properties": {
        "tokens": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The most input a request can carry on this entry, in tokens as the provider counts them, the client's own system prompt and tools included: documented_tokens unless a counted evaluation clearly contradicts it, else measured_tokens, else null. basis says which. Null = not known. Never 0."
        },
        "basis": {
          "type": "string",
          "enum": [
            "documented",
            "measured",
            "none"
          ],
          "description": "documented: tokens is documented_tokens. measured: tokens is measured_tokens. none: exactly when tokens is null."
        },
        "bound": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "limit",
                "at_least"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "limit: the value is the limit, as documented or as the route names it. at_least: the value is the largest input seen accepted, and the real limit is this or more; measured_refused, where set, is an input seen refused. A documented value is always limit. Null with none."
        },
        "scope": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "input",
                "window"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "input: a figure for the input alone (limit.input, or an input size seen accepted). window: a context window that input and output share (limit.context, or a window the route names): the response is counted against the same figure. Null with none."
        },
        "source": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "providers.dev",
                "models.dev"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Who the value is from. measured: always providers.dev. documented: documented_source. Null with none."
        },
        "date": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            {
              "type": "null"
            }
          ],
          "description": "measured: measured_date. documented: documented_date. Null with none, and where the source has no date."
        },
        "documented_tokens": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The documented input of the entry: limit.input where it is above 0, else limit.context where it is above 0 and not a measured value named in limits.from_measurement. 0 means none stated. Nothing is read from another entry. Null = none is documented."
        },
        "documented_field": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "limit.input",
                "limit.context"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "The field of the entry documented_tokens is read from. Null with documented_tokens."
        },
        "documented_source": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "providers.dev",
                "models.dev"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "models.dev for an imported value; providers.dev for a correction of the field and for a value in an entry providers.dev added. Null with documented_tokens."
        },
        "documented_date": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            {
              "type": "null"
            }
          ],
          "description": "The import date for models.dev; the newest evidence date for providers.dev. Null = none is documented, or the source has no date."
        },
        "documented_status": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "contradicted",
                "not_contradicted"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "What the rule found of the documented value, where one is documented and at least one evaluation counts. contradicted: an evaluation names a window below it, names another window than a documented limit.context, refused an input at or below 99 % of it, or accepted one at or above 101 % of it; tokens is measured_tokens. not_contradicted: none does, and tokens is documented_tokens; that is not the same as confirmed. Null in every other case."
        },
        "measured_tokens": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The measured value of the entry: the lowest tokens of measurements, whatever the client. Null = no evaluation counts."
        },
        "measured_bound": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "limit",
                "at_least"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "The bound of the measurement that gives measured_tokens (measurements[0]). Null with measured_tokens."
        },
        "measured_kind": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "window",
                "bracket",
                "accepted"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Its kind. Null with measured_tokens."
        },
        "measured_refused": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "Its refused where its kind is bracket: the smallest input it saw refused; the limit is below this. Null otherwise."
        },
        "measured_date": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            {
              "type": "null"
            }
          ],
          "description": "Its date. Null with measured_tokens, and where the evaluation has no date."
        },
        "clients": {
          "type": "integer",
          "minimum": 0,
          "description": "How many different clients measurements has. 0 = not measured."
        },
        "evaluations": {
          "type": "integer",
          "minimum": 0,
          "description": "How many items measurements has: the limit evaluations of the entry that count. 0 = none counts."
        },
        "measurements": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "client": {
                "type": "string",
                "description": "The public id of the client the requests went through, as on the evaluation."
              },
              "client_label": {
                "type": "string"
              },
              "route": {
                "type": "string",
                "description": "The access method the requests went through, as on the evaluation."
              },
              "route_label": {
                "type": "string"
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The day the requests were sent, as on the evaluation. Null = the result carries no date."
              },
              "tokens": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "description": "The value this evaluation gives: named for kind window, accepted for bracket, read for accepted."
              },
              "bound": {
                "type": "string",
                "enum": [
                  "limit",
                  "at_least"
                ],
                "description": "limit for kind window: the route named its limit. at_least for bracket and accepted: the largest input seen accepted; the real limit is this or more."
              },
              "kind": {
                "type": "string",
                "enum": [
                  "window",
                  "bracket",
                  "accepted"
                ],
                "description": "window: the route's own answer named its context window, and no smaller input was refused. bracket: an input was accepted and a larger one refused; the value is the accepted one. accepted: an input was accepted and the reply showed it was read to the end, nothing refused and no window named."
              },
              "accepted": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "input_accepted of the evaluation: the largest input seen accepted. Null = none recorded."
              },
              "refused": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "input_refused of the evaluation: the smallest input seen refused. Null = none."
              },
              "named": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "context of the evaluation: the window the route names. Null = it named none."
              },
              "read": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "input_read of the evaluation: the largest input the reply showed was read to the end. Null = not checked."
              },
              "source": {
                "type": "string",
                "format": "uri",
                "description": "The raw result, as on the evaluation."
              }
            },
            "required": [
              "client",
              "client_label",
              "route",
              "route_label",
              "date",
              "tokens",
              "bound",
              "kind",
              "accepted",
              "refused",
              "named",
              "read",
              "source"
            ],
            "additionalProperties": false,
            "description": "One limit evaluation of the entry that counts for the input window, with the value it gives. One route, one client, one model."
          },
          "description": "One item per counted limit evaluation, ordered by tokens, then limit before at_least, then by client, route, date and source in plain character order, null first. The first item gives the measured_* keys. Empty = none counts. An evaluation that does not count (a refusal with nothing accepted, an accepted size with no refusal, no named window and no read check, the output alone) stays in limits.measured and is in no item."
        }
      },
      "required": [
        "tokens",
        "basis",
        "bound",
        "scope",
        "source",
        "date",
        "documented_tokens",
        "documented_field",
        "documented_source",
        "documented_date",
        "documented_status",
        "measured_tokens",
        "measured_bound",
        "measured_kind",
        "measured_refused",
        "measured_date",
        "clients",
        "evaluations",
        "measurements"
      ],
      "additionalProperties": false,
      "description": "How much input a request can carry on this entry, documented or measured, and what that rests on: the same object as providers_dev.limits.input_window of the full entry. context, input and max_output beside it are limit as published, unchanged."
    },
    "cache": {
      "type": "string",
      "enum": [
        "yes",
        "no",
        "unknown"
      ],
      "description": "Prompt caching as documented. unknown = the source says nothing, which is not the same as no."
    },
    "cache_modes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "implicit",
          "explicit"
        ]
      },
      "description": "implicit = the provider caches on its own. explicit = the request marks what to cache."
    },
    "cache_mode_support": {
      "type": "object",
      "properties": {
        "implicit": {
          "type": "string",
          "enum": [
            "supported",
            "unsupported",
            "unknown"
          ]
        },
        "explicit": {
          "type": "string",
          "enum": [
            "supported",
            "unsupported",
            "unknown"
          ]
        }
      },
      "required": [
        "implicit",
        "explicit"
      ],
      "additionalProperties": false,
      "description": "Support for each mode, from providers_dev.cache.documented.modes. An omitted mode stays unknown."
    },
    "cache_retention": {
      "type": "string",
      "enum": [
        "supported",
        "unsupported",
        "unknown"
      ],
      "description": "Whether a request can ask for a cache lifetime: providers_dev.cache.retention.support of the full entry."
    },
    "cache_lifetime": {
      "type": "object",
      "properties": {
        "short": {
          "type": "object",
          "properties": {
            "safe_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
            },
            "basis": {
              "type": "string",
              "enum": [
                "measured",
                "documented",
                "none"
              ],
              "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "providers.dev",
                    "models.dev"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
            },
            "date": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
            },
            "documented_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
            },
            "measured_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
            },
            "documented_status": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "contradicted",
                    "not_contradicted"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
            },
            "clients": {
              "type": "integer",
              "minimum": 0,
              "description": "How many clients were measured. 0 = not measured."
            },
            "evaluations": {
              "type": "integer",
              "minimum": 0,
              "description": "How many evaluations were counted. 0 = not measured."
            },
            "checks": {
              "type": "integer",
              "minimum": 0,
              "description": "Re-sends made in them, the control included."
            },
            "hits": {
              "type": "integer",
              "minimum": 0,
              "description": "How many of those were served from the cache."
            },
            "checks_inside": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
            },
            "hits_inside": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "How many of checks_inside were served from the cache. Null with checks_inside."
            },
            "tested_from_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
            },
            "first_miss_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
            }
          },
          "required": [
            "safe_s",
            "basis",
            "source",
            "date",
            "documented_s",
            "measured_s",
            "documented_status",
            "clients",
            "evaluations",
            "checks",
            "hits",
            "checks_inside",
            "hits_inside",
            "tested_from_s",
            "first_miss_s"
          ],
          "additionalProperties": false,
          "description": "The short profile: no lifetime asked for, or the shortest documented one."
        },
        "long": {
          "type": "object",
          "properties": {
            "safe_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
            },
            "basis": {
              "type": "string",
              "enum": [
                "measured",
                "documented",
                "none"
              ],
              "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "providers.dev",
                    "models.dev"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
            },
            "date": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
            },
            "documented_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
            },
            "measured_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
            },
            "documented_status": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "contradicted",
                    "not_contradicted"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
            },
            "clients": {
              "type": "integer",
              "minimum": 0,
              "description": "How many clients were measured. 0 = not measured."
            },
            "evaluations": {
              "type": "integer",
              "minimum": 0,
              "description": "How many evaluations were counted. 0 = not measured."
            },
            "checks": {
              "type": "integer",
              "minimum": 0,
              "description": "Re-sends made in them, the control included."
            },
            "hits": {
              "type": "integer",
              "minimum": 0,
              "description": "How many of those were served from the cache."
            },
            "checks_inside": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
            },
            "hits_inside": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "How many of checks_inside were served from the cache. Null with checks_inside."
            },
            "tested_from_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
            },
            "first_miss_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
            }
          },
          "required": [
            "safe_s",
            "basis",
            "source",
            "date",
            "documented_s",
            "measured_s",
            "documented_status",
            "clients",
            "evaluations",
            "checks",
            "hits",
            "checks_inside",
            "hits_inside",
            "tested_from_s",
            "first_miss_s"
          ],
          "additionalProperties": false,
          "description": "The long profile: a longer lifetime asked for."
        },
        "lifetimes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "retention_profile": {
                "type": "string",
                "enum": [
                  "short",
                  "long"
                ],
                "description": "Documented: short for the shortest lifetime the entry documents, long for every other. Measured: the profile of its evaluations."
              },
              "basis": {
                "type": "string",
                "enum": [
                  "measured",
                  "documented"
                ],
                "description": "documented = a lifetime the source documents. measured = what the evaluations of one client with one retention setting showed. Says which of the keys below apply."
              },
              "source": {
                "type": "string",
                "enum": [
                  "providers.dev",
                  "models.dev"
                ],
                "description": "Documented: models.dev, or providers.dev where the lifetime is a providers.dev correction or the entry is one providers.dev added. Measured: always providers.dev."
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Documented: the import date for models.dev, the newest evidence date for providers.dev. Measured: the newest of its evaluations. Null = the source has no date."
              },
              "lifetime_s": {
                "type": "integer",
                "minimum": 0,
                "description": "Documented: the lifetime in whole seconds; 0 only on the item that says the entry does not cache. A documented text that is not a whole number of seconds above 0 is no item. Measured: the oldest tested age through which every check of every one of its evaluations hit; 0 = no such age."
              },
              "mode": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "implicit",
                      "explicit"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Documented: the way of caching the lifetime is documented for. Null on the item that says the entry does not cache, and on a measured item."
              },
              "documented_as": {
                "description": "Documented: the lifetime as the source writes it, for example 5m. Null on the item that says the entry does not cache, and on a measured item.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "client": {
                "description": "Measured: the public id of the client the requests went through, as on the evaluations. Null on a documented item.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "client_label": {
                "description": "Measured: its public label. Null on a documented item.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "parameter": {
                "description": "Measured: the request field that asked for the lifetime, as on the evaluations. Null = no lifetime was asked for, and on a documented item.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "value": {
                "description": "Measured: the value sent in it. Null together with parameter.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "evaluations": {
                "type": "integer",
                "minimum": 0,
                "description": "Measured: how many evaluations the item is made from, at least 1. 0 on a documented item."
              },
              "evaluation_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Measured: their ids, sorted, as in the entry's evaluations and in /api/v1/evaluations/cache. Empty on a documented item."
              },
              "checks": {
                "type": "integer",
                "minimum": 0,
                "description": "Measured: re-sends made in them, the control included. 0 on a documented item."
              },
              "hits": {
                "type": "integer",
                "minimum": 0,
                "description": "Measured: how many of those were served from the cache. 0 on a documented item."
              },
              "tested_from_s": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Measured: the youngest timed age any of them checked; no younger age was checked. Null = none made a timed check, and on a documented item."
              },
              "first_miss_s": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Measured: the youngest age at which any of them had a check that missed; 0 = the immediate re-send. Null = no miss, and on a documented item."
              },
              "results": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "control",
                            "timed"
                          ],
                          "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                        },
                        "age_s": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                        },
                        "hits": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Re-sends served from the cache."
                        },
                        "checks": {
                          "type": "integer",
                          "minimum": 1,
                          "description": "Re-sends made. An age nobody checked has no result at all."
                        },
                        "hit_rate_pct": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 100,
                          "description": "hits / checks, in percent, two decimals."
                        }
                      },
                      "required": [
                        "kind",
                        "age_s",
                        "hits",
                        "checks",
                        "hit_rate_pct"
                      ],
                      "additionalProperties": false,
                      "description": "What was seen at one age."
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Measured: the results of its evaluations added up by exact age, the control first. lifetime_s is read from each evaluation on its own and the lowest taken, so on an item of several evaluations it can be below what these sums show. Null on a documented item."
              }
            },
            "required": [
              "retention_profile",
              "basis",
              "source",
              "date",
              "lifetime_s",
              "mode",
              "documented_as",
              "client",
              "client_label",
              "parameter",
              "value",
              "evaluations",
              "evaluation_ids",
              "checks",
              "hits",
              "tested_from_s",
              "first_miss_s",
              "results"
            ],
            "additionalProperties": false,
            "description": "One lifetime of an entry: documented by a source, or measured for one client with one retention setting. One shape for both; the keys of the other kind are null, 0 or empty."
          },
          "description": "Every lifetime known for the entry: short, then long; in each, the documented items by seconds, implicit before explicit, then by text; then the measured ones, the setting that asked for no lifetime first, then by seconds and value, then by client, then by parameter. Text is compared in plain character order. Empty = none is known."
        }
      },
      "required": [
        "short",
        "long",
        "lifetimes"
      ],
      "additionalProperties": false,
      "description": "Every cache lifetime of the entry, documented and measured, and the safe value of each retention profile: the same object as providers_dev.cache.lifetime of the full entry."
    },
    "evaluation_count": {
      "type": "integer",
      "minimum": 0,
      "description": "How many cache evaluations this entry has."
    },
    "price_in": {
      "description": "The base price of text input in US dollars per million tokens, before any conditional rate. On a subscription entry it is the API reference price named by price_from. Null = unknown, or priced in another unit.",
      "type": [
        "number",
        "null"
      ]
    },
    "price_out": {
      "description": "The same for output.",
      "type": [
        "number",
        "null"
      ]
    },
    "price_from": {
      "description": "On a subscription entry: the ref of the API entry whose list price this is. The entry itself is not paid per token. Null = the price is the entry's own.",
      "type": [
        "string",
        "null"
      ]
    },
    "pricing": {
      "type": "object",
      "properties": {
        "coverage": {
          "type": "string",
          "enum": [
            "unknown",
            "partial",
            "complete",
            "not_applicable"
          ],
          "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
        },
        "billing": {
          "type": "string",
          "enum": [
            "per_use",
            "reference",
            "not_applicable",
            "unknown"
          ],
          "description": "per_use = the entry is billed at these rates. reference = a subscription entry: the rates are the API list prices of reference_ref, not the subscription's bill. not_applicable = a subscription entry with no API entry of the same model to refer to. unknown = rates are listed for the entry and what they bill is not established."
        },
        "reference_ref": {
          "description": "With billing = reference: the API entry the rates are taken from. That is the entry a providers.dev entry inherits from, or the entry of the lab's own provider for the same canonical model. Otherwise null.",
          "type": [
            "string",
            "null"
          ]
        },
        "rules": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "when": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/EntrySummary/$defs/__schema0"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Null = unconditional base rule. A condition with kind=unknown remains unresolved."
                  },
                  "meter": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The charge affected. For text: text.input, text.output, text.reasoning_output, text.cache_read, text.cache_write, text.cache_storage. The same charges exist for audio, image and video (audio.input, image.output, video.output and so on), each priced in its own unit. web_search is the charge for web searches. A multiply rule names one charge or a scope: text.* is every text charge, audio.* every audio charge, * every charge."
                  },
                  "operation": {
                    "type": "string",
                    "enum": [
                      "set",
                      "multiply"
                    ]
                  },
                  "amount": {
                    "type": "number",
                    "minimum": 0,
                    "description": "A price for set, or a factor for multiply. Zero is a known zero, never missing."
                  },
                  "currency": {
                    "description": "ISO currency for a price; null for multipliers or an unknown currency.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "unit": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "description": "For example token, character, request, second or token_hour."
                          },
                          "quantity": {
                            "anyOf": [
                              {
                                "type": "number",
                                "exclusiveMinimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                          }
                        },
                        "required": [
                          "name",
                          "quantity"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Billing unit and scale. Null for multipliers or an unknown unit."
                  },
                  "applies_to": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "all_usage",
                          "above_threshold"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "all_usage = the rate holds for the whole request that matches the condition. above_threshold = only for the part above a size threshold. Imported rules are all_usage: models.dev evaluates a condition per request, and a matching rule prices that request. Null = not established; never infer marginal billing."
                  },
                  "source_path": {
                    "description": "Field in the original cost record. Null for a separately authored rule.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "period": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "peak",
                          "off_peak"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Set on a rule whose condition reads the time of day or the day of the week (request.utc_hours, request.utc_days): peak = the rule raises the base rate in its window, off_peak = it lowers it. The base rate is the price outside the window. Null = not a time rule, or one that leaves the base rate as it is."
                  },
                  "resulting_rates": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "meter": {
                              "type": "string",
                              "minLength": 1
                            },
                            "amount": {
                              "type": "number",
                              "minimum": 0
                            },
                            "currency": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "unit": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "For example token, character, request, second or token_hour."
                                    },
                                    "quantity": {
                                      "anyOf": [
                                        {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "quantity"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "meter",
                            "amount",
                            "currency",
                            "unit"
                          ],
                          "additionalProperties": false,
                          "description": "A base rate after a multiplier."
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "On a multiply rule: each unconditional base rate in its scope times the factor, which is the price when this rule applies and no other conditional rule does. Null on a set rule, whose amount is the rate itself, and on a multiply rule with no base rate in its scope."
                  }
                },
                "required": [
                  "id",
                  "when",
                  "meter",
                  "operation",
                  "amount",
                  "currency",
                  "unit",
                  "applies_to",
                  "source_path",
                  "period",
                  "resulting_rates"
                ],
                "additionalProperties": false
              }
            },
            {
              "type": "null"
            }
          ],
          "description": "Base prices, conditional replacements and multipliers. Null = unknown. [] proves no rules only with complete coverage."
        },
        "rule_order": {
          "anyOf": [
            {
              "type": "string",
              "const": "listed"
            },
            {
              "type": "null"
            }
          ],
          "description": "listed = process matching rules in array order per meter: set replaces the rate and multiply scales it. Imported rules are listed: base rates first, then models.dev's overrides in their order, then its multipliers, which is how models.dev defines a price. Null = combination precedence is unconfirmed; this record cannot produce an authoritative combined quote."
        },
        "unparsed": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "value": {
                "$ref": "#/components/schemas/EntrySummary/$defs/__schema3"
              }
            },
            "required": [
              "path",
              "value"
            ],
            "additionalProperties": false
          },
          "description": "Source fields not normalized, retained without loss. Nonempty means coverage is partial."
        },
        "evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "documented",
                  "measured"
                ]
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "note": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "url",
              "date",
              "note"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "coverage",
        "billing",
        "reference_ref",
        "rules",
        "rule_order",
        "unparsed",
        "evidence"
      ],
      "additionalProperties": false,
      "description": "The same normalized pricing record as providers_dev.pricing on the full entry, including all conditions and unparsed source fields."
    },
    "request_controls": {
      "type": "object",
      "properties": {
        "coverage": {
          "type": "string",
          "enum": [
            "unknown",
            "partial",
            "complete",
            "not_applicable"
          ],
          "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Semantic id, e.g. cache.retention or service_tier; independent of the provider's wire field."
              },
              "support": {
                "type": "string",
                "enum": [
                  "supported",
                  "unsupported",
                  "unknown"
                ]
              },
              "when": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/EntrySummary/$defs/__schema0"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Scope of the support claim: endpoint, protocol, region or another request condition."
              },
              "bindings": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "location": {
                          "type": "string",
                          "enum": [
                            "header",
                            "body",
                            "query"
                          ]
                        },
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                        },
                        "scope": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "request",
                                "content_block"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Where the binding is applied. Null = scope unknown."
                        }
                      },
                      "required": [
                        "location",
                        "path",
                        "scope"
                      ],
                      "additionalProperties": false
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Known places this control is sent. Null means transport is unconfirmed, even when support is documented."
              },
              "options": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "value": {
                          "description": "The provider's actual accepted value, not a display alias.",
                          "$ref": "#/components/schemas/EntrySummary/$defs/__schema4"
                        },
                        "attributes": {
                          "anyOf": [
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/components/schemas/EntrySummary/$defs/__schema5"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Normalized meaning when known, e.g. retention_s: 3600 and profile: long. Short/long alone never specifies a duration."
                        },
                        "settings": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "location": {
                                    "type": "string",
                                    "enum": [
                                      "header",
                                      "body",
                                      "query"
                                    ]
                                  },
                                  "path": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                                  },
                                  "scope": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "request",
                                          "content_block"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Where the binding is applied. Null = scope unknown."
                                  },
                                  "value": {
                                    "$ref": "#/components/schemas/EntrySummary/$defs/__schema6"
                                  }
                                },
                                "required": [
                                  "location",
                                  "path",
                                  "scope",
                                  "value"
                                ],
                                "additionalProperties": false
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Exact fields and any companion headers for this option. Null = transport unknown."
                        },
                        "when": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/EntrySummary/$defs/__schema0"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "value",
                        "attributes",
                        "settings",
                        "when"
                      ],
                      "additionalProperties": false
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "default": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "value": {
                        "$ref": "#/components/schemas/EntrySummary/$defs/__schema7"
                      }
                    },
                    "required": [
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Known default wrapped in value so an explicit JSON null differs from an unknown default."
              },
              "conditions": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Source restrictions not yet represented as condition trees. Nonempty means a caller must not treat the control as unconditional."
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "documented",
                        "measured"
                      ]
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "date": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "note": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "kind",
                    "url",
                    "date",
                    "note"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "id",
              "support",
              "when",
              "bindings",
              "options",
              "default",
              "conditions",
              "evidence"
            ],
            "additionalProperties": false
          },
          "description": "Always includes cache.retention and service_tier. Additional controls use the same schema. No control is inherited across access routes."
        }
      },
      "required": [
        "coverage",
        "items"
      ],
      "additionalProperties": false,
      "description": "The same controls as providers_dev.request_controls on the full entry. Unknown and unsupported are distinct."
    },
    "measured_input_accepted": {
      "description": "Tokens: the largest input a limit evaluation saw accepted. The real limit is at least this. Null = not measured.",
      "type": [
        "number",
        "null"
      ]
    },
    "measured_input_refused": {
      "description": "Tokens: the smallest input a limit evaluation saw refused. The real limit is below this. Null = not measured.",
      "type": [
        "number",
        "null"
      ]
    },
    "measured_limit_count": {
      "type": "integer",
      "minimum": 0,
      "description": "How many limit evaluations this entry has."
    },
    "overridden_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The imported fields providers.dev corrected."
    },
    "verified": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "The newest date of providers.dev evidence. Null = the entry has none."
    },
    "shard": {
      "type": "integer",
      "minimum": 0,
      "description": "Which file under /data/entries/<provider>/ holds the full entry."
    }
  },
  "required": [
    "ref",
    "provider",
    "model",
    "name",
    "type",
    "family",
    "canonical_id",
    "status",
    "release_date",
    "access",
    "origin",
    "context",
    "input",
    "max_output",
    "input_window",
    "cache",
    "cache_modes",
    "cache_mode_support",
    "cache_retention",
    "cache_lifetime",
    "evaluation_count",
    "price_in",
    "price_out",
    "price_from",
    "pricing",
    "request_controls",
    "measured_input_accepted",
    "measured_input_refused",
    "measured_limit_count",
    "overridden_fields",
    "verified",
    "shard"
  ],
  "additionalProperties": false,
  "description": "One provider-model entry in short: what the lists return and what the tables of the website show. Every summary has every field; a value no source gives is null.",
  "$defs": {
    "__schema0": {
      "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "predicate"
            },
            "field": {
              "type": "string",
              "minLength": 1
            },
            "op": {
              "type": "string",
              "enum": [
                "eq",
                "in",
                "gt",
                "gte",
                "lt",
                "lte",
                "min_items"
              ]
            },
            "value": {
              "$ref": "#/components/schemas/EntrySummary/$defs/__schema1"
            }
          },
          "required": [
            "kind",
            "field",
            "op",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ]
            },
            "conditions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/EntrySummary/$defs/__schema0"
              }
            }
          },
          "required": [
            "kind",
            "conditions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "not"
            },
            "condition": {
              "$ref": "#/components/schemas/EntrySummary/$defs/__schema0"
            }
          },
          "required": [
            "kind",
            "condition"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "unknown"
            },
            "raw": {
              "$ref": "#/components/schemas/EntrySummary/$defs/__schema2"
            }
          },
          "required": [
            "kind",
            "raw"
          ],
          "additionalProperties": false
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema1"
          }
        }
      ]
    },
    "__schema2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema2"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema2"
          }
        }
      ]
    },
    "__schema3": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema3"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema3"
          }
        }
      ]
    },
    "__schema4": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema4"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema4"
          }
        }
      ]
    },
    "__schema5": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema5"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema5"
          }
        }
      ]
    },
    "__schema6": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema6"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema6"
          }
        }
      ]
    },
    "__schema7": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema7"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntrySummary/$defs/__schema7"
          }
        }
      ]
    }
  }
}

Entry

One entry in full: the models.dev record of the model at this provider, with providers_dev added. Fields not listed here are passed on from models.dev unchanged.

Field (* required)TypeMeaning
id*string
name*string
descriptionstring
typestring
familystring
canonical_idstring
statusstring
release_datestring
limitobject
capabilitiesobjectDocumented capabilities. Missing fields remain unknown.
costobjectList prices and conditional changes. Other modalities and future price fields are passed through unchanged.
modalitiesobject
apiobject
providers_dev*objectEverything providers.dev adds to an entry. The same keys on every entry.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "name": {
      "type": "string",
      "minLength": 1
    },
    "description": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "family": {
      "type": "string"
    },
    "canonical_id": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "release_date": {
      "type": "string"
    },
    "limit": {
      "type": "object",
      "properties": {
        "context": {
          "description": "Context window in tokens.",
          "type": "number",
          "minimum": 0
        },
        "input": {
          "description": "Maximum input in tokens.",
          "type": "number",
          "minimum": 0
        },
        "output": {
          "description": "Maximum output in tokens.",
          "type": "number",
          "minimum": 0
        }
      },
      "additionalProperties": {}
    },
    "capabilities": {
      "type": "object",
      "properties": {
        "cache": {
          "anyOf": [
            {
              "type": "boolean",
              "const": false
            },
            {
              "type": "object",
              "properties": {
                "implicit": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "ttl": {
                          "description": "Documented lifetimes, such as 5m or 1h.",
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "min_tokens": {
                          "type": "number",
                          "minimum": 0
                        },
                        "max_breakpoints": {
                          "type": "number",
                          "minimum": 0
                        },
                        "targets": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "additionalProperties": {}
                    }
                  ]
                },
                "explicit": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "ttl": {
                          "description": "Documented lifetimes, such as 5m or 1h.",
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "min_tokens": {
                          "type": "number",
                          "minimum": 0
                        },
                        "max_breakpoints": {
                          "type": "number",
                          "minimum": 0
                        },
                        "targets": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "additionalProperties": {}
                    }
                  ]
                }
              },
              "additionalProperties": {}
            }
          ],
          "description": "False explicitly disables caching. Missing modes are unknown."
        },
        "temperature": {
          "type": "boolean"
        },
        "top_k": {
          "type": "boolean"
        },
        "top_p": {
          "type": "boolean"
        },
        "structured_output": {
          "type": "boolean"
        },
        "prompt_cache_key": {
          "type": "boolean"
        },
        "store": {
          "type": "boolean"
        },
        "stream_usage": {
          "type": "boolean"
        },
        "system_updates": {
          "type": "boolean"
        },
        "effort_updates": {
          "type": "boolean"
        },
        "service_tier": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "tools": {
          "type": "object",
          "properties": {
            "supported": {
              "type": "boolean"
            },
            "choice": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "freeform": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "strict": {
              "type": "boolean"
            },
            "updates": {
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        },
        "reasoning": {
          "type": "object",
          "properties": {
            "supported": {
              "type": "boolean"
            },
            "toggle": {
              "type": "boolean"
            },
            "effort": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "budget": {
              "type": "object",
              "properties": {
                "min": {
                  "type": "number"
                },
                "max": {
                  "type": "number"
                }
              },
              "additionalProperties": {}
            },
            "default": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string"
                },
                "value": {
                  "type": [
                    "boolean",
                    "string",
                    "number"
                  ]
                }
              },
              "additionalProperties": {}
            }
          },
          "additionalProperties": {}
        }
      },
      "additionalProperties": {},
      "description": "Documented capabilities. Missing fields remain unknown."
    },
    "cost": {
      "type": "object",
      "properties": {
        "text": {
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "price": {
                  "type": "number"
                },
                "cache": {
                  "type": "object",
                  "properties": {
                    "read": {
                      "type": "number"
                    },
                    "write": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "number"
                          }
                        }
                      ],
                      "description": "Cache write price, or prices keyed by lifetime."
                    },
                    "storage": {
                      "type": "number"
                    },
                    "explicit": {
                      "type": "object",
                      "properties": {
                        "read": {
                          "type": "number"
                        },
                        "write": {
                          "anyOf": [
                            {
                              "type": "number"
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "type": "number"
                              }
                            }
                          ],
                          "description": "Cache write price, or prices keyed by lifetime."
                        },
                        "storage": {
                          "type": "number"
                        }
                      },
                      "additionalProperties": {}
                    }
                  },
                  "additionalProperties": {}
                },
                "unit": {
                  "description": "Alternative source unit. Absent means per million tokens.",
                  "type": "string"
                },
                "overrides": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "when": {
                        "type": "object",
                        "properties": {
                          "context": {
                            "type": "object",
                            "properties": {
                              "gt": {
                                "type": "number"
                              },
                              "gte": {
                                "type": "number"
                              },
                              "lt": {
                                "type": "number"
                              },
                              "lte": {
                                "type": "number"
                              },
                              "equals": {
                                "type": "number"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "service_tier": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "region": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "date": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "utc_hours": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "utc_days": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "holiday": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "thinking": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "boolean"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "all": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/components/schemas/Entry/$defs/__schema0"
                              }
                            }
                          },
                          "any": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/components/schemas/Entry/$defs/__schema0"
                              }
                            }
                          },
                          "not": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "$ref": "#/components/schemas/Entry/$defs/__schema0"
                            }
                          }
                        },
                        "additionalProperties": {},
                        "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
                      },
                      "price": {
                        "type": "number"
                      },
                      "cache": {
                        "type": "object",
                        "properties": {
                          "read": {
                            "type": "number"
                          },
                          "write": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string"
                                },
                                "additionalProperties": {
                                  "type": "number"
                                }
                              }
                            ],
                            "description": "Cache write price, or prices keyed by lifetime."
                          },
                          "storage": {
                            "type": "number"
                          },
                          "explicit": {
                            "type": "object",
                            "properties": {
                              "read": {
                                "type": "number"
                              },
                              "write": {
                                "anyOf": [
                                  {
                                    "type": "number"
                                  },
                                  {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "type": "number"
                                    }
                                  }
                                ],
                                "description": "Cache write price, or prices keyed by lifetime."
                              },
                              "storage": {
                                "type": "number"
                              }
                            },
                            "additionalProperties": {}
                          }
                        },
                        "additionalProperties": {}
                      }
                    },
                    "required": [
                      "when"
                    ],
                    "additionalProperties": {}
                  }
                }
              },
              "additionalProperties": {}
            },
            "output": {
              "type": "object",
              "properties": {
                "price": {
                  "type": "number"
                },
                "reasoning": {
                  "type": "number"
                },
                "unit": {
                  "type": "string"
                },
                "overrides": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "when": {
                        "type": "object",
                        "properties": {
                          "context": {
                            "type": "object",
                            "properties": {
                              "gt": {
                                "type": "number"
                              },
                              "gte": {
                                "type": "number"
                              },
                              "lt": {
                                "type": "number"
                              },
                              "lte": {
                                "type": "number"
                              },
                              "equals": {
                                "type": "number"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "service_tier": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "region": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "date": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "utc_hours": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "utc_days": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "holiday": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "string"
                              },
                              "in": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "gt": {
                                "type": "string"
                              },
                              "gte": {
                                "type": "string"
                              },
                              "lt": {
                                "type": "string"
                              },
                              "lte": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "thinking": {
                            "type": "object",
                            "properties": {
                              "equals": {
                                "type": "boolean"
                              }
                            },
                            "additionalProperties": {}
                          },
                          "all": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/components/schemas/Entry/$defs/__schema0"
                              }
                            }
                          },
                          "any": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/components/schemas/Entry/$defs/__schema0"
                              }
                            }
                          },
                          "not": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "$ref": "#/components/schemas/Entry/$defs/__schema0"
                            }
                          }
                        },
                        "additionalProperties": {},
                        "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
                      },
                      "price": {
                        "type": "number"
                      },
                      "reasoning": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "when"
                    ],
                    "additionalProperties": {}
                  }
                }
              },
              "additionalProperties": {}
            }
          },
          "additionalProperties": {},
          "description": "Text prices in USD per million tokens unless a unit is specified. Missing is unknown; zero is a listed zero price."
        },
        "multipliers": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "when": {
                "type": "object",
                "properties": {
                  "context": {
                    "type": "object",
                    "properties": {
                      "gt": {
                        "type": "number"
                      },
                      "gte": {
                        "type": "number"
                      },
                      "lt": {
                        "type": "number"
                      },
                      "lte": {
                        "type": "number"
                      },
                      "equals": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "service_tier": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "region": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "date": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "utc_hours": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "utc_days": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "holiday": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "thinking": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "all": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/components/schemas/Entry/$defs/__schema0"
                      }
                    }
                  },
                  "any": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/components/schemas/Entry/$defs/__schema0"
                      }
                    }
                  },
                  "not": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "$ref": "#/components/schemas/Entry/$defs/__schema0"
                    }
                  }
                },
                "additionalProperties": {},
                "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
              },
              "factor": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "text": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "input": {
                                "anyOf": [
                                  {
                                    "type": "number"
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "price": {
                                        "type": "number"
                                      },
                                      "cache": {
                                        "type": "object",
                                        "properties": {
                                          "read": {
                                            "type": "number"
                                          },
                                          "write": {
                                            "anyOf": [
                                              {
                                                "type": "number"
                                              },
                                              {
                                                "type": "object",
                                                "propertyNames": {
                                                  "type": "string"
                                                },
                                                "additionalProperties": {
                                                  "type": "number"
                                                }
                                              }
                                            ],
                                            "description": "Cache write price, or prices keyed by lifetime."
                                          },
                                          "storage": {
                                            "type": "number"
                                          },
                                          "explicit": {
                                            "type": "object",
                                            "properties": {
                                              "read": {
                                                "type": "number"
                                              },
                                              "write": {
                                                "anyOf": [
                                                  {
                                                    "type": "number"
                                                  },
                                                  {
                                                    "type": "object",
                                                    "propertyNames": {
                                                      "type": "string"
                                                    },
                                                    "additionalProperties": {
                                                      "type": "number"
                                                    }
                                                  }
                                                ],
                                                "description": "Cache write price, or prices keyed by lifetime."
                                              },
                                              "storage": {
                                                "type": "number"
                                              }
                                            },
                                            "additionalProperties": {}
                                          }
                                        },
                                        "additionalProperties": {}
                                      }
                                    },
                                    "additionalProperties": {}
                                  }
                                ]
                              },
                              "output": {
                                "anyOf": [
                                  {
                                    "type": "number"
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "price": {
                                        "type": "number"
                                      },
                                      "reasoning": {
                                        "type": "number"
                                      }
                                    },
                                    "additionalProperties": {}
                                  }
                                ]
                              }
                            },
                            "additionalProperties": {}
                          }
                        ]
                      }
                    },
                    "additionalProperties": {}
                  }
                ]
              }
            },
            "required": [
              "when",
              "factor"
            ],
            "additionalProperties": {}
          }
        }
      },
      "additionalProperties": {},
      "description": "List prices and conditional changes. Other modalities and future price fields are passed through unchanged."
    },
    "modalities": {
      "type": "object",
      "properties": {
        "input": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "output": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": {}
    },
    "api": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "object",
        "properties": {
          "base_url": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "sdk": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "string"
            }
          },
          "capabilities": {
            "type": "object",
            "properties": {
              "cache": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "const": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "implicit": {
                        "anyOf": [
                          {
                            "type": "boolean"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "ttl": {
                                "description": "Documented lifetimes, such as 5m or 1h.",
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "min_tokens": {
                                "type": "number",
                                "minimum": 0
                              },
                              "max_breakpoints": {
                                "type": "number",
                                "minimum": 0
                              },
                              "targets": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "additionalProperties": {}
                          }
                        ]
                      },
                      "explicit": {
                        "anyOf": [
                          {
                            "type": "boolean"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "ttl": {
                                "description": "Documented lifetimes, such as 5m or 1h.",
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "min_tokens": {
                                "type": "number",
                                "minimum": 0
                              },
                              "max_breakpoints": {
                                "type": "number",
                                "minimum": 0
                              },
                              "targets": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "additionalProperties": {}
                          }
                        ]
                      }
                    },
                    "additionalProperties": {}
                  }
                ],
                "description": "False explicitly disables caching. Missing modes are unknown."
              },
              "temperature": {
                "type": "boolean"
              },
              "top_k": {
                "type": "boolean"
              },
              "top_p": {
                "type": "boolean"
              },
              "structured_output": {
                "type": "boolean"
              },
              "prompt_cache_key": {
                "type": "boolean"
              },
              "store": {
                "type": "boolean"
              },
              "stream_usage": {
                "type": "boolean"
              },
              "system_updates": {
                "type": "boolean"
              },
              "effort_updates": {
                "type": "boolean"
              },
              "service_tier": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "tools": {
                "type": "object",
                "properties": {
                  "supported": {
                    "type": "boolean"
                  },
                  "choice": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "freeform": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "strict": {
                    "type": "boolean"
                  },
                  "updates": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": {}
              },
              "reasoning": {
                "type": "object",
                "properties": {
                  "supported": {
                    "type": "boolean"
                  },
                  "toggle": {
                    "type": "boolean"
                  },
                  "effort": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "budget": {
                    "type": "object",
                    "properties": {
                      "min": {
                        "type": "number"
                      },
                      "max": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "default": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "value": {
                        "type": [
                          "boolean",
                          "string",
                          "number"
                        ]
                      }
                    },
                    "additionalProperties": {}
                  }
                },
                "additionalProperties": {}
              }
            },
            "additionalProperties": {},
            "description": "Documented capabilities. Missing fields remain unknown."
          },
          "compatibility": {
            "type": "object",
            "properties": {
              "max_tokens_field": {
                "type": "string"
              },
              "reasoning_field": {
                "type": "string"
              }
            },
            "additionalProperties": {}
          }
        },
        "additionalProperties": {}
      }
    },
    "providers_dev": {
      "type": "object",
      "properties": {
        "origin": {
          "type": "string",
          "enum": [
            "upstream",
            "added"
          ],
          "description": "upstream = the entry is imported from models.dev. added = models.dev has no entry for this access method."
        },
        "access": {
          "type": "string",
          "enum": [
            "api",
            "subscription",
            "unknown"
          ]
        },
        "provenance": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string",
                "description": "The field, for example limit.context."
              },
              "op": {
                "type": "string",
                "enum": [
                  "set",
                  "unknown",
                  "delete"
                ],
                "description": "set = a value is published; unknown = published as unknown on purpose; delete = removed."
              },
              "value": {
                "description": "The published value. Null unless op is set.",
                "$ref": "#/components/schemas/Entry/$defs/__schema1"
              },
              "had_upstream": {
                "type": "boolean",
                "description": "Whether models.dev has a value for the field."
              },
              "upstream": {
                "description": "What models.dev says. Null unless had_upstream is true.",
                "$ref": "#/components/schemas/Entry/$defs/__schema1"
              },
              "reason": {
                "type": "string"
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "documented",
                        "measured",
                        "listed"
                      ],
                      "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "date": {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                      "description": "When the source was read or the measurement taken."
                    },
                    "note": {
                      "description": "What the source says. Null = no note.",
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "kind",
                    "url",
                    "date",
                    "note"
                  ],
                  "additionalProperties": false,
                  "description": "A source for something providers.dev publishes."
                }
              }
            },
            "required": [
              "path",
              "op",
              "value",
              "had_upstream",
              "upstream",
              "reason",
              "evidence"
            ],
            "additionalProperties": false,
            "description": "One correction by providers.dev to a field imported from models.dev."
          },
          "description": "Corrections to imported fields. Empty = none."
        },
        "inherited": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "from": {
                  "type": "string"
                },
                "fields": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "from",
                "fields"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ],
          "description": "Fields an added entry takes from another entry: identity, and cost where a subscription entry carries the API list price. Null = nothing is inherited."
        },
        "cache": {
          "type": "object",
          "properties": {
            "documented": {
              "type": "object",
              "properties": {
                "support": {
                  "type": "string",
                  "enum": [
                    "supported",
                    "unsupported",
                    "unknown"
                  ]
                },
                "modes": {
                  "type": "object",
                  "properties": {
                    "implicit": {
                      "type": "object",
                      "properties": {
                        "support": {
                          "type": "string",
                          "enum": [
                            "supported",
                            "unsupported",
                            "unknown"
                          ],
                          "description": "An absent mode is unknown. Only an explicit negative means unsupported."
                        },
                        "min_tokens": {
                          "description": "Minimum prompt size in tokens. Null = unknown.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "max_breakpoints": {
                          "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "targets": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Parts of the request that can be cached. Null = unknown or not applicable."
                        }
                      },
                      "required": [
                        "support",
                        "min_tokens",
                        "max_breakpoints",
                        "targets"
                      ],
                      "additionalProperties": false
                    },
                    "explicit": {
                      "type": "object",
                      "properties": {
                        "support": {
                          "type": "string",
                          "enum": [
                            "supported",
                            "unsupported",
                            "unknown"
                          ],
                          "description": "An absent mode is unknown. Only an explicit negative means unsupported."
                        },
                        "min_tokens": {
                          "description": "Minimum prompt size in tokens. Null = unknown.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "max_breakpoints": {
                          "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "targets": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Parts of the request that can be cached. Null = unknown or not applicable."
                        }
                      },
                      "required": [
                        "support",
                        "min_tokens",
                        "max_breakpoints",
                        "targets"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "implicit",
                    "explicit"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "support",
                "modes"
              ],
              "additionalProperties": false,
              "description": "Documented caching normalized for the API and every page. Unknown stays distinct from unsupported."
            },
            "retention": {
              "type": "object",
              "properties": {
                "support": {
                  "type": "string",
                  "enum": [
                    "supported",
                    "unsupported",
                    "unknown"
                  ],
                  "description": "Whether a request parameter controls retention, confirmed by explicit evidence. A sent parameter or a cache hit alone leaves this unknown."
                },
                "parameter": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1
                        },
                        "location": {
                          "type": "string",
                          "minLength": 1
                        }
                      },
                      "required": [
                        "name",
                        "location"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The confirmed request field and its location. Null = unknown."
                },
                "accepted_values": {
                  "anyOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Values explicitly confirmed by the evidence. Requested values alone are not accepted values. Null = unknown."
                },
                "default": {
                  "description": "The lifetime when the parameter is omitted. Null = unknown.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "profiles": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "profile": {
                        "type": "string",
                        "enum": [
                          "short",
                          "long"
                        ],
                        "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
                      },
                      "value": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "profile",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  "description": "Confirmed short and long settings. A null value means omit the parameter. Empty = unknown."
                },
                "conditions": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Restrictions by client, protocol or header."
                },
                "evidence": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "documented",
                          "measured"
                        ]
                      },
                      "url": {
                        "type": "string",
                        "format": "uri"
                      },
                      "date": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "note": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "kind",
                      "url",
                      "date",
                      "note"
                    ],
                    "additionalProperties": false
                  },
                  "description": "Evidence for parameter support, values and conditions."
                }
              },
              "required": [
                "support",
                "parameter",
                "accepted_values",
                "default",
                "profiles",
                "conditions",
                "evidence"
              ],
              "additionalProperties": false,
              "description": "Confirmed retention controls. Observed cache behavior and requested settings are published separately in evaluations."
            },
            "lifetime": {
              "type": "object",
              "properties": {
                "short": {
                  "type": "object",
                  "properties": {
                    "safe_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
                    },
                    "basis": {
                      "type": "string",
                      "enum": [
                        "measured",
                        "documented",
                        "none"
                      ],
                      "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
                    },
                    "source": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "providers.dev",
                            "models.dev"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
                    },
                    "date": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
                    },
                    "documented_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
                    },
                    "measured_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
                    },
                    "documented_status": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "contradicted",
                            "not_contradicted"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
                    },
                    "clients": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "How many clients were measured. 0 = not measured."
                    },
                    "evaluations": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "How many evaluations were counted. 0 = not measured."
                    },
                    "checks": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Re-sends made in them, the control included."
                    },
                    "hits": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "How many of those were served from the cache."
                    },
                    "checks_inside": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
                    },
                    "hits_inside": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "How many of checks_inside were served from the cache. Null with checks_inside."
                    },
                    "tested_from_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
                    },
                    "first_miss_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
                    }
                  },
                  "required": [
                    "safe_s",
                    "basis",
                    "source",
                    "date",
                    "documented_s",
                    "measured_s",
                    "documented_status",
                    "clients",
                    "evaluations",
                    "checks",
                    "hits",
                    "checks_inside",
                    "hits_inside",
                    "tested_from_s",
                    "first_miss_s"
                  ],
                  "additionalProperties": false,
                  "description": "The short profile: no lifetime asked for, or the shortest documented one."
                },
                "long": {
                  "type": "object",
                  "properties": {
                    "safe_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
                    },
                    "basis": {
                      "type": "string",
                      "enum": [
                        "measured",
                        "documented",
                        "none"
                      ],
                      "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
                    },
                    "source": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "providers.dev",
                            "models.dev"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
                    },
                    "date": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
                    },
                    "documented_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
                    },
                    "measured_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
                    },
                    "documented_status": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "contradicted",
                            "not_contradicted"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
                    },
                    "clients": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "How many clients were measured. 0 = not measured."
                    },
                    "evaluations": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "How many evaluations were counted. 0 = not measured."
                    },
                    "checks": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Re-sends made in them, the control included."
                    },
                    "hits": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "How many of those were served from the cache."
                    },
                    "checks_inside": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
                    },
                    "hits_inside": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "How many of checks_inside were served from the cache. Null with checks_inside."
                    },
                    "tested_from_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
                    },
                    "first_miss_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
                    }
                  },
                  "required": [
                    "safe_s",
                    "basis",
                    "source",
                    "date",
                    "documented_s",
                    "measured_s",
                    "documented_status",
                    "clients",
                    "evaluations",
                    "checks",
                    "hits",
                    "checks_inside",
                    "hits_inside",
                    "tested_from_s",
                    "first_miss_s"
                  ],
                  "additionalProperties": false,
                  "description": "The long profile: a longer lifetime asked for."
                },
                "lifetimes": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "retention_profile": {
                        "type": "string",
                        "enum": [
                          "short",
                          "long"
                        ],
                        "description": "Documented: short for the shortest lifetime the entry documents, long for every other. Measured: the profile of its evaluations."
                      },
                      "basis": {
                        "type": "string",
                        "enum": [
                          "measured",
                          "documented"
                        ],
                        "description": "documented = a lifetime the source documents. measured = what the evaluations of one client with one retention setting showed. Says which of the keys below apply."
                      },
                      "source": {
                        "type": "string",
                        "enum": [
                          "providers.dev",
                          "models.dev"
                        ],
                        "description": "Documented: models.dev, or providers.dev where the lifetime is a providers.dev correction or the entry is one providers.dev added. Measured: always providers.dev."
                      },
                      "date": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Documented: the import date for models.dev, the newest evidence date for providers.dev. Measured: the newest of its evaluations. Null = the source has no date."
                      },
                      "lifetime_s": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "Documented: the lifetime in whole seconds; 0 only on the item that says the entry does not cache. A documented text that is not a whole number of seconds above 0 is no item. Measured: the oldest tested age through which every check of every one of its evaluations hit; 0 = no such age."
                      },
                      "mode": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "implicit",
                              "explicit"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Documented: the way of caching the lifetime is documented for. Null on the item that says the entry does not cache, and on a measured item."
                      },
                      "documented_as": {
                        "description": "Documented: the lifetime as the source writes it, for example 5m. Null on the item that says the entry does not cache, and on a measured item.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "client": {
                        "description": "Measured: the public id of the client the requests went through, as on the evaluations. Null on a documented item.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "client_label": {
                        "description": "Measured: its public label. Null on a documented item.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "parameter": {
                        "description": "Measured: the request field that asked for the lifetime, as on the evaluations. Null = no lifetime was asked for, and on a documented item.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "value": {
                        "description": "Measured: the value sent in it. Null together with parameter.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "evaluations": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "Measured: how many evaluations the item is made from, at least 1. 0 on a documented item."
                      },
                      "evaluation_ids": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Measured: their ids, sorted, as in the entry's evaluations and in /api/v1/evaluations/cache. Empty on a documented item."
                      },
                      "checks": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "Measured: re-sends made in them, the control included. 0 on a documented item."
                      },
                      "hits": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "Measured: how many of those were served from the cache. 0 on a documented item."
                      },
                      "tested_from_s": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Measured: the youngest timed age any of them checked; no younger age was checked. Null = none made a timed check, and on a documented item."
                      },
                      "first_miss_s": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Measured: the youngest age at which any of them had a check that missed; 0 = the immediate re-send. Null = no miss, and on a documented item."
                      },
                      "results": {
                        "anyOf": [
                          {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "enum": [
                                    "control",
                                    "timed"
                                  ],
                                  "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                                },
                                "age_s": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                                },
                                "hits": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "description": "Re-sends served from the cache."
                                },
                                "checks": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "description": "Re-sends made. An age nobody checked has no result at all."
                                },
                                "hit_rate_pct": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 100,
                                  "description": "hits / checks, in percent, two decimals."
                                }
                              },
                              "required": [
                                "kind",
                                "age_s",
                                "hits",
                                "checks",
                                "hit_rate_pct"
                              ],
                              "additionalProperties": false,
                              "description": "What was seen at one age."
                            }
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Measured: the results of its evaluations added up by exact age, the control first. lifetime_s is read from each evaluation on its own and the lowest taken, so on an item of several evaluations it can be below what these sums show. Null on a documented item."
                      }
                    },
                    "required": [
                      "retention_profile",
                      "basis",
                      "source",
                      "date",
                      "lifetime_s",
                      "mode",
                      "documented_as",
                      "client",
                      "client_label",
                      "parameter",
                      "value",
                      "evaluations",
                      "evaluation_ids",
                      "checks",
                      "hits",
                      "tested_from_s",
                      "first_miss_s",
                      "results"
                    ],
                    "additionalProperties": false,
                    "description": "One lifetime of an entry: documented by a source, or measured for one client with one retention setting. One shape for both; the keys of the other kind are null, 0 or empty."
                  },
                  "description": "Every lifetime known for the entry: short, then long; in each, the documented items by seconds, implicit before explicit, then by text; then the measured ones, the setting that asked for no lifetime first, then by seconds and value, then by client, then by parameter. Text is compared in plain character order. Empty = none is known."
                }
              },
              "required": [
                "short",
                "long",
                "lifetimes"
              ],
              "additionalProperties": false,
              "description": "Every cache lifetime of an entry in one list, and the safe value of each retention profile. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee."
            },
            "evaluations": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "The id of the evaluation in the results repository."
                  },
                  "route": {
                    "type": "string",
                    "description": "The access method the requests went through."
                  },
                  "route_label": {
                    "type": "string"
                  },
                  "client": {
                    "type": "string",
                    "description": "What sent the requests: direct, cliproxyapi, a coding tool."
                  },
                  "client_label": {
                    "type": "string"
                  },
                  "date": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "request_settings": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "$ref": "#/components/schemas/Entry/$defs/__schema1"
                    },
                    "description": "What the requests were sent with, as recorded: format, reasoning effort, lifetime and so on."
                  },
                  "retention_profile": {
                    "type": "string",
                    "enum": [
                      "short",
                      "long"
                    ],
                    "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
                  },
                  "parameter": {
                    "description": "The request field that asked for the lifetime, for example cache_control.ttl, prompt_cache_retention or prompt_cache_options.ttl. Null = no lifetime was asked for.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "value": {
                    "description": "The value sent in it, for example 1h. Null together with parameter.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "results": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "control",
                            "timed"
                          ],
                          "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                        },
                        "age_s": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                        },
                        "hits": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Re-sends served from the cache."
                        },
                        "checks": {
                          "type": "integer",
                          "minimum": 1,
                          "description": "Re-sends made. An age nobody checked has no result at all."
                        },
                        "hit_rate_pct": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 100,
                          "description": "hits / checks, in percent, two decimals."
                        }
                      },
                      "required": [
                        "kind",
                        "age_s",
                        "hits",
                        "checks",
                        "hit_rate_pct"
                      ],
                      "additionalProperties": false,
                      "description": "What was seen at one age."
                    },
                    "description": "One result per exact age, the control first."
                  },
                  "late_excluded": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Checks left out because they ran too late for their age. Null = the evaluation does not record it."
                  },
                  "note": {
                    "description": "Null = no note.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "source": {
                    "type": "string",
                    "format": "uri",
                    "description": "The raw result."
                  }
                },
                "required": [
                  "id",
                  "route",
                  "route_label",
                  "client",
                  "client_label",
                  "date",
                  "request_settings",
                  "retention_profile",
                  "parameter",
                  "value",
                  "results",
                  "late_excluded",
                  "note",
                  "source"
                ],
                "additionalProperties": false,
                "description": "One cache evaluation: a fresh prompt cached once, then sent again at once and at set ages."
              },
              "description": "Every published evaluation of the entry, each with its own results, newest first, then by id in plain character order. The measured items of lifetime name them by id."
            }
          },
          "required": [
            "documented",
            "retention",
            "lifetime",
            "evaluations"
          ],
          "additionalProperties": false,
          "description": "Documented caching, confirmed retention controls and evaluations, shared by the website and API."
        },
        "pricing": {
          "type": "object",
          "properties": {
            "coverage": {
              "type": "string",
              "enum": [
                "unknown",
                "partial",
                "complete",
                "not_applicable"
              ],
              "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
            },
            "billing": {
              "type": "string",
              "enum": [
                "per_use",
                "reference",
                "not_applicable",
                "unknown"
              ],
              "description": "per_use = the entry is billed at these rates. reference = a subscription entry: the rates are the API list prices of reference_ref, not the subscription's bill. not_applicable = a subscription entry with no API entry of the same model to refer to. unknown = rates are listed for the entry and what they bill is not established."
            },
            "reference_ref": {
              "description": "With billing = reference: the API entry the rates are taken from. That is the entry a providers.dev entry inherits from, or the entry of the lab's own provider for the same canonical model. Otherwise null.",
              "type": [
                "string",
                "null"
              ]
            },
            "rules": {
              "anyOf": [
                {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1
                      },
                      "when": {
                        "anyOf": [
                          {
                            "$ref": "#/components/schemas/Entry/$defs/__schema2"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Null = unconditional base rule. A condition with kind=unknown remains unresolved."
                      },
                      "meter": {
                        "type": "string",
                        "minLength": 1,
                        "description": "The charge affected. For text: text.input, text.output, text.reasoning_output, text.cache_read, text.cache_write, text.cache_storage. The same charges exist for audio, image and video (audio.input, image.output, video.output and so on), each priced in its own unit. web_search is the charge for web searches. A multiply rule names one charge or a scope: text.* is every text charge, audio.* every audio charge, * every charge."
                      },
                      "operation": {
                        "type": "string",
                        "enum": [
                          "set",
                          "multiply"
                        ]
                      },
                      "amount": {
                        "type": "number",
                        "minimum": 0,
                        "description": "A price for set, or a factor for multiply. Zero is a known zero, never missing."
                      },
                      "currency": {
                        "description": "ISO currency for a price; null for multipliers or an unknown currency.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "unit": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "description": "For example token, character, request, second or token_hour."
                              },
                              "quantity": {
                                "anyOf": [
                                  {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                              }
                            },
                            "required": [
                              "name",
                              "quantity"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Billing unit and scale. Null for multipliers or an unknown unit."
                      },
                      "applies_to": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "all_usage",
                              "above_threshold"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "all_usage = the rate holds for the whole request that matches the condition. above_threshold = only for the part above a size threshold. Imported rules are all_usage: models.dev evaluates a condition per request, and a matching rule prices that request. Null = not established; never infer marginal billing."
                      },
                      "source_path": {
                        "description": "Field in the original cost record. Null for a separately authored rule.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "period": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "peak",
                              "off_peak"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Set on a rule whose condition reads the time of day or the day of the week (request.utc_hours, request.utc_days): peak = the rule raises the base rate in its window, off_peak = it lowers it. The base rate is the price outside the window. Null = not a time rule, or one that leaves the base rate as it is."
                      },
                      "resulting_rates": {
                        "anyOf": [
                          {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "meter": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "amount": {
                                  "type": "number",
                                  "minimum": 0
                                },
                                "currency": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "unit": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "name": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "For example token, character, request, second or token_hour."
                                        },
                                        "quantity": {
                                          "anyOf": [
                                            {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                                        }
                                      },
                                      "required": [
                                        "name",
                                        "quantity"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "meter",
                                "amount",
                                "currency",
                                "unit"
                              ],
                              "additionalProperties": false,
                              "description": "A base rate after a multiplier."
                            }
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "On a multiply rule: each unconditional base rate in its scope times the factor, which is the price when this rule applies and no other conditional rule does. Null on a set rule, whose amount is the rate itself, and on a multiply rule with no base rate in its scope."
                      }
                    },
                    "required": [
                      "id",
                      "when",
                      "meter",
                      "operation",
                      "amount",
                      "currency",
                      "unit",
                      "applies_to",
                      "source_path",
                      "period",
                      "resulting_rates"
                    ],
                    "additionalProperties": false
                  }
                },
                {
                  "type": "null"
                }
              ],
              "description": "Base prices, conditional replacements and multipliers. Null = unknown. [] proves no rules only with complete coverage."
            },
            "rule_order": {
              "anyOf": [
                {
                  "type": "string",
                  "const": "listed"
                },
                {
                  "type": "null"
                }
              ],
              "description": "listed = process matching rules in array order per meter: set replaces the rate and multiply scales it. Imported rules are listed: base rates first, then models.dev's overrides in their order, then its multipliers, which is how models.dev defines a price. Null = combination precedence is unconfirmed; this record cannot produce an authoritative combined quote."
            },
            "unparsed": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "path": {
                    "type": "string"
                  },
                  "value": {
                    "$ref": "#/components/schemas/Entry/$defs/__schema5"
                  }
                },
                "required": [
                  "path",
                  "value"
                ],
                "additionalProperties": false
              },
              "description": "Source fields not normalized, retained without loss. Nonempty means coverage is partial."
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "documented",
                      "measured"
                    ]
                  },
                  "url": {
                    "type": "string",
                    "format": "uri"
                  },
                  "date": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "note": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind",
                  "url",
                  "date",
                  "note"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "coverage",
            "billing",
            "reference_ref",
            "rules",
            "rule_order",
            "unparsed",
            "evidence"
          ],
          "additionalProperties": false,
          "description": "Normalized pricing present on every entry and summary. Source imports are partial unless completeness is explicitly confirmed. Unknown applicability, units or rule interactions must not silently resolve to a base price."
        },
        "request_controls": {
          "type": "object",
          "properties": {
            "coverage": {
              "type": "string",
              "enum": [
                "unknown",
                "partial",
                "complete",
                "not_applicable"
              ],
              "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
            },
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Semantic id, e.g. cache.retention or service_tier; independent of the provider's wire field."
                  },
                  "support": {
                    "type": "string",
                    "enum": [
                      "supported",
                      "unsupported",
                      "unknown"
                    ]
                  },
                  "when": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/Entry/$defs/__schema2"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Scope of the support claim: endpoint, protocol, region or another request condition."
                  },
                  "bindings": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "location": {
                              "type": "string",
                              "enum": [
                                "header",
                                "body",
                                "query"
                              ]
                            },
                            "path": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                            },
                            "scope": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "request",
                                    "content_block"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Where the binding is applied. Null = scope unknown."
                            }
                          },
                          "required": [
                            "location",
                            "path",
                            "scope"
                          ],
                          "additionalProperties": false
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Known places this control is sent. Null means transport is unconfirmed, even when support is documented."
                  },
                  "options": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "value": {
                              "description": "The provider's actual accepted value, not a display alias.",
                              "$ref": "#/components/schemas/Entry/$defs/__schema6"
                            },
                            "attributes": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "propertyNames": {
                                    "type": "string"
                                  },
                                  "additionalProperties": {
                                    "$ref": "#/components/schemas/Entry/$defs/__schema7"
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Normalized meaning when known, e.g. retention_s: 3600 and profile: long. Short/long alone never specifies a duration."
                            },
                            "settings": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "location": {
                                        "type": "string",
                                        "enum": [
                                          "header",
                                          "body",
                                          "query"
                                        ]
                                      },
                                      "path": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                                      },
                                      "scope": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "enum": [
                                              "request",
                                              "content_block"
                                            ]
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "Where the binding is applied. Null = scope unknown."
                                      },
                                      "value": {
                                        "$ref": "#/components/schemas/Entry/$defs/__schema8"
                                      }
                                    },
                                    "required": [
                                      "location",
                                      "path",
                                      "scope",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Exact fields and any companion headers for this option. Null = transport unknown."
                            },
                            "when": {
                              "anyOf": [
                                {
                                  "$ref": "#/components/schemas/Entry/$defs/__schema2"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "value",
                            "attributes",
                            "settings",
                            "when"
                          ],
                          "additionalProperties": false
                        }
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "default": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "value": {
                            "$ref": "#/components/schemas/Entry/$defs/__schema9"
                          }
                        },
                        "required": [
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Known default wrapped in value so an explicit JSON null differs from an unknown default."
                  },
                  "conditions": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Source restrictions not yet represented as condition trees. Nonempty means a caller must not treat the control as unconditional."
                  },
                  "evidence": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "documented",
                            "measured"
                          ]
                        },
                        "url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "date": {
                          "anyOf": [
                            {
                              "type": "string",
                              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "note": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "url",
                        "date",
                        "note"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "id",
                  "support",
                  "when",
                  "bindings",
                  "options",
                  "default",
                  "conditions",
                  "evidence"
                ],
                "additionalProperties": false
              },
              "description": "Always includes cache.retention and service_tier. Additional controls use the same schema. No control is inherited across access routes."
            }
          },
          "required": [
            "coverage",
            "items"
          ],
          "additionalProperties": false
        },
        "limits": {
          "type": "object",
          "properties": {
            "measured": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "route": {
                    "type": "string"
                  },
                  "route_label": {
                    "type": "string"
                  },
                  "client": {
                    "type": "string"
                  },
                  "client_label": {
                    "type": "string"
                  },
                  "context": {
                    "description": "Tokens: the context window found. Null = this evaluation did not measure it.",
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "output": {
                    "description": "Tokens: the largest response found. Null = not measured.",
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "input_accepted": {
                    "description": "Tokens: the largest input seen accepted. The real limit is at least this. Null = not measured.",
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "input_refused": {
                    "description": "Tokens: the smallest input seen refused. The real limit is below this. Null = not measured.",
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "input_read": {
                    "description": "Tokens: the largest input for which the reply showed the route read it to the end (a word before the filler and one after it, both returned). Never above input_accepted. Null = not checked.",
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "output_accepted": {
                    "description": "Tokens: the largest requested output seen accepted. Null = not measured.",
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "note": {
                    "description": "Null = no note.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "date": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The day the requests were sent: the evaluation's own date, else the date in the name of its results folder. Null = the result carries no date."
                  },
                  "source": {
                    "type": "string",
                    "format": "uri"
                  }
                },
                "required": [
                  "route",
                  "route_label",
                  "client",
                  "client_label",
                  "context",
                  "output",
                  "input_accepted",
                  "input_refused",
                  "input_read",
                  "output_accepted",
                  "note",
                  "date",
                  "source"
                ],
                "additionalProperties": false,
                "description": "One limit evaluation. Every evaluation has every field; what it did not measure is null."
              },
              "description": "Limit evaluations on this entry. Empty = none."
            },
            "from_measurement": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "context",
                  "output"
                ]
              },
              "description": "On an added entry: which of limit.context and limit.output are measured values. Empty = none."
            },
            "input_window": {
              "type": "object",
              "properties": {
                "tokens": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The most input a request can carry on this entry, in tokens as the provider counts them, the client's own system prompt and tools included: documented_tokens unless a counted evaluation clearly contradicts it, else measured_tokens, else null. basis says which. Null = not known. Never 0."
                },
                "basis": {
                  "type": "string",
                  "enum": [
                    "documented",
                    "measured",
                    "none"
                  ],
                  "description": "documented: tokens is documented_tokens. measured: tokens is measured_tokens. none: exactly when tokens is null."
                },
                "bound": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "limit",
                        "at_least"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "limit: the value is the limit, as documented or as the route names it. at_least: the value is the largest input seen accepted, and the real limit is this or more; measured_refused, where set, is an input seen refused. A documented value is always limit. Null with none."
                },
                "scope": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "input",
                        "window"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "input: a figure for the input alone (limit.input, or an input size seen accepted). window: a context window that input and output share (limit.context, or a window the route names): the response is counted against the same figure. Null with none."
                },
                "source": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "providers.dev",
                        "models.dev"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Who the value is from. measured: always providers.dev. documented: documented_source. Null with none."
                },
                "date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "measured: measured_date. documented: documented_date. Null with none, and where the source has no date."
                },
                "documented_tokens": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The documented input of the entry: limit.input where it is above 0, else limit.context where it is above 0 and not a measured value named in limits.from_measurement. 0 means none stated. Nothing is read from another entry. Null = none is documented."
                },
                "documented_field": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "limit.input",
                        "limit.context"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The field of the entry documented_tokens is read from. Null with documented_tokens."
                },
                "documented_source": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "providers.dev",
                        "models.dev"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "models.dev for an imported value; providers.dev for a correction of the field and for a value in an entry providers.dev added. Null with documented_tokens."
                },
                "documented_date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The import date for models.dev; the newest evidence date for providers.dev. Null = none is documented, or the source has no date."
                },
                "documented_status": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "contradicted",
                        "not_contradicted"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "What the rule found of the documented value, where one is documented and at least one evaluation counts. contradicted: an evaluation names a window below it, names another window than a documented limit.context, refused an input at or below 99 % of it, or accepted one at or above 101 % of it; tokens is measured_tokens. not_contradicted: none does, and tokens is documented_tokens; that is not the same as confirmed. Null in every other case."
                },
                "measured_tokens": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The measured value of the entry: the lowest tokens of measurements, whatever the client. Null = no evaluation counts."
                },
                "measured_bound": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "limit",
                        "at_least"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The bound of the measurement that gives measured_tokens (measurements[0]). Null with measured_tokens."
                },
                "measured_kind": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "window",
                        "bracket",
                        "accepted"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Its kind. Null with measured_tokens."
                },
                "measured_refused": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Its refused where its kind is bracket: the smallest input it saw refused; the limit is below this. Null otherwise."
                },
                "measured_date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Its date. Null with measured_tokens, and where the evaluation has no date."
                },
                "clients": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "How many different clients measurements has. 0 = not measured."
                },
                "evaluations": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "How many items measurements has: the limit evaluations of the entry that count. 0 = none counts."
                },
                "measurements": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "client": {
                        "type": "string",
                        "description": "The public id of the client the requests went through, as on the evaluation."
                      },
                      "client_label": {
                        "type": "string"
                      },
                      "route": {
                        "type": "string",
                        "description": "The access method the requests went through, as on the evaluation."
                      },
                      "route_label": {
                        "type": "string"
                      },
                      "date": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The day the requests were sent, as on the evaluation. Null = the result carries no date."
                      },
                      "tokens": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "description": "The value this evaluation gives: named for kind window, accepted for bracket, read for accepted."
                      },
                      "bound": {
                        "type": "string",
                        "enum": [
                          "limit",
                          "at_least"
                        ],
                        "description": "limit for kind window: the route named its limit. at_least for bracket and accepted: the largest input seen accepted; the real limit is this or more."
                      },
                      "kind": {
                        "type": "string",
                        "enum": [
                          "window",
                          "bracket",
                          "accepted"
                        ],
                        "description": "window: the route's own answer named its context window, and no smaller input was refused. bracket: an input was accepted and a larger one refused; the value is the accepted one. accepted: an input was accepted and the reply showed it was read to the end, nothing refused and no window named."
                      },
                      "accepted": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "input_accepted of the evaluation: the largest input seen accepted. Null = none recorded."
                      },
                      "refused": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "input_refused of the evaluation: the smallest input seen refused. Null = none."
                      },
                      "named": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "context of the evaluation: the window the route names. Null = it named none."
                      },
                      "read": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "input_read of the evaluation: the largest input the reply showed was read to the end. Null = not checked."
                      },
                      "source": {
                        "type": "string",
                        "format": "uri",
                        "description": "The raw result, as on the evaluation."
                      }
                    },
                    "required": [
                      "client",
                      "client_label",
                      "route",
                      "route_label",
                      "date",
                      "tokens",
                      "bound",
                      "kind",
                      "accepted",
                      "refused",
                      "named",
                      "read",
                      "source"
                    ],
                    "additionalProperties": false,
                    "description": "One limit evaluation of the entry that counts for the input window, with the value it gives. One route, one client, one model."
                  },
                  "description": "One item per counted limit evaluation, ordered by tokens, then limit before at_least, then by client, route, date and source in plain character order, null first. The first item gives the measured_* keys. Empty = none counts. An evaluation that does not count (a refusal with nothing accepted, an accepted size with no refusal, no named window and no read check, the output alone) stays in limits.measured and is in no item."
                }
              },
              "required": [
                "tokens",
                "basis",
                "bound",
                "scope",
                "source",
                "date",
                "documented_tokens",
                "documented_field",
                "documented_source",
                "documented_date",
                "documented_status",
                "measured_tokens",
                "measured_bound",
                "measured_kind",
                "measured_refused",
                "measured_date",
                "clients",
                "evaluations",
                "measurements"
              ],
              "additionalProperties": false,
              "description": "How much input a request can carry on this entry, and what that rests on: the documented value, the measured one beside it, and which the rule chose. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee."
            }
          },
          "required": [
            "measured",
            "from_measurement",
            "input_window"
          ],
          "additionalProperties": false
        },
        "evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "documented",
                  "measured",
                  "listed"
                ],
                "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "date": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "When the source was read or the measurement taken."
              },
              "note": {
                "description": "What the source says. Null = no note.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "kind",
              "url",
              "date",
              "note"
            ],
            "additionalProperties": false,
            "description": "A source for something providers.dev publishes."
          },
          "description": "Sources for an added entry and for authored declarations. Empty = none."
        },
        "verified": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            {
              "type": "null"
            }
          ],
          "description": "The newest date of providers.dev evidence or evaluations for this entry. Null = it has none."
        }
      },
      "required": [
        "origin",
        "access",
        "provenance",
        "inherited",
        "cache",
        "pricing",
        "request_controls",
        "limits",
        "evidence",
        "verified"
      ],
      "additionalProperties": false,
      "description": "Everything providers.dev adds to an entry. The same keys on every entry."
    }
  },
  "required": [
    "id",
    "name",
    "providers_dev"
  ],
  "additionalProperties": {},
  "description": "One entry in full: the models.dev record of the model at this provider, with providers_dev added. Fields not listed here are passed on from models.dev unchanged.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Entry/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Entry/$defs/__schema0"
          }
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Entry/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Entry/$defs/__schema1"
          }
        }
      ]
    },
    "__schema2": {
      "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "predicate"
            },
            "field": {
              "type": "string",
              "minLength": 1
            },
            "op": {
              "type": "string",
              "enum": [
                "eq",
                "in",
                "gt",
                "gte",
                "lt",
                "lte",
                "min_items"
              ]
            },
            "value": {
              "$ref": "#/components/schemas/Entry/$defs/__schema3"
            }
          },
          "required": [
            "kind",
            "field",
            "op",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ]
            },
            "conditions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/Entry/$defs/__schema2"
              }
            }
          },
          "required": [
            "kind",
            "conditions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "not"
            },
            "condition": {
              "$ref": "#/components/schemas/Entry/$defs/__schema2"
            }
          },
          "required": [
            "kind",
            "condition"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "unknown"
            },
            "raw": {
              "$ref": "#/components/schemas/Entry/$defs/__schema4"
            }
          },
          "required": [
            "kind",
            "raw"
          ],
          "additionalProperties": false
        }
      ]
    },
    "__schema3": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Entry/$defs/__schema3"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Entry/$defs/__schema3"
          }
        }
      ]
    },
    "__schema4": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Entry/$defs/__schema4"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Entry/$defs/__schema4"
          }
        }
      ]
    },
    "__schema5": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Entry/$defs/__schema5"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Entry/$defs/__schema5"
          }
        }
      ]
    },
    "__schema6": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Entry/$defs/__schema6"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Entry/$defs/__schema6"
          }
        }
      ]
    },
    "__schema7": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Entry/$defs/__schema7"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Entry/$defs/__schema7"
          }
        }
      ]
    },
    "__schema8": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Entry/$defs/__schema8"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Entry/$defs/__schema8"
          }
        }
      ]
    },
    "__schema9": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Entry/$defs/__schema9"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Entry/$defs/__schema9"
          }
        }
      ]
    }
  }
}

EntryExtension

Everything providers.dev adds to an entry. The same keys on every entry.

Field (* required)TypeMeaning
origin*"upstream" | "added"upstream = the entry is imported from models.dev. added = models.dev has no entry for this access method.
access*"api" | "subscription" | "unknown"
provenance*object[]Corrections to imported fields. Empty = none.
inherited*object | nullFields an added entry takes from another entry: identity, and cost where a subscription entry carries the API list price. Null = nothing is inherited.
cache*objectDocumented caching, confirmed retention controls and evaluations, shared by the website and API.
pricing*objectNormalized pricing present on every entry and summary. Source imports are partial unless completeness is explicitly confirmed. Unknown applicability, units or rule interactions must not silently resolve to a base price.
request_controls*object
limits*object
evidence*object[]Sources for an added entry and for authored declarations. Empty = none.
verified*string | nullThe newest date of providers.dev evidence or evaluations for this entry. Null = it has none.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "enum": [
        "upstream",
        "added"
      ],
      "description": "upstream = the entry is imported from models.dev. added = models.dev has no entry for this access method."
    },
    "access": {
      "type": "string",
      "enum": [
        "api",
        "subscription",
        "unknown"
      ]
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "The field, for example limit.context."
          },
          "op": {
            "type": "string",
            "enum": [
              "set",
              "unknown",
              "delete"
            ],
            "description": "set = a value is published; unknown = published as unknown on purpose; delete = removed."
          },
          "value": {
            "description": "The published value. Null unless op is set.",
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema0"
          },
          "had_upstream": {
            "type": "boolean",
            "description": "Whether models.dev has a value for the field."
          },
          "upstream": {
            "description": "What models.dev says. Null unless had_upstream is true.",
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema0"
          },
          "reason": {
            "type": "string"
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "documented",
                    "measured",
                    "listed"
                  ],
                  "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "date": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "description": "When the source was read or the measurement taken."
                },
                "note": {
                  "description": "What the source says. Null = no note.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "kind",
                "url",
                "date",
                "note"
              ],
              "additionalProperties": false,
              "description": "A source for something providers.dev publishes."
            }
          }
        },
        "required": [
          "path",
          "op",
          "value",
          "had_upstream",
          "upstream",
          "reason",
          "evidence"
        ],
        "additionalProperties": false,
        "description": "One correction by providers.dev to a field imported from models.dev."
      },
      "description": "Corrections to imported fields. Empty = none."
    },
    "inherited": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "from": {
              "type": "string"
            },
            "fields": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "from",
            "fields"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Fields an added entry takes from another entry: identity, and cost where a subscription entry carries the API list price. Null = nothing is inherited."
    },
    "cache": {
      "type": "object",
      "properties": {
        "documented": {
          "type": "object",
          "properties": {
            "support": {
              "type": "string",
              "enum": [
                "supported",
                "unsupported",
                "unknown"
              ]
            },
            "modes": {
              "type": "object",
              "properties": {
                "implicit": {
                  "type": "object",
                  "properties": {
                    "support": {
                      "type": "string",
                      "enum": [
                        "supported",
                        "unsupported",
                        "unknown"
                      ],
                      "description": "An absent mode is unknown. Only an explicit negative means unsupported."
                    },
                    "min_tokens": {
                      "description": "Minimum prompt size in tokens. Null = unknown.",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "max_breakpoints": {
                      "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "targets": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Parts of the request that can be cached. Null = unknown or not applicable."
                    }
                  },
                  "required": [
                    "support",
                    "min_tokens",
                    "max_breakpoints",
                    "targets"
                  ],
                  "additionalProperties": false
                },
                "explicit": {
                  "type": "object",
                  "properties": {
                    "support": {
                      "type": "string",
                      "enum": [
                        "supported",
                        "unsupported",
                        "unknown"
                      ],
                      "description": "An absent mode is unknown. Only an explicit negative means unsupported."
                    },
                    "min_tokens": {
                      "description": "Minimum prompt size in tokens. Null = unknown.",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "max_breakpoints": {
                      "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "targets": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Parts of the request that can be cached. Null = unknown or not applicable."
                    }
                  },
                  "required": [
                    "support",
                    "min_tokens",
                    "max_breakpoints",
                    "targets"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "implicit",
                "explicit"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "support",
            "modes"
          ],
          "additionalProperties": false,
          "description": "Documented caching normalized for the API and every page. Unknown stays distinct from unsupported."
        },
        "retention": {
          "type": "object",
          "properties": {
            "support": {
              "type": "string",
              "enum": [
                "supported",
                "unsupported",
                "unknown"
              ],
              "description": "Whether a request parameter controls retention, confirmed by explicit evidence. A sent parameter or a cache hit alone leaves this unknown."
            },
            "parameter": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "minLength": 1
                    },
                    "location": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "name",
                    "location"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ],
              "description": "The confirmed request field and its location. Null = unknown."
            },
            "accepted_values": {
              "anyOf": [
                {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                {
                  "type": "null"
                }
              ],
              "description": "Values explicitly confirmed by the evidence. Requested values alone are not accepted values. Null = unknown."
            },
            "default": {
              "description": "The lifetime when the parameter is omitted. Null = unknown.",
              "type": [
                "string",
                "null"
              ]
            },
            "profiles": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "string",
                    "enum": [
                      "short",
                      "long"
                    ],
                    "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
                  },
                  "value": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "profile",
                  "value"
                ],
                "additionalProperties": false
              },
              "description": "Confirmed short and long settings. A null value means omit the parameter. Empty = unknown."
            },
            "conditions": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Restrictions by client, protocol or header."
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "documented",
                      "measured"
                    ]
                  },
                  "url": {
                    "type": "string",
                    "format": "uri"
                  },
                  "date": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "note": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind",
                  "url",
                  "date",
                  "note"
                ],
                "additionalProperties": false
              },
              "description": "Evidence for parameter support, values and conditions."
            }
          },
          "required": [
            "support",
            "parameter",
            "accepted_values",
            "default",
            "profiles",
            "conditions",
            "evidence"
          ],
          "additionalProperties": false,
          "description": "Confirmed retention controls. Observed cache behavior and requested settings are published separately in evaluations."
        },
        "lifetime": {
          "type": "object",
          "properties": {
            "short": {
              "type": "object",
              "properties": {
                "safe_s": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
                },
                "basis": {
                  "type": "string",
                  "enum": [
                    "measured",
                    "documented",
                    "none"
                  ],
                  "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
                },
                "source": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "providers.dev",
                        "models.dev"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
                },
                "date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
                },
                "documented_s": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
                },
                "measured_s": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
                },
                "documented_status": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "contradicted",
                        "not_contradicted"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
                },
                "clients": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "How many clients were measured. 0 = not measured."
                },
                "evaluations": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "How many evaluations were counted. 0 = not measured."
                },
                "checks": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "Re-sends made in them, the control included."
                },
                "hits": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "How many of those were served from the cache."
                },
                "checks_inside": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
                },
                "hits_inside": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "How many of checks_inside were served from the cache. Null with checks_inside."
                },
                "tested_from_s": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
                },
                "first_miss_s": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
                }
              },
              "required": [
                "safe_s",
                "basis",
                "source",
                "date",
                "documented_s",
                "measured_s",
                "documented_status",
                "clients",
                "evaluations",
                "checks",
                "hits",
                "checks_inside",
                "hits_inside",
                "tested_from_s",
                "first_miss_s"
              ],
              "additionalProperties": false,
              "description": "The short profile: no lifetime asked for, or the shortest documented one."
            },
            "long": {
              "type": "object",
              "properties": {
                "safe_s": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
                },
                "basis": {
                  "type": "string",
                  "enum": [
                    "measured",
                    "documented",
                    "none"
                  ],
                  "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
                },
                "source": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "providers.dev",
                        "models.dev"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
                },
                "date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
                },
                "documented_s": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
                },
                "measured_s": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
                },
                "documented_status": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "contradicted",
                        "not_contradicted"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
                },
                "clients": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "How many clients were measured. 0 = not measured."
                },
                "evaluations": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "How many evaluations were counted. 0 = not measured."
                },
                "checks": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "Re-sends made in them, the control included."
                },
                "hits": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "How many of those were served from the cache."
                },
                "checks_inside": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
                },
                "hits_inside": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "How many of checks_inside were served from the cache. Null with checks_inside."
                },
                "tested_from_s": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
                },
                "first_miss_s": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
                }
              },
              "required": [
                "safe_s",
                "basis",
                "source",
                "date",
                "documented_s",
                "measured_s",
                "documented_status",
                "clients",
                "evaluations",
                "checks",
                "hits",
                "checks_inside",
                "hits_inside",
                "tested_from_s",
                "first_miss_s"
              ],
              "additionalProperties": false,
              "description": "The long profile: a longer lifetime asked for."
            },
            "lifetimes": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "retention_profile": {
                    "type": "string",
                    "enum": [
                      "short",
                      "long"
                    ],
                    "description": "Documented: short for the shortest lifetime the entry documents, long for every other. Measured: the profile of its evaluations."
                  },
                  "basis": {
                    "type": "string",
                    "enum": [
                      "measured",
                      "documented"
                    ],
                    "description": "documented = a lifetime the source documents. measured = what the evaluations of one client with one retention setting showed. Says which of the keys below apply."
                  },
                  "source": {
                    "type": "string",
                    "enum": [
                      "providers.dev",
                      "models.dev"
                    ],
                    "description": "Documented: models.dev, or providers.dev where the lifetime is a providers.dev correction or the entry is one providers.dev added. Measured: always providers.dev."
                  },
                  "date": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Documented: the import date for models.dev, the newest evidence date for providers.dev. Measured: the newest of its evaluations. Null = the source has no date."
                  },
                  "lifetime_s": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Documented: the lifetime in whole seconds; 0 only on the item that says the entry does not cache. A documented text that is not a whole number of seconds above 0 is no item. Measured: the oldest tested age through which every check of every one of its evaluations hit; 0 = no such age."
                  },
                  "mode": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "implicit",
                          "explicit"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Documented: the way of caching the lifetime is documented for. Null on the item that says the entry does not cache, and on a measured item."
                  },
                  "documented_as": {
                    "description": "Documented: the lifetime as the source writes it, for example 5m. Null on the item that says the entry does not cache, and on a measured item.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "client": {
                    "description": "Measured: the public id of the client the requests went through, as on the evaluations. Null on a documented item.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "client_label": {
                    "description": "Measured: its public label. Null on a documented item.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "parameter": {
                    "description": "Measured: the request field that asked for the lifetime, as on the evaluations. Null = no lifetime was asked for, and on a documented item.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "value": {
                    "description": "Measured: the value sent in it. Null together with parameter.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "evaluations": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Measured: how many evaluations the item is made from, at least 1. 0 on a documented item."
                  },
                  "evaluation_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Measured: their ids, sorted, as in the entry's evaluations and in /api/v1/evaluations/cache. Empty on a documented item."
                  },
                  "checks": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Measured: re-sends made in them, the control included. 0 on a documented item."
                  },
                  "hits": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Measured: how many of those were served from the cache. 0 on a documented item."
                  },
                  "tested_from_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Measured: the youngest timed age any of them checked; no younger age was checked. Null = none made a timed check, and on a documented item."
                  },
                  "first_miss_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Measured: the youngest age at which any of them had a check that missed; 0 = the immediate re-send. Null = no miss, and on a documented item."
                  },
                  "results": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "enum": [
                                "control",
                                "timed"
                              ],
                              "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                            },
                            "age_s": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                            },
                            "hits": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "Re-sends served from the cache."
                            },
                            "checks": {
                              "type": "integer",
                              "minimum": 1,
                              "description": "Re-sends made. An age nobody checked has no result at all."
                            },
                            "hit_rate_pct": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 100,
                              "description": "hits / checks, in percent, two decimals."
                            }
                          },
                          "required": [
                            "kind",
                            "age_s",
                            "hits",
                            "checks",
                            "hit_rate_pct"
                          ],
                          "additionalProperties": false,
                          "description": "What was seen at one age."
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Measured: the results of its evaluations added up by exact age, the control first. lifetime_s is read from each evaluation on its own and the lowest taken, so on an item of several evaluations it can be below what these sums show. Null on a documented item."
                  }
                },
                "required": [
                  "retention_profile",
                  "basis",
                  "source",
                  "date",
                  "lifetime_s",
                  "mode",
                  "documented_as",
                  "client",
                  "client_label",
                  "parameter",
                  "value",
                  "evaluations",
                  "evaluation_ids",
                  "checks",
                  "hits",
                  "tested_from_s",
                  "first_miss_s",
                  "results"
                ],
                "additionalProperties": false,
                "description": "One lifetime of an entry: documented by a source, or measured for one client with one retention setting. One shape for both; the keys of the other kind are null, 0 or empty."
              },
              "description": "Every lifetime known for the entry: short, then long; in each, the documented items by seconds, implicit before explicit, then by text; then the measured ones, the setting that asked for no lifetime first, then by seconds and value, then by client, then by parameter. Text is compared in plain character order. Empty = none is known."
            }
          },
          "required": [
            "short",
            "long",
            "lifetimes"
          ],
          "additionalProperties": false,
          "description": "Every cache lifetime of an entry in one list, and the safe value of each retention profile. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee."
        },
        "evaluations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the evaluation in the results repository."
              },
              "route": {
                "type": "string",
                "description": "The access method the requests went through."
              },
              "route_label": {
                "type": "string"
              },
              "client": {
                "type": "string",
                "description": "What sent the requests: direct, cliproxyapi, a coding tool."
              },
              "client_label": {
                "type": "string"
              },
              "date": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              "request_settings": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "$ref": "#/components/schemas/EntryExtension/$defs/__schema0"
                },
                "description": "What the requests were sent with, as recorded: format, reasoning effort, lifetime and so on."
              },
              "retention_profile": {
                "type": "string",
                "enum": [
                  "short",
                  "long"
                ],
                "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
              },
              "parameter": {
                "description": "The request field that asked for the lifetime, for example cache_control.ttl, prompt_cache_retention or prompt_cache_options.ttl. Null = no lifetime was asked for.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "value": {
                "description": "The value sent in it, for example 1h. Null together with parameter.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "results": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "control",
                        "timed"
                      ],
                      "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                    },
                    "age_s": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                    },
                    "hits": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Re-sends served from the cache."
                    },
                    "checks": {
                      "type": "integer",
                      "minimum": 1,
                      "description": "Re-sends made. An age nobody checked has no result at all."
                    },
                    "hit_rate_pct": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 100,
                      "description": "hits / checks, in percent, two decimals."
                    }
                  },
                  "required": [
                    "kind",
                    "age_s",
                    "hits",
                    "checks",
                    "hit_rate_pct"
                  ],
                  "additionalProperties": false,
                  "description": "What was seen at one age."
                },
                "description": "One result per exact age, the control first."
              },
              "late_excluded": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Checks left out because they ran too late for their age. Null = the evaluation does not record it."
              },
              "note": {
                "description": "Null = no note.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "source": {
                "type": "string",
                "format": "uri",
                "description": "The raw result."
              }
            },
            "required": [
              "id",
              "route",
              "route_label",
              "client",
              "client_label",
              "date",
              "request_settings",
              "retention_profile",
              "parameter",
              "value",
              "results",
              "late_excluded",
              "note",
              "source"
            ],
            "additionalProperties": false,
            "description": "One cache evaluation: a fresh prompt cached once, then sent again at once and at set ages."
          },
          "description": "Every published evaluation of the entry, each with its own results, newest first, then by id in plain character order. The measured items of lifetime name them by id."
        }
      },
      "required": [
        "documented",
        "retention",
        "lifetime",
        "evaluations"
      ],
      "additionalProperties": false,
      "description": "Documented caching, confirmed retention controls and evaluations, shared by the website and API."
    },
    "pricing": {
      "type": "object",
      "properties": {
        "coverage": {
          "type": "string",
          "enum": [
            "unknown",
            "partial",
            "complete",
            "not_applicable"
          ],
          "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
        },
        "billing": {
          "type": "string",
          "enum": [
            "per_use",
            "reference",
            "not_applicable",
            "unknown"
          ],
          "description": "per_use = the entry is billed at these rates. reference = a subscription entry: the rates are the API list prices of reference_ref, not the subscription's bill. not_applicable = a subscription entry with no API entry of the same model to refer to. unknown = rates are listed for the entry and what they bill is not established."
        },
        "reference_ref": {
          "description": "With billing = reference: the API entry the rates are taken from. That is the entry a providers.dev entry inherits from, or the entry of the lab's own provider for the same canonical model. Otherwise null.",
          "type": [
            "string",
            "null"
          ]
        },
        "rules": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "when": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/EntryExtension/$defs/__schema1"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Null = unconditional base rule. A condition with kind=unknown remains unresolved."
                  },
                  "meter": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The charge affected. For text: text.input, text.output, text.reasoning_output, text.cache_read, text.cache_write, text.cache_storage. The same charges exist for audio, image and video (audio.input, image.output, video.output and so on), each priced in its own unit. web_search is the charge for web searches. A multiply rule names one charge or a scope: text.* is every text charge, audio.* every audio charge, * every charge."
                  },
                  "operation": {
                    "type": "string",
                    "enum": [
                      "set",
                      "multiply"
                    ]
                  },
                  "amount": {
                    "type": "number",
                    "minimum": 0,
                    "description": "A price for set, or a factor for multiply. Zero is a known zero, never missing."
                  },
                  "currency": {
                    "description": "ISO currency for a price; null for multipliers or an unknown currency.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "unit": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "description": "For example token, character, request, second or token_hour."
                          },
                          "quantity": {
                            "anyOf": [
                              {
                                "type": "number",
                                "exclusiveMinimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                          }
                        },
                        "required": [
                          "name",
                          "quantity"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Billing unit and scale. Null for multipliers or an unknown unit."
                  },
                  "applies_to": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "all_usage",
                          "above_threshold"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "all_usage = the rate holds for the whole request that matches the condition. above_threshold = only for the part above a size threshold. Imported rules are all_usage: models.dev evaluates a condition per request, and a matching rule prices that request. Null = not established; never infer marginal billing."
                  },
                  "source_path": {
                    "description": "Field in the original cost record. Null for a separately authored rule.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "period": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "peak",
                          "off_peak"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Set on a rule whose condition reads the time of day or the day of the week (request.utc_hours, request.utc_days): peak = the rule raises the base rate in its window, off_peak = it lowers it. The base rate is the price outside the window. Null = not a time rule, or one that leaves the base rate as it is."
                  },
                  "resulting_rates": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "meter": {
                              "type": "string",
                              "minLength": 1
                            },
                            "amount": {
                              "type": "number",
                              "minimum": 0
                            },
                            "currency": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "unit": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "For example token, character, request, second or token_hour."
                                    },
                                    "quantity": {
                                      "anyOf": [
                                        {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "quantity"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "meter",
                            "amount",
                            "currency",
                            "unit"
                          ],
                          "additionalProperties": false,
                          "description": "A base rate after a multiplier."
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "On a multiply rule: each unconditional base rate in its scope times the factor, which is the price when this rule applies and no other conditional rule does. Null on a set rule, whose amount is the rate itself, and on a multiply rule with no base rate in its scope."
                  }
                },
                "required": [
                  "id",
                  "when",
                  "meter",
                  "operation",
                  "amount",
                  "currency",
                  "unit",
                  "applies_to",
                  "source_path",
                  "period",
                  "resulting_rates"
                ],
                "additionalProperties": false
              }
            },
            {
              "type": "null"
            }
          ],
          "description": "Base prices, conditional replacements and multipliers. Null = unknown. [] proves no rules only with complete coverage."
        },
        "rule_order": {
          "anyOf": [
            {
              "type": "string",
              "const": "listed"
            },
            {
              "type": "null"
            }
          ],
          "description": "listed = process matching rules in array order per meter: set replaces the rate and multiply scales it. Imported rules are listed: base rates first, then models.dev's overrides in their order, then its multipliers, which is how models.dev defines a price. Null = combination precedence is unconfirmed; this record cannot produce an authoritative combined quote."
        },
        "unparsed": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "value": {
                "$ref": "#/components/schemas/EntryExtension/$defs/__schema4"
              }
            },
            "required": [
              "path",
              "value"
            ],
            "additionalProperties": false
          },
          "description": "Source fields not normalized, retained without loss. Nonempty means coverage is partial."
        },
        "evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "documented",
                  "measured"
                ]
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "note": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "url",
              "date",
              "note"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "coverage",
        "billing",
        "reference_ref",
        "rules",
        "rule_order",
        "unparsed",
        "evidence"
      ],
      "additionalProperties": false,
      "description": "Normalized pricing present on every entry and summary. Source imports are partial unless completeness is explicitly confirmed. Unknown applicability, units or rule interactions must not silently resolve to a base price."
    },
    "request_controls": {
      "type": "object",
      "properties": {
        "coverage": {
          "type": "string",
          "enum": [
            "unknown",
            "partial",
            "complete",
            "not_applicable"
          ],
          "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Semantic id, e.g. cache.retention or service_tier; independent of the provider's wire field."
              },
              "support": {
                "type": "string",
                "enum": [
                  "supported",
                  "unsupported",
                  "unknown"
                ]
              },
              "when": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/EntryExtension/$defs/__schema1"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Scope of the support claim: endpoint, protocol, region or another request condition."
              },
              "bindings": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "location": {
                          "type": "string",
                          "enum": [
                            "header",
                            "body",
                            "query"
                          ]
                        },
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                        },
                        "scope": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "request",
                                "content_block"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Where the binding is applied. Null = scope unknown."
                        }
                      },
                      "required": [
                        "location",
                        "path",
                        "scope"
                      ],
                      "additionalProperties": false
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Known places this control is sent. Null means transport is unconfirmed, even when support is documented."
              },
              "options": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "value": {
                          "description": "The provider's actual accepted value, not a display alias.",
                          "$ref": "#/components/schemas/EntryExtension/$defs/__schema5"
                        },
                        "attributes": {
                          "anyOf": [
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/components/schemas/EntryExtension/$defs/__schema6"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Normalized meaning when known, e.g. retention_s: 3600 and profile: long. Short/long alone never specifies a duration."
                        },
                        "settings": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "location": {
                                    "type": "string",
                                    "enum": [
                                      "header",
                                      "body",
                                      "query"
                                    ]
                                  },
                                  "path": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                                  },
                                  "scope": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "request",
                                          "content_block"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Where the binding is applied. Null = scope unknown."
                                  },
                                  "value": {
                                    "$ref": "#/components/schemas/EntryExtension/$defs/__schema7"
                                  }
                                },
                                "required": [
                                  "location",
                                  "path",
                                  "scope",
                                  "value"
                                ],
                                "additionalProperties": false
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Exact fields and any companion headers for this option. Null = transport unknown."
                        },
                        "when": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/EntryExtension/$defs/__schema1"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "value",
                        "attributes",
                        "settings",
                        "when"
                      ],
                      "additionalProperties": false
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "default": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "value": {
                        "$ref": "#/components/schemas/EntryExtension/$defs/__schema8"
                      }
                    },
                    "required": [
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Known default wrapped in value so an explicit JSON null differs from an unknown default."
              },
              "conditions": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Source restrictions not yet represented as condition trees. Nonempty means a caller must not treat the control as unconditional."
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "documented",
                        "measured"
                      ]
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "date": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "note": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "kind",
                    "url",
                    "date",
                    "note"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "id",
              "support",
              "when",
              "bindings",
              "options",
              "default",
              "conditions",
              "evidence"
            ],
            "additionalProperties": false
          },
          "description": "Always includes cache.retention and service_tier. Additional controls use the same schema. No control is inherited across access routes."
        }
      },
      "required": [
        "coverage",
        "items"
      ],
      "additionalProperties": false
    },
    "limits": {
      "type": "object",
      "properties": {
        "measured": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "route": {
                "type": "string"
              },
              "route_label": {
                "type": "string"
              },
              "client": {
                "type": "string"
              },
              "client_label": {
                "type": "string"
              },
              "context": {
                "description": "Tokens: the context window found. Null = this evaluation did not measure it.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "output": {
                "description": "Tokens: the largest response found. Null = not measured.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "input_accepted": {
                "description": "Tokens: the largest input seen accepted. The real limit is at least this. Null = not measured.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "input_refused": {
                "description": "Tokens: the smallest input seen refused. The real limit is below this. Null = not measured.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "input_read": {
                "description": "Tokens: the largest input for which the reply showed the route read it to the end (a word before the filler and one after it, both returned). Never above input_accepted. Null = not checked.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "output_accepted": {
                "description": "Tokens: the largest requested output seen accepted. Null = not measured.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "note": {
                "description": "Null = no note.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The day the requests were sent: the evaluation's own date, else the date in the name of its results folder. Null = the result carries no date."
              },
              "source": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "route",
              "route_label",
              "client",
              "client_label",
              "context",
              "output",
              "input_accepted",
              "input_refused",
              "input_read",
              "output_accepted",
              "note",
              "date",
              "source"
            ],
            "additionalProperties": false,
            "description": "One limit evaluation. Every evaluation has every field; what it did not measure is null."
          },
          "description": "Limit evaluations on this entry. Empty = none."
        },
        "from_measurement": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "context",
              "output"
            ]
          },
          "description": "On an added entry: which of limit.context and limit.output are measured values. Empty = none."
        },
        "input_window": {
          "type": "object",
          "properties": {
            "tokens": {
              "anyOf": [
                {
                  "type": "integer",
                  "exclusiveMinimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The most input a request can carry on this entry, in tokens as the provider counts them, the client's own system prompt and tools included: documented_tokens unless a counted evaluation clearly contradicts it, else measured_tokens, else null. basis says which. Null = not known. Never 0."
            },
            "basis": {
              "type": "string",
              "enum": [
                "documented",
                "measured",
                "none"
              ],
              "description": "documented: tokens is documented_tokens. measured: tokens is measured_tokens. none: exactly when tokens is null."
            },
            "bound": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "limit",
                    "at_least"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "limit: the value is the limit, as documented or as the route names it. at_least: the value is the largest input seen accepted, and the real limit is this or more; measured_refused, where set, is an input seen refused. A documented value is always limit. Null with none."
            },
            "scope": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "input",
                    "window"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "input: a figure for the input alone (limit.input, or an input size seen accepted). window: a context window that input and output share (limit.context, or a window the route names): the response is counted against the same figure. Null with none."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "providers.dev",
                    "models.dev"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Who the value is from. measured: always providers.dev. documented: documented_source. Null with none."
            },
            "date": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "measured: measured_date. documented: documented_date. Null with none, and where the source has no date."
            },
            "documented_tokens": {
              "anyOf": [
                {
                  "type": "integer",
                  "exclusiveMinimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The documented input of the entry: limit.input where it is above 0, else limit.context where it is above 0 and not a measured value named in limits.from_measurement. 0 means none stated. Nothing is read from another entry. Null = none is documented."
            },
            "documented_field": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "limit.input",
                    "limit.context"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "The field of the entry documented_tokens is read from. Null with documented_tokens."
            },
            "documented_source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "providers.dev",
                    "models.dev"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "models.dev for an imported value; providers.dev for a correction of the field and for a value in an entry providers.dev added. Null with documented_tokens."
            },
            "documented_date": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The import date for models.dev; the newest evidence date for providers.dev. Null = none is documented, or the source has no date."
            },
            "documented_status": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "contradicted",
                    "not_contradicted"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "What the rule found of the documented value, where one is documented and at least one evaluation counts. contradicted: an evaluation names a window below it, names another window than a documented limit.context, refused an input at or below 99 % of it, or accepted one at or above 101 % of it; tokens is measured_tokens. not_contradicted: none does, and tokens is documented_tokens; that is not the same as confirmed. Null in every other case."
            },
            "measured_tokens": {
              "anyOf": [
                {
                  "type": "integer",
                  "exclusiveMinimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The measured value of the entry: the lowest tokens of measurements, whatever the client. Null = no evaluation counts."
            },
            "measured_bound": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "limit",
                    "at_least"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "The bound of the measurement that gives measured_tokens (measurements[0]). Null with measured_tokens."
            },
            "measured_kind": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "window",
                    "bracket",
                    "accepted"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Its kind. Null with measured_tokens."
            },
            "measured_refused": {
              "anyOf": [
                {
                  "type": "integer",
                  "exclusiveMinimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "Its refused where its kind is bracket: the smallest input it saw refused; the limit is below this. Null otherwise."
            },
            "measured_date": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Its date. Null with measured_tokens, and where the evaluation has no date."
            },
            "clients": {
              "type": "integer",
              "minimum": 0,
              "description": "How many different clients measurements has. 0 = not measured."
            },
            "evaluations": {
              "type": "integer",
              "minimum": 0,
              "description": "How many items measurements has: the limit evaluations of the entry that count. 0 = none counts."
            },
            "measurements": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "client": {
                    "type": "string",
                    "description": "The public id of the client the requests went through, as on the evaluation."
                  },
                  "client_label": {
                    "type": "string"
                  },
                  "route": {
                    "type": "string",
                    "description": "The access method the requests went through, as on the evaluation."
                  },
                  "route_label": {
                    "type": "string"
                  },
                  "date": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The day the requests were sent, as on the evaluation. Null = the result carries no date."
                  },
                  "tokens": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "description": "The value this evaluation gives: named for kind window, accepted for bracket, read for accepted."
                  },
                  "bound": {
                    "type": "string",
                    "enum": [
                      "limit",
                      "at_least"
                    ],
                    "description": "limit for kind window: the route named its limit. at_least for bracket and accepted: the largest input seen accepted; the real limit is this or more."
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "window",
                      "bracket",
                      "accepted"
                    ],
                    "description": "window: the route's own answer named its context window, and no smaller input was refused. bracket: an input was accepted and a larger one refused; the value is the accepted one. accepted: an input was accepted and the reply showed it was read to the end, nothing refused and no window named."
                  },
                  "accepted": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "exclusiveMinimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "input_accepted of the evaluation: the largest input seen accepted. Null = none recorded."
                  },
                  "refused": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "exclusiveMinimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "input_refused of the evaluation: the smallest input seen refused. Null = none."
                  },
                  "named": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "exclusiveMinimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "context of the evaluation: the window the route names. Null = it named none."
                  },
                  "read": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "exclusiveMinimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "input_read of the evaluation: the largest input the reply showed was read to the end. Null = not checked."
                  },
                  "source": {
                    "type": "string",
                    "format": "uri",
                    "description": "The raw result, as on the evaluation."
                  }
                },
                "required": [
                  "client",
                  "client_label",
                  "route",
                  "route_label",
                  "date",
                  "tokens",
                  "bound",
                  "kind",
                  "accepted",
                  "refused",
                  "named",
                  "read",
                  "source"
                ],
                "additionalProperties": false,
                "description": "One limit evaluation of the entry that counts for the input window, with the value it gives. One route, one client, one model."
              },
              "description": "One item per counted limit evaluation, ordered by tokens, then limit before at_least, then by client, route, date and source in plain character order, null first. The first item gives the measured_* keys. Empty = none counts. An evaluation that does not count (a refusal with nothing accepted, an accepted size with no refusal, no named window and no read check, the output alone) stays in limits.measured and is in no item."
            }
          },
          "required": [
            "tokens",
            "basis",
            "bound",
            "scope",
            "source",
            "date",
            "documented_tokens",
            "documented_field",
            "documented_source",
            "documented_date",
            "documented_status",
            "measured_tokens",
            "measured_bound",
            "measured_kind",
            "measured_refused",
            "measured_date",
            "clients",
            "evaluations",
            "measurements"
          ],
          "additionalProperties": false,
          "description": "How much input a request can carry on this entry, and what that rests on: the documented value, the measured one beside it, and which the rule chose. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee."
        }
      },
      "required": [
        "measured",
        "from_measurement",
        "input_window"
      ],
      "additionalProperties": false
    },
    "evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "documented",
              "measured",
              "listed"
            ],
            "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "When the source was read or the measurement taken."
          },
          "note": {
            "description": "What the source says. Null = no note.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "kind",
          "url",
          "date",
          "note"
        ],
        "additionalProperties": false,
        "description": "A source for something providers.dev publishes."
      },
      "description": "Sources for an added entry and for authored declarations. Empty = none."
    },
    "verified": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "The newest date of providers.dev evidence or evaluations for this entry. Null = it has none."
    }
  },
  "required": [
    "origin",
    "access",
    "provenance",
    "inherited",
    "cache",
    "pricing",
    "request_controls",
    "limits",
    "evidence",
    "verified"
  ],
  "additionalProperties": false,
  "description": "Everything providers.dev adds to an entry. The same keys on every entry.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema0"
          }
        }
      ]
    },
    "__schema1": {
      "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "predicate"
            },
            "field": {
              "type": "string",
              "minLength": 1
            },
            "op": {
              "type": "string",
              "enum": [
                "eq",
                "in",
                "gt",
                "gte",
                "lt",
                "lte",
                "min_items"
              ]
            },
            "value": {
              "$ref": "#/components/schemas/EntryExtension/$defs/__schema2"
            }
          },
          "required": [
            "kind",
            "field",
            "op",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ]
            },
            "conditions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/EntryExtension/$defs/__schema1"
              }
            }
          },
          "required": [
            "kind",
            "conditions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "not"
            },
            "condition": {
              "$ref": "#/components/schemas/EntryExtension/$defs/__schema1"
            }
          },
          "required": [
            "kind",
            "condition"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "unknown"
            },
            "raw": {
              "$ref": "#/components/schemas/EntryExtension/$defs/__schema3"
            }
          },
          "required": [
            "kind",
            "raw"
          ],
          "additionalProperties": false
        }
      ]
    },
    "__schema2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema2"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema2"
          }
        }
      ]
    },
    "__schema3": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema3"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema3"
          }
        }
      ]
    },
    "__schema4": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema4"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema4"
          }
        }
      ]
    },
    "__schema5": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema5"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema5"
          }
        }
      ]
    },
    "__schema6": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema6"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema6"
          }
        }
      ]
    },
    "__schema7": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema7"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema7"
          }
        }
      ]
    },
    "__schema8": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema8"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntryExtension/$defs/__schema8"
          }
        }
      ]
    }
  }
}

EntryCache

Documented caching, confirmed retention controls and evaluations, shared by the website and API.

Field (* required)TypeMeaning
documented*objectDocumented caching normalized for the API and every page. Unknown stays distinct from unsupported.
retention*objectConfirmed retention controls. Observed cache behavior and requested settings are published separately in evaluations.
lifetime*objectEvery cache lifetime of an entry in one list, and the safe value of each retention profile. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee.
evaluations*object[]Every published evaluation of the entry, each with its own results, newest first, then by id in plain character order. The measured items of lifetime name them by id.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "documented": {
      "type": "object",
      "properties": {
        "support": {
          "type": "string",
          "enum": [
            "supported",
            "unsupported",
            "unknown"
          ]
        },
        "modes": {
          "type": "object",
          "properties": {
            "implicit": {
              "type": "object",
              "properties": {
                "support": {
                  "type": "string",
                  "enum": [
                    "supported",
                    "unsupported",
                    "unknown"
                  ],
                  "description": "An absent mode is unknown. Only an explicit negative means unsupported."
                },
                "min_tokens": {
                  "description": "Minimum prompt size in tokens. Null = unknown.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "max_breakpoints": {
                  "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "targets": {
                  "anyOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Parts of the request that can be cached. Null = unknown or not applicable."
                }
              },
              "required": [
                "support",
                "min_tokens",
                "max_breakpoints",
                "targets"
              ],
              "additionalProperties": false
            },
            "explicit": {
              "type": "object",
              "properties": {
                "support": {
                  "type": "string",
                  "enum": [
                    "supported",
                    "unsupported",
                    "unknown"
                  ],
                  "description": "An absent mode is unknown. Only an explicit negative means unsupported."
                },
                "min_tokens": {
                  "description": "Minimum prompt size in tokens. Null = unknown.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "max_breakpoints": {
                  "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "targets": {
                  "anyOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Parts of the request that can be cached. Null = unknown or not applicable."
                }
              },
              "required": [
                "support",
                "min_tokens",
                "max_breakpoints",
                "targets"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "implicit",
            "explicit"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "support",
        "modes"
      ],
      "additionalProperties": false,
      "description": "Documented caching normalized for the API and every page. Unknown stays distinct from unsupported."
    },
    "retention": {
      "type": "object",
      "properties": {
        "support": {
          "type": "string",
          "enum": [
            "supported",
            "unsupported",
            "unknown"
          ],
          "description": "Whether a request parameter controls retention, confirmed by explicit evidence. A sent parameter or a cache hit alone leaves this unknown."
        },
        "parameter": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "minLength": 1
                },
                "location": {
                  "type": "string",
                  "minLength": 1
                }
              },
              "required": [
                "name",
                "location"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ],
          "description": "The confirmed request field and its location. Null = unknown."
        },
        "accepted_values": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            },
            {
              "type": "null"
            }
          ],
          "description": "Values explicitly confirmed by the evidence. Requested values alone are not accepted values. Null = unknown."
        },
        "default": {
          "description": "The lifetime when the parameter is omitted. Null = unknown.",
          "type": [
            "string",
            "null"
          ]
        },
        "profiles": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "profile": {
                "type": "string",
                "enum": [
                  "short",
                  "long"
                ],
                "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
              },
              "value": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "profile",
              "value"
            ],
            "additionalProperties": false
          },
          "description": "Confirmed short and long settings. A null value means omit the parameter. Empty = unknown."
        },
        "conditions": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Restrictions by client, protocol or header."
        },
        "evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "documented",
                  "measured"
                ]
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "note": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "url",
              "date",
              "note"
            ],
            "additionalProperties": false
          },
          "description": "Evidence for parameter support, values and conditions."
        }
      },
      "required": [
        "support",
        "parameter",
        "accepted_values",
        "default",
        "profiles",
        "conditions",
        "evidence"
      ],
      "additionalProperties": false,
      "description": "Confirmed retention controls. Observed cache behavior and requested settings are published separately in evaluations."
    },
    "lifetime": {
      "type": "object",
      "properties": {
        "short": {
          "type": "object",
          "properties": {
            "safe_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
            },
            "basis": {
              "type": "string",
              "enum": [
                "measured",
                "documented",
                "none"
              ],
              "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "providers.dev",
                    "models.dev"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
            },
            "date": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
            },
            "documented_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
            },
            "measured_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
            },
            "documented_status": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "contradicted",
                    "not_contradicted"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
            },
            "clients": {
              "type": "integer",
              "minimum": 0,
              "description": "How many clients were measured. 0 = not measured."
            },
            "evaluations": {
              "type": "integer",
              "minimum": 0,
              "description": "How many evaluations were counted. 0 = not measured."
            },
            "checks": {
              "type": "integer",
              "minimum": 0,
              "description": "Re-sends made in them, the control included."
            },
            "hits": {
              "type": "integer",
              "minimum": 0,
              "description": "How many of those were served from the cache."
            },
            "checks_inside": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
            },
            "hits_inside": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "How many of checks_inside were served from the cache. Null with checks_inside."
            },
            "tested_from_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
            },
            "first_miss_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
            }
          },
          "required": [
            "safe_s",
            "basis",
            "source",
            "date",
            "documented_s",
            "measured_s",
            "documented_status",
            "clients",
            "evaluations",
            "checks",
            "hits",
            "checks_inside",
            "hits_inside",
            "tested_from_s",
            "first_miss_s"
          ],
          "additionalProperties": false,
          "description": "The short profile: no lifetime asked for, or the shortest documented one."
        },
        "long": {
          "type": "object",
          "properties": {
            "safe_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
            },
            "basis": {
              "type": "string",
              "enum": [
                "measured",
                "documented",
                "none"
              ],
              "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
            },
            "source": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "providers.dev",
                    "models.dev"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
            },
            "date": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
            },
            "documented_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
            },
            "measured_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
            },
            "documented_status": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "contradicted",
                    "not_contradicted"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
            },
            "clients": {
              "type": "integer",
              "minimum": 0,
              "description": "How many clients were measured. 0 = not measured."
            },
            "evaluations": {
              "type": "integer",
              "minimum": 0,
              "description": "How many evaluations were counted. 0 = not measured."
            },
            "checks": {
              "type": "integer",
              "minimum": 0,
              "description": "Re-sends made in them, the control included."
            },
            "hits": {
              "type": "integer",
              "minimum": 0,
              "description": "How many of those were served from the cache."
            },
            "checks_inside": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
            },
            "hits_inside": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "How many of checks_inside were served from the cache. Null with checks_inside."
            },
            "tested_from_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
            },
            "first_miss_s": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
            }
          },
          "required": [
            "safe_s",
            "basis",
            "source",
            "date",
            "documented_s",
            "measured_s",
            "documented_status",
            "clients",
            "evaluations",
            "checks",
            "hits",
            "checks_inside",
            "hits_inside",
            "tested_from_s",
            "first_miss_s"
          ],
          "additionalProperties": false,
          "description": "The long profile: a longer lifetime asked for."
        },
        "lifetimes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "retention_profile": {
                "type": "string",
                "enum": [
                  "short",
                  "long"
                ],
                "description": "Documented: short for the shortest lifetime the entry documents, long for every other. Measured: the profile of its evaluations."
              },
              "basis": {
                "type": "string",
                "enum": [
                  "measured",
                  "documented"
                ],
                "description": "documented = a lifetime the source documents. measured = what the evaluations of one client with one retention setting showed. Says which of the keys below apply."
              },
              "source": {
                "type": "string",
                "enum": [
                  "providers.dev",
                  "models.dev"
                ],
                "description": "Documented: models.dev, or providers.dev where the lifetime is a providers.dev correction or the entry is one providers.dev added. Measured: always providers.dev."
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Documented: the import date for models.dev, the newest evidence date for providers.dev. Measured: the newest of its evaluations. Null = the source has no date."
              },
              "lifetime_s": {
                "type": "integer",
                "minimum": 0,
                "description": "Documented: the lifetime in whole seconds; 0 only on the item that says the entry does not cache. A documented text that is not a whole number of seconds above 0 is no item. Measured: the oldest tested age through which every check of every one of its evaluations hit; 0 = no such age."
              },
              "mode": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "implicit",
                      "explicit"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Documented: the way of caching the lifetime is documented for. Null on the item that says the entry does not cache, and on a measured item."
              },
              "documented_as": {
                "description": "Documented: the lifetime as the source writes it, for example 5m. Null on the item that says the entry does not cache, and on a measured item.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "client": {
                "description": "Measured: the public id of the client the requests went through, as on the evaluations. Null on a documented item.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "client_label": {
                "description": "Measured: its public label. Null on a documented item.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "parameter": {
                "description": "Measured: the request field that asked for the lifetime, as on the evaluations. Null = no lifetime was asked for, and on a documented item.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "value": {
                "description": "Measured: the value sent in it. Null together with parameter.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "evaluations": {
                "type": "integer",
                "minimum": 0,
                "description": "Measured: how many evaluations the item is made from, at least 1. 0 on a documented item."
              },
              "evaluation_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Measured: their ids, sorted, as in the entry's evaluations and in /api/v1/evaluations/cache. Empty on a documented item."
              },
              "checks": {
                "type": "integer",
                "minimum": 0,
                "description": "Measured: re-sends made in them, the control included. 0 on a documented item."
              },
              "hits": {
                "type": "integer",
                "minimum": 0,
                "description": "Measured: how many of those were served from the cache. 0 on a documented item."
              },
              "tested_from_s": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Measured: the youngest timed age any of them checked; no younger age was checked. Null = none made a timed check, and on a documented item."
              },
              "first_miss_s": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Measured: the youngest age at which any of them had a check that missed; 0 = the immediate re-send. Null = no miss, and on a documented item."
              },
              "results": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "control",
                            "timed"
                          ],
                          "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                        },
                        "age_s": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                        },
                        "hits": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Re-sends served from the cache."
                        },
                        "checks": {
                          "type": "integer",
                          "minimum": 1,
                          "description": "Re-sends made. An age nobody checked has no result at all."
                        },
                        "hit_rate_pct": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 100,
                          "description": "hits / checks, in percent, two decimals."
                        }
                      },
                      "required": [
                        "kind",
                        "age_s",
                        "hits",
                        "checks",
                        "hit_rate_pct"
                      ],
                      "additionalProperties": false,
                      "description": "What was seen at one age."
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Measured: the results of its evaluations added up by exact age, the control first. lifetime_s is read from each evaluation on its own and the lowest taken, so on an item of several evaluations it can be below what these sums show. Null on a documented item."
              }
            },
            "required": [
              "retention_profile",
              "basis",
              "source",
              "date",
              "lifetime_s",
              "mode",
              "documented_as",
              "client",
              "client_label",
              "parameter",
              "value",
              "evaluations",
              "evaluation_ids",
              "checks",
              "hits",
              "tested_from_s",
              "first_miss_s",
              "results"
            ],
            "additionalProperties": false,
            "description": "One lifetime of an entry: documented by a source, or measured for one client with one retention setting. One shape for both; the keys of the other kind are null, 0 or empty."
          },
          "description": "Every lifetime known for the entry: short, then long; in each, the documented items by seconds, implicit before explicit, then by text; then the measured ones, the setting that asked for no lifetime first, then by seconds and value, then by client, then by parameter. Text is compared in plain character order. Empty = none is known."
        }
      },
      "required": [
        "short",
        "long",
        "lifetimes"
      ],
      "additionalProperties": false,
      "description": "Every cache lifetime of an entry in one list, and the safe value of each retention profile. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee."
    },
    "evaluations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The id of the evaluation in the results repository."
          },
          "route": {
            "type": "string",
            "description": "The access method the requests went through."
          },
          "route_label": {
            "type": "string"
          },
          "client": {
            "type": "string",
            "description": "What sent the requests: direct, cliproxyapi, a coding tool."
          },
          "client_label": {
            "type": "string"
          },
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "request_settings": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "$ref": "#/components/schemas/EntryCache/$defs/__schema0"
            },
            "description": "What the requests were sent with, as recorded: format, reasoning effort, lifetime and so on."
          },
          "retention_profile": {
            "type": "string",
            "enum": [
              "short",
              "long"
            ],
            "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
          },
          "parameter": {
            "description": "The request field that asked for the lifetime, for example cache_control.ttl, prompt_cache_retention or prompt_cache_options.ttl. Null = no lifetime was asked for.",
            "type": [
              "string",
              "null"
            ]
          },
          "value": {
            "description": "The value sent in it, for example 1h. Null together with parameter.",
            "type": [
              "string",
              "null"
            ]
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "control",
                    "timed"
                  ],
                  "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                },
                "age_s": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                },
                "hits": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "Re-sends served from the cache."
                },
                "checks": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "Re-sends made. An age nobody checked has no result at all."
                },
                "hit_rate_pct": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 100,
                  "description": "hits / checks, in percent, two decimals."
                }
              },
              "required": [
                "kind",
                "age_s",
                "hits",
                "checks",
                "hit_rate_pct"
              ],
              "additionalProperties": false,
              "description": "What was seen at one age."
            },
            "description": "One result per exact age, the control first."
          },
          "late_excluded": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "description": "Checks left out because they ran too late for their age. Null = the evaluation does not record it."
          },
          "note": {
            "description": "Null = no note.",
            "type": [
              "string",
              "null"
            ]
          },
          "source": {
            "type": "string",
            "format": "uri",
            "description": "The raw result."
          }
        },
        "required": [
          "id",
          "route",
          "route_label",
          "client",
          "client_label",
          "date",
          "request_settings",
          "retention_profile",
          "parameter",
          "value",
          "results",
          "late_excluded",
          "note",
          "source"
        ],
        "additionalProperties": false,
        "description": "One cache evaluation: a fresh prompt cached once, then sent again at once and at set ages."
      },
      "description": "Every published evaluation of the entry, each with its own results, newest first, then by id in plain character order. The measured items of lifetime name them by id."
    }
  },
  "required": [
    "documented",
    "retention",
    "lifetime",
    "evaluations"
  ],
  "additionalProperties": false,
  "description": "Documented caching, confirmed retention controls and evaluations, shared by the website and API.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/EntryCache/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/EntryCache/$defs/__schema0"
          }
        }
      ]
    }
  }
}

CacheDocumentation

Documented caching normalized for the API and every page. Unknown stays distinct from unsupported.

Field (* required)TypeMeaning
support*"supported" | "unsupported" | "unknown"
modes*object
Full JSON Schema
{
  "type": "object",
  "properties": {
    "support": {
      "type": "string",
      "enum": [
        "supported",
        "unsupported",
        "unknown"
      ]
    },
    "modes": {
      "type": "object",
      "properties": {
        "implicit": {
          "type": "object",
          "properties": {
            "support": {
              "type": "string",
              "enum": [
                "supported",
                "unsupported",
                "unknown"
              ],
              "description": "An absent mode is unknown. Only an explicit negative means unsupported."
            },
            "min_tokens": {
              "description": "Minimum prompt size in tokens. Null = unknown.",
              "type": [
                "number",
                "null"
              ]
            },
            "max_breakpoints": {
              "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
              "type": [
                "number",
                "null"
              ]
            },
            "targets": {
              "anyOf": [
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                {
                  "type": "null"
                }
              ],
              "description": "Parts of the request that can be cached. Null = unknown or not applicable."
            }
          },
          "required": [
            "support",
            "min_tokens",
            "max_breakpoints",
            "targets"
          ],
          "additionalProperties": false
        },
        "explicit": {
          "type": "object",
          "properties": {
            "support": {
              "type": "string",
              "enum": [
                "supported",
                "unsupported",
                "unknown"
              ],
              "description": "An absent mode is unknown. Only an explicit negative means unsupported."
            },
            "min_tokens": {
              "description": "Minimum prompt size in tokens. Null = unknown.",
              "type": [
                "number",
                "null"
              ]
            },
            "max_breakpoints": {
              "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
              "type": [
                "number",
                "null"
              ]
            },
            "targets": {
              "anyOf": [
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                {
                  "type": "null"
                }
              ],
              "description": "Parts of the request that can be cached. Null = unknown or not applicable."
            }
          },
          "required": [
            "support",
            "min_tokens",
            "max_breakpoints",
            "targets"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "implicit",
        "explicit"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "support",
    "modes"
  ],
  "additionalProperties": false,
  "description": "Documented caching normalized for the API and every page. Unknown stays distinct from unsupported."
}

CacheModeDocumentation

Field (* required)TypeMeaning
support*"supported" | "unsupported" | "unknown"An absent mode is unknown. Only an explicit negative means unsupported.
min_tokens*number | nullMinimum prompt size in tokens. Null = unknown.
max_breakpoints*number | nullMaximum cache markers. Null = unknown or not applicable to this mode.
targets*string[] | nullParts of the request that can be cached. Null = unknown or not applicable.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "support": {
      "type": "string",
      "enum": [
        "supported",
        "unsupported",
        "unknown"
      ],
      "description": "An absent mode is unknown. Only an explicit negative means unsupported."
    },
    "min_tokens": {
      "description": "Minimum prompt size in tokens. Null = unknown.",
      "type": [
        "number",
        "null"
      ]
    },
    "max_breakpoints": {
      "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
      "type": [
        "number",
        "null"
      ]
    },
    "targets": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "Parts of the request that can be cached. Null = unknown or not applicable."
    }
  },
  "required": [
    "support",
    "min_tokens",
    "max_breakpoints",
    "targets"
  ],
  "additionalProperties": false
}

CacheRetention

Confirmed retention controls. Observed cache behavior and requested settings are published separately in evaluations.

Field (* required)TypeMeaning
support*"supported" | "unsupported" | "unknown"Whether a request parameter controls retention, confirmed by explicit evidence. A sent parameter or a cache hit alone leaves this unknown.
parameter*object | nullThe confirmed request field and its location. Null = unknown.
accepted_values*string[] | nullValues explicitly confirmed by the evidence. Requested values alone are not accepted values. Null = unknown.
default*string | nullThe lifetime when the parameter is omitted. Null = unknown.
profiles*object[]Confirmed short and long settings. A null value means omit the parameter. Empty = unknown.
conditions*string[]Restrictions by client, protocol or header.
evidence*object[]Evidence for parameter support, values and conditions.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "support": {
      "type": "string",
      "enum": [
        "supported",
        "unsupported",
        "unknown"
      ],
      "description": "Whether a request parameter controls retention, confirmed by explicit evidence. A sent parameter or a cache hit alone leaves this unknown."
    },
    "parameter": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "minLength": 1
            },
            "location": {
              "type": "string",
              "minLength": 1
            }
          },
          "required": [
            "name",
            "location"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "The confirmed request field and its location. Null = unknown."
    },
    "accepted_values": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "Values explicitly confirmed by the evidence. Requested values alone are not accepted values. Null = unknown."
    },
    "default": {
      "description": "The lifetime when the parameter is omitted. Null = unknown.",
      "type": [
        "string",
        "null"
      ]
    },
    "profiles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "profile": {
            "type": "string",
            "enum": [
              "short",
              "long"
            ],
            "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
          },
          "value": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "profile",
          "value"
        ],
        "additionalProperties": false
      },
      "description": "Confirmed short and long settings. A null value means omit the parameter. Empty = unknown."
    },
    "conditions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Restrictions by client, protocol or header."
    },
    "evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "documented",
              "measured"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "date": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "kind",
          "url",
          "date",
          "note"
        ],
        "additionalProperties": false
      },
      "description": "Evidence for parameter support, values and conditions."
    }
  },
  "required": [
    "support",
    "parameter",
    "accepted_values",
    "default",
    "profiles",
    "conditions",
    "evidence"
  ],
  "additionalProperties": false,
  "description": "Confirmed retention controls. Observed cache behavior and requested settings are published separately in evaluations."
}

CacheLifetime

Every cache lifetime of an entry in one list, and the safe value of each retention profile. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee.

Field (* required)TypeMeaning
short*objectThe short profile: no lifetime asked for, or the shortest documented one.
long*objectThe long profile: a longer lifetime asked for.
lifetimes*object[]Every lifetime known for the entry: short, then long; in each, the documented items by seconds, implicit before explicit, then by text; then the measured ones, the setting that asked for no lifetime first, then by seconds and value, then by client, then by parameter. Text is compared in plain character order. Empty = none is known.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "short": {
      "type": "object",
      "properties": {
        "safe_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
        },
        "basis": {
          "type": "string",
          "enum": [
            "measured",
            "documented",
            "none"
          ],
          "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
        },
        "source": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "providers.dev",
                "models.dev"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
        },
        "date": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            {
              "type": "null"
            }
          ],
          "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
        },
        "documented_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
        },
        "measured_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
        },
        "documented_status": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "contradicted",
                "not_contradicted"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
        },
        "clients": {
          "type": "integer",
          "minimum": 0,
          "description": "How many clients were measured. 0 = not measured."
        },
        "evaluations": {
          "type": "integer",
          "minimum": 0,
          "description": "How many evaluations were counted. 0 = not measured."
        },
        "checks": {
          "type": "integer",
          "minimum": 0,
          "description": "Re-sends made in them, the control included."
        },
        "hits": {
          "type": "integer",
          "minimum": 0,
          "description": "How many of those were served from the cache."
        },
        "checks_inside": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
        },
        "hits_inside": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "How many of checks_inside were served from the cache. Null with checks_inside."
        },
        "tested_from_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
        },
        "first_miss_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
        }
      },
      "required": [
        "safe_s",
        "basis",
        "source",
        "date",
        "documented_s",
        "measured_s",
        "documented_status",
        "clients",
        "evaluations",
        "checks",
        "hits",
        "checks_inside",
        "hits_inside",
        "tested_from_s",
        "first_miss_s"
      ],
      "additionalProperties": false,
      "description": "The short profile: no lifetime asked for, or the shortest documented one."
    },
    "long": {
      "type": "object",
      "properties": {
        "safe_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
        },
        "basis": {
          "type": "string",
          "enum": [
            "measured",
            "documented",
            "none"
          ],
          "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
        },
        "source": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "providers.dev",
                "models.dev"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
        },
        "date": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            {
              "type": "null"
            }
          ],
          "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
        },
        "documented_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
        },
        "measured_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
        },
        "documented_status": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "contradicted",
                "not_contradicted"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
        },
        "clients": {
          "type": "integer",
          "minimum": 0,
          "description": "How many clients were measured. 0 = not measured."
        },
        "evaluations": {
          "type": "integer",
          "minimum": 0,
          "description": "How many evaluations were counted. 0 = not measured."
        },
        "checks": {
          "type": "integer",
          "minimum": 0,
          "description": "Re-sends made in them, the control included."
        },
        "hits": {
          "type": "integer",
          "minimum": 0,
          "description": "How many of those were served from the cache."
        },
        "checks_inside": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
        },
        "hits_inside": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "How many of checks_inside were served from the cache. Null with checks_inside."
        },
        "tested_from_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
        },
        "first_miss_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
        }
      },
      "required": [
        "safe_s",
        "basis",
        "source",
        "date",
        "documented_s",
        "measured_s",
        "documented_status",
        "clients",
        "evaluations",
        "checks",
        "hits",
        "checks_inside",
        "hits_inside",
        "tested_from_s",
        "first_miss_s"
      ],
      "additionalProperties": false,
      "description": "The long profile: a longer lifetime asked for."
    },
    "lifetimes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "retention_profile": {
            "type": "string",
            "enum": [
              "short",
              "long"
            ],
            "description": "Documented: short for the shortest lifetime the entry documents, long for every other. Measured: the profile of its evaluations."
          },
          "basis": {
            "type": "string",
            "enum": [
              "measured",
              "documented"
            ],
            "description": "documented = a lifetime the source documents. measured = what the evaluations of one client with one retention setting showed. Says which of the keys below apply."
          },
          "source": {
            "type": "string",
            "enum": [
              "providers.dev",
              "models.dev"
            ],
            "description": "Documented: models.dev, or providers.dev where the lifetime is a providers.dev correction or the entry is one providers.dev added. Measured: always providers.dev."
          },
          "date": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              {
                "type": "null"
              }
            ],
            "description": "Documented: the import date for models.dev, the newest evidence date for providers.dev. Measured: the newest of its evaluations. Null = the source has no date."
          },
          "lifetime_s": {
            "type": "integer",
            "minimum": 0,
            "description": "Documented: the lifetime in whole seconds; 0 only on the item that says the entry does not cache. A documented text that is not a whole number of seconds above 0 is no item. Measured: the oldest tested age through which every check of every one of its evaluations hit; 0 = no such age."
          },
          "mode": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "implicit",
                  "explicit"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Documented: the way of caching the lifetime is documented for. Null on the item that says the entry does not cache, and on a measured item."
          },
          "documented_as": {
            "description": "Documented: the lifetime as the source writes it, for example 5m. Null on the item that says the entry does not cache, and on a measured item.",
            "type": [
              "string",
              "null"
            ]
          },
          "client": {
            "description": "Measured: the public id of the client the requests went through, as on the evaluations. Null on a documented item.",
            "type": [
              "string",
              "null"
            ]
          },
          "client_label": {
            "description": "Measured: its public label. Null on a documented item.",
            "type": [
              "string",
              "null"
            ]
          },
          "parameter": {
            "description": "Measured: the request field that asked for the lifetime, as on the evaluations. Null = no lifetime was asked for, and on a documented item.",
            "type": [
              "string",
              "null"
            ]
          },
          "value": {
            "description": "Measured: the value sent in it. Null together with parameter.",
            "type": [
              "string",
              "null"
            ]
          },
          "evaluations": {
            "type": "integer",
            "minimum": 0,
            "description": "Measured: how many evaluations the item is made from, at least 1. 0 on a documented item."
          },
          "evaluation_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Measured: their ids, sorted, as in the entry's evaluations and in /api/v1/evaluations/cache. Empty on a documented item."
          },
          "checks": {
            "type": "integer",
            "minimum": 0,
            "description": "Measured: re-sends made in them, the control included. 0 on a documented item."
          },
          "hits": {
            "type": "integer",
            "minimum": 0,
            "description": "Measured: how many of those were served from the cache. 0 on a documented item."
          },
          "tested_from_s": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "description": "Measured: the youngest timed age any of them checked; no younger age was checked. Null = none made a timed check, and on a documented item."
          },
          "first_miss_s": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "description": "Measured: the youngest age at which any of them had a check that missed; 0 = the immediate re-send. Null = no miss, and on a documented item."
          },
          "results": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "control",
                        "timed"
                      ],
                      "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                    },
                    "age_s": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                    },
                    "hits": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Re-sends served from the cache."
                    },
                    "checks": {
                      "type": "integer",
                      "minimum": 1,
                      "description": "Re-sends made. An age nobody checked has no result at all."
                    },
                    "hit_rate_pct": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 100,
                      "description": "hits / checks, in percent, two decimals."
                    }
                  },
                  "required": [
                    "kind",
                    "age_s",
                    "hits",
                    "checks",
                    "hit_rate_pct"
                  ],
                  "additionalProperties": false,
                  "description": "What was seen at one age."
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Measured: the results of its evaluations added up by exact age, the control first. lifetime_s is read from each evaluation on its own and the lowest taken, so on an item of several evaluations it can be below what these sums show. Null on a documented item."
          }
        },
        "required": [
          "retention_profile",
          "basis",
          "source",
          "date",
          "lifetime_s",
          "mode",
          "documented_as",
          "client",
          "client_label",
          "parameter",
          "value",
          "evaluations",
          "evaluation_ids",
          "checks",
          "hits",
          "tested_from_s",
          "first_miss_s",
          "results"
        ],
        "additionalProperties": false,
        "description": "One lifetime of an entry: documented by a source, or measured for one client with one retention setting. One shape for both; the keys of the other kind are null, 0 or empty."
      },
      "description": "Every lifetime known for the entry: short, then long; in each, the documented items by seconds, implicit before explicit, then by text; then the measured ones, the setting that asked for no lifetime first, then by seconds and value, then by client, then by parameter. Text is compared in plain character order. Empty = none is known."
    }
  },
  "required": [
    "short",
    "long",
    "lifetimes"
  ],
  "additionalProperties": false,
  "description": "Every cache lifetime of an entry in one list, and the safe value of each retention profile. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee."
}

SafeLifetime

The safe lifetime of an entry for one retention profile, with the documented and the measured lifetime it was chosen from and what was measured.

Field (* required)TypeMeaning
safe_s*integer | nullSeconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known.
basis*"measured" | "documented" | "none"documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null.
source*"providers.dev" | "models.dev" | nullWho the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none.
date*string | nullmeasured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date.
documented_s*integer | nullThe documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented.
measured_s*integer | nullThe measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured.
documented_status*"contradicted" | "not_contradicted" | nullWhat the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it).
clients*integerHow many clients were measured. 0 = not measured.
evaluations*integerHow many evaluations were counted. 0 = not measured.
checks*integerRe-sends made in them, the control included.
hits*integerHow many of those were served from the cache.
checks_inside*integer | nullOf checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured.
hits_inside*integer | nullHow many of checks_inside were served from the cache. Null with checks_inside.
tested_from_s*integer | nullThe youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made.
first_miss_s*integer | nullThe youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "safe_s": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
    },
    "basis": {
      "type": "string",
      "enum": [
        "measured",
        "documented",
        "none"
      ],
      "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
    },
    "source": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "providers.dev",
            "models.dev"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
    },
    "date": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
    },
    "documented_s": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
    },
    "measured_s": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
    },
    "documented_status": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "contradicted",
            "not_contradicted"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
    },
    "clients": {
      "type": "integer",
      "minimum": 0,
      "description": "How many clients were measured. 0 = not measured."
    },
    "evaluations": {
      "type": "integer",
      "minimum": 0,
      "description": "How many evaluations were counted. 0 = not measured."
    },
    "checks": {
      "type": "integer",
      "minimum": 0,
      "description": "Re-sends made in them, the control included."
    },
    "hits": {
      "type": "integer",
      "minimum": 0,
      "description": "How many of those were served from the cache."
    },
    "checks_inside": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
    },
    "hits_inside": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "How many of checks_inside were served from the cache. Null with checks_inside."
    },
    "tested_from_s": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
    },
    "first_miss_s": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
    }
  },
  "required": [
    "safe_s",
    "basis",
    "source",
    "date",
    "documented_s",
    "measured_s",
    "documented_status",
    "clients",
    "evaluations",
    "checks",
    "hits",
    "checks_inside",
    "hits_inside",
    "tested_from_s",
    "first_miss_s"
  ],
  "additionalProperties": false,
  "description": "The safe lifetime of an entry for one retention profile, with the documented and the measured lifetime it was chosen from and what was measured."
}

CacheLifetimeItem

One lifetime of an entry: documented by a source, or measured for one client with one retention setting. One shape for both; the keys of the other kind are null, 0 or empty.

Field (* required)TypeMeaning
retention_profile*"short" | "long"Documented: short for the shortest lifetime the entry documents, long for every other. Measured: the profile of its evaluations.
basis*"measured" | "documented"documented = a lifetime the source documents. measured = what the evaluations of one client with one retention setting showed. Says which of the keys below apply.
source*"providers.dev" | "models.dev"Documented: models.dev, or providers.dev where the lifetime is a providers.dev correction or the entry is one providers.dev added. Measured: always providers.dev.
date*string | nullDocumented: the import date for models.dev, the newest evidence date for providers.dev. Measured: the newest of its evaluations. Null = the source has no date.
lifetime_s*integerDocumented: the lifetime in whole seconds; 0 only on the item that says the entry does not cache. A documented text that is not a whole number of seconds above 0 is no item. Measured: the oldest tested age through which every check of every one of its evaluations hit; 0 = no such age.
mode*"implicit" | "explicit" | nullDocumented: the way of caching the lifetime is documented for. Null on the item that says the entry does not cache, and on a measured item.
documented_as*string | nullDocumented: the lifetime as the source writes it, for example 5m. Null on the item that says the entry does not cache, and on a measured item.
client*string | nullMeasured: the public id of the client the requests went through, as on the evaluations. Null on a documented item.
client_label*string | nullMeasured: its public label. Null on a documented item.
parameter*string | nullMeasured: the request field that asked for the lifetime, as on the evaluations. Null = no lifetime was asked for, and on a documented item.
value*string | nullMeasured: the value sent in it. Null together with parameter.
evaluations*integerMeasured: how many evaluations the item is made from, at least 1. 0 on a documented item.
evaluation_ids*string[]Measured: their ids, sorted, as in the entry's evaluations and in /api/v1/evaluations/cache. Empty on a documented item.
checks*integerMeasured: re-sends made in them, the control included. 0 on a documented item.
hits*integerMeasured: how many of those were served from the cache. 0 on a documented item.
tested_from_s*integer | nullMeasured: the youngest timed age any of them checked; no younger age was checked. Null = none made a timed check, and on a documented item.
first_miss_s*integer | nullMeasured: the youngest age at which any of them had a check that missed; 0 = the immediate re-send. Null = no miss, and on a documented item.
results*object[] | nullMeasured: the results of its evaluations added up by exact age, the control first. lifetime_s is read from each evaluation on its own and the lowest taken, so on an item of several evaluations it can be below what these sums show. Null on a documented item.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "retention_profile": {
      "type": "string",
      "enum": [
        "short",
        "long"
      ],
      "description": "Documented: short for the shortest lifetime the entry documents, long for every other. Measured: the profile of its evaluations."
    },
    "basis": {
      "type": "string",
      "enum": [
        "measured",
        "documented"
      ],
      "description": "documented = a lifetime the source documents. measured = what the evaluations of one client with one retention setting showed. Says which of the keys below apply."
    },
    "source": {
      "type": "string",
      "enum": [
        "providers.dev",
        "models.dev"
      ],
      "description": "Documented: models.dev, or providers.dev where the lifetime is a providers.dev correction or the entry is one providers.dev added. Measured: always providers.dev."
    },
    "date": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "Documented: the import date for models.dev, the newest evidence date for providers.dev. Measured: the newest of its evaluations. Null = the source has no date."
    },
    "lifetime_s": {
      "type": "integer",
      "minimum": 0,
      "description": "Documented: the lifetime in whole seconds; 0 only on the item that says the entry does not cache. A documented text that is not a whole number of seconds above 0 is no item. Measured: the oldest tested age through which every check of every one of its evaluations hit; 0 = no such age."
    },
    "mode": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "implicit",
            "explicit"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Documented: the way of caching the lifetime is documented for. Null on the item that says the entry does not cache, and on a measured item."
    },
    "documented_as": {
      "description": "Documented: the lifetime as the source writes it, for example 5m. Null on the item that says the entry does not cache, and on a measured item.",
      "type": [
        "string",
        "null"
      ]
    },
    "client": {
      "description": "Measured: the public id of the client the requests went through, as on the evaluations. Null on a documented item.",
      "type": [
        "string",
        "null"
      ]
    },
    "client_label": {
      "description": "Measured: its public label. Null on a documented item.",
      "type": [
        "string",
        "null"
      ]
    },
    "parameter": {
      "description": "Measured: the request field that asked for the lifetime, as on the evaluations. Null = no lifetime was asked for, and on a documented item.",
      "type": [
        "string",
        "null"
      ]
    },
    "value": {
      "description": "Measured: the value sent in it. Null together with parameter.",
      "type": [
        "string",
        "null"
      ]
    },
    "evaluations": {
      "type": "integer",
      "minimum": 0,
      "description": "Measured: how many evaluations the item is made from, at least 1. 0 on a documented item."
    },
    "evaluation_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Measured: their ids, sorted, as in the entry's evaluations and in /api/v1/evaluations/cache. Empty on a documented item."
    },
    "checks": {
      "type": "integer",
      "minimum": 0,
      "description": "Measured: re-sends made in them, the control included. 0 on a documented item."
    },
    "hits": {
      "type": "integer",
      "minimum": 0,
      "description": "Measured: how many of those were served from the cache. 0 on a documented item."
    },
    "tested_from_s": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Measured: the youngest timed age any of them checked; no younger age was checked. Null = none made a timed check, and on a documented item."
    },
    "first_miss_s": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Measured: the youngest age at which any of them had a check that missed; 0 = the immediate re-send. Null = no miss, and on a documented item."
    },
    "results": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "control",
                  "timed"
                ],
                "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
              },
              "age_s": {
                "type": "integer",
                "minimum": 0,
                "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
              },
              "hits": {
                "type": "integer",
                "minimum": 0,
                "description": "Re-sends served from the cache."
              },
              "checks": {
                "type": "integer",
                "minimum": 1,
                "description": "Re-sends made. An age nobody checked has no result at all."
              },
              "hit_rate_pct": {
                "type": "number",
                "minimum": 0,
                "maximum": 100,
                "description": "hits / checks, in percent, two decimals."
              }
            },
            "required": [
              "kind",
              "age_s",
              "hits",
              "checks",
              "hit_rate_pct"
            ],
            "additionalProperties": false,
            "description": "What was seen at one age."
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "Measured: the results of its evaluations added up by exact age, the control first. lifetime_s is read from each evaluation on its own and the lowest taken, so on an item of several evaluations it can be below what these sums show. Null on a documented item."
    }
  },
  "required": [
    "retention_profile",
    "basis",
    "source",
    "date",
    "lifetime_s",
    "mode",
    "documented_as",
    "client",
    "client_label",
    "parameter",
    "value",
    "evaluations",
    "evaluation_ids",
    "checks",
    "hits",
    "tested_from_s",
    "first_miss_s",
    "results"
  ],
  "additionalProperties": false,
  "description": "One lifetime of an entry: documented by a source, or measured for one client with one retention setting. One shape for both; the keys of the other kind are null, 0 or empty."
}

CacheResult

What was seen at one age.

Field (* required)TypeMeaning
kind*"control" | "timed"control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s.
age_s*integerSeconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600.
hits*integerRe-sends served from the cache.
checks*integerRe-sends made. An age nobody checked has no result at all.
hit_rate_pct*numberhits / checks, in percent, two decimals.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "control",
        "timed"
      ],
      "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
    },
    "age_s": {
      "type": "integer",
      "minimum": 0,
      "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
    },
    "hits": {
      "type": "integer",
      "minimum": 0,
      "description": "Re-sends served from the cache."
    },
    "checks": {
      "type": "integer",
      "minimum": 1,
      "description": "Re-sends made. An age nobody checked has no result at all."
    },
    "hit_rate_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "hits / checks, in percent, two decimals."
    }
  },
  "required": [
    "kind",
    "age_s",
    "hits",
    "checks",
    "hit_rate_pct"
  ],
  "additionalProperties": false,
  "description": "What was seen at one age."
}

CacheEvaluation

One cache evaluation: a fresh prompt cached once, then sent again at once and at set ages.

Field (* required)TypeMeaning
id*stringThe id of the evaluation in the results repository.
route*stringThe access method the requests went through.
route_label*string
client*stringWhat sent the requests: direct, cliproxyapi, a coding tool.
client_label*string
date*string
request_settings*objectWhat the requests were sent with, as recorded: format, reasoning effort, lifetime and so on.
retention_profile*"short" | "long"short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support.
parameter*string | nullThe request field that asked for the lifetime, for example cache_control.ttl, prompt_cache_retention or prompt_cache_options.ttl. Null = no lifetime was asked for.
value*string | nullThe value sent in it, for example 1h. Null together with parameter.
results*object[]One result per exact age, the control first.
late_excluded*integer | nullChecks left out because they ran too late for their age. Null = the evaluation does not record it.
note*string | nullNull = no note.
source*stringThe raw result.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The id of the evaluation in the results repository."
    },
    "route": {
      "type": "string",
      "description": "The access method the requests went through."
    },
    "route_label": {
      "type": "string"
    },
    "client": {
      "type": "string",
      "description": "What sent the requests: direct, cliproxyapi, a coding tool."
    },
    "client_label": {
      "type": "string"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "request_settings": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "$ref": "#/components/schemas/CacheEvaluation/$defs/__schema0"
      },
      "description": "What the requests were sent with, as recorded: format, reasoning effort, lifetime and so on."
    },
    "retention_profile": {
      "type": "string",
      "enum": [
        "short",
        "long"
      ],
      "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
    },
    "parameter": {
      "description": "The request field that asked for the lifetime, for example cache_control.ttl, prompt_cache_retention or prompt_cache_options.ttl. Null = no lifetime was asked for.",
      "type": [
        "string",
        "null"
      ]
    },
    "value": {
      "description": "The value sent in it, for example 1h. Null together with parameter.",
      "type": [
        "string",
        "null"
      ]
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "control",
              "timed"
            ],
            "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
          },
          "age_s": {
            "type": "integer",
            "minimum": 0,
            "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
          },
          "hits": {
            "type": "integer",
            "minimum": 0,
            "description": "Re-sends served from the cache."
          },
          "checks": {
            "type": "integer",
            "minimum": 1,
            "description": "Re-sends made. An age nobody checked has no result at all."
          },
          "hit_rate_pct": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "hits / checks, in percent, two decimals."
          }
        },
        "required": [
          "kind",
          "age_s",
          "hits",
          "checks",
          "hit_rate_pct"
        ],
        "additionalProperties": false,
        "description": "What was seen at one age."
      },
      "description": "One result per exact age, the control first."
    },
    "late_excluded": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Checks left out because they ran too late for their age. Null = the evaluation does not record it."
    },
    "note": {
      "description": "Null = no note.",
      "type": [
        "string",
        "null"
      ]
    },
    "source": {
      "type": "string",
      "format": "uri",
      "description": "The raw result."
    }
  },
  "required": [
    "id",
    "route",
    "route_label",
    "client",
    "client_label",
    "date",
    "request_settings",
    "retention_profile",
    "parameter",
    "value",
    "results",
    "late_excluded",
    "note",
    "source"
  ],
  "additionalProperties": false,
  "description": "One cache evaluation: a fresh prompt cached once, then sent again at once and at set ages.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CacheEvaluation/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/CacheEvaluation/$defs/__schema0"
          }
        }
      ]
    }
  }
}

Capabilities

Documented capabilities. Missing fields remain unknown.

Field (* required)TypeMeaning
cachefalse | objectFalse explicitly disables caching. Missing modes are unknown.
temperatureboolean
top_kboolean
top_pboolean
structured_outputboolean
prompt_cache_keyboolean
storeboolean
stream_usageboolean
system_updatesboolean
effort_updatesboolean
service_tierstring[]
toolsobject
reasoningobject
Full JSON Schema
{
  "type": "object",
  "properties": {
    "cache": {
      "anyOf": [
        {
          "type": "boolean",
          "const": false
        },
        {
          "type": "object",
          "properties": {
            "implicit": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "object",
                  "properties": {
                    "ttl": {
                      "description": "Documented lifetimes, such as 5m or 1h.",
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "min_tokens": {
                      "type": "number",
                      "minimum": 0
                    },
                    "max_breakpoints": {
                      "type": "number",
                      "minimum": 0
                    },
                    "targets": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": {}
                }
              ]
            },
            "explicit": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "object",
                  "properties": {
                    "ttl": {
                      "description": "Documented lifetimes, such as 5m or 1h.",
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "min_tokens": {
                      "type": "number",
                      "minimum": 0
                    },
                    "max_breakpoints": {
                      "type": "number",
                      "minimum": 0
                    },
                    "targets": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": {}
                }
              ]
            }
          },
          "additionalProperties": {}
        }
      ],
      "description": "False explicitly disables caching. Missing modes are unknown."
    },
    "temperature": {
      "type": "boolean"
    },
    "top_k": {
      "type": "boolean"
    },
    "top_p": {
      "type": "boolean"
    },
    "structured_output": {
      "type": "boolean"
    },
    "prompt_cache_key": {
      "type": "boolean"
    },
    "store": {
      "type": "boolean"
    },
    "stream_usage": {
      "type": "boolean"
    },
    "system_updates": {
      "type": "boolean"
    },
    "effort_updates": {
      "type": "boolean"
    },
    "service_tier": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "tools": {
      "type": "object",
      "properties": {
        "supported": {
          "type": "boolean"
        },
        "choice": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "freeform": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "strict": {
          "type": "boolean"
        },
        "updates": {
          "type": "boolean"
        }
      },
      "additionalProperties": {}
    },
    "reasoning": {
      "type": "object",
      "properties": {
        "supported": {
          "type": "boolean"
        },
        "toggle": {
          "type": "boolean"
        },
        "effort": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "budget": {
          "type": "object",
          "properties": {
            "min": {
              "type": "number"
            },
            "max": {
              "type": "number"
            }
          },
          "additionalProperties": {}
        },
        "default": {
          "type": "object",
          "properties": {
            "type": {
              "type": "string"
            },
            "value": {
              "type": [
                "boolean",
                "string",
                "number"
              ]
            }
          },
          "additionalProperties": {}
        }
      },
      "additionalProperties": {}
    }
  },
  "additionalProperties": {},
  "description": "Documented capabilities. Missing fields remain unknown."
}

DocumentedCache

False explicitly disables caching. Missing modes are unknown.

Field (* required)TypeMeaning
any.implicitboolean | object
any.explicitboolean | object
Full JSON Schema
{
  "anyOf": [
    {
      "type": "boolean",
      "const": false
    },
    {
      "type": "object",
      "properties": {
        "implicit": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "object",
              "properties": {
                "ttl": {
                  "description": "Documented lifetimes, such as 5m or 1h.",
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "min_tokens": {
                  "type": "number",
                  "minimum": 0
                },
                "max_breakpoints": {
                  "type": "number",
                  "minimum": 0
                },
                "targets": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "additionalProperties": {}
            }
          ]
        },
        "explicit": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "object",
              "properties": {
                "ttl": {
                  "description": "Documented lifetimes, such as 5m or 1h.",
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "min_tokens": {
                  "type": "number",
                  "minimum": 0
                },
                "max_breakpoints": {
                  "type": "number",
                  "minimum": 0
                },
                "targets": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "additionalProperties": {}
            }
          ]
        }
      },
      "additionalProperties": {}
    }
  ],
  "description": "False explicitly disables caching. Missing modes are unknown."
}

Cost

List prices and conditional changes. Other modalities and future price fields are passed through unchanged.

Field (* required)TypeMeaning
textobjectText prices in USD per million tokens unless a unit is specified. Missing is unknown; zero is a listed zero price.
multipliersobject[]
Full JSON Schema
{
  "type": "object",
  "properties": {
    "text": {
      "type": "object",
      "properties": {
        "input": {
          "type": "object",
          "properties": {
            "price": {
              "type": "number"
            },
            "cache": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "number"
                },
                "write": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "number"
                      }
                    }
                  ],
                  "description": "Cache write price, or prices keyed by lifetime."
                },
                "storage": {
                  "type": "number"
                },
                "explicit": {
                  "type": "object",
                  "properties": {
                    "read": {
                      "type": "number"
                    },
                    "write": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "number"
                          }
                        }
                      ],
                      "description": "Cache write price, or prices keyed by lifetime."
                    },
                    "storage": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": {}
                }
              },
              "additionalProperties": {}
            },
            "unit": {
              "description": "Alternative source unit. Absent means per million tokens.",
              "type": "string"
            },
            "overrides": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "when": {
                    "type": "object",
                    "properties": {
                      "context": {
                        "type": "object",
                        "properties": {
                          "gt": {
                            "type": "number"
                          },
                          "gte": {
                            "type": "number"
                          },
                          "lt": {
                            "type": "number"
                          },
                          "lte": {
                            "type": "number"
                          },
                          "equals": {
                            "type": "number"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "service_tier": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "region": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "date": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "utc_hours": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "utc_days": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "holiday": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "thinking": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "boolean"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "all": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/components/schemas/Cost/$defs/__schema0"
                          }
                        }
                      },
                      "any": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/components/schemas/Cost/$defs/__schema0"
                          }
                        }
                      },
                      "not": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/components/schemas/Cost/$defs/__schema0"
                        }
                      }
                    },
                    "additionalProperties": {},
                    "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
                  },
                  "price": {
                    "type": "number"
                  },
                  "cache": {
                    "type": "object",
                    "properties": {
                      "read": {
                        "type": "number"
                      },
                      "write": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "type": "number"
                            }
                          }
                        ],
                        "description": "Cache write price, or prices keyed by lifetime."
                      },
                      "storage": {
                        "type": "number"
                      },
                      "explicit": {
                        "type": "object",
                        "properties": {
                          "read": {
                            "type": "number"
                          },
                          "write": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string"
                                },
                                "additionalProperties": {
                                  "type": "number"
                                }
                              }
                            ],
                            "description": "Cache write price, or prices keyed by lifetime."
                          },
                          "storage": {
                            "type": "number"
                          }
                        },
                        "additionalProperties": {}
                      }
                    },
                    "additionalProperties": {}
                  }
                },
                "required": [
                  "when"
                ],
                "additionalProperties": {}
              }
            }
          },
          "additionalProperties": {}
        },
        "output": {
          "type": "object",
          "properties": {
            "price": {
              "type": "number"
            },
            "reasoning": {
              "type": "number"
            },
            "unit": {
              "type": "string"
            },
            "overrides": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "when": {
                    "type": "object",
                    "properties": {
                      "context": {
                        "type": "object",
                        "properties": {
                          "gt": {
                            "type": "number"
                          },
                          "gte": {
                            "type": "number"
                          },
                          "lt": {
                            "type": "number"
                          },
                          "lte": {
                            "type": "number"
                          },
                          "equals": {
                            "type": "number"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "service_tier": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "region": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "date": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "utc_hours": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "utc_days": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "holiday": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "string"
                          },
                          "in": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "gt": {
                            "type": "string"
                          },
                          "gte": {
                            "type": "string"
                          },
                          "lt": {
                            "type": "string"
                          },
                          "lte": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "thinking": {
                        "type": "object",
                        "properties": {
                          "equals": {
                            "type": "boolean"
                          }
                        },
                        "additionalProperties": {}
                      },
                      "all": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/components/schemas/Cost/$defs/__schema0"
                          }
                        }
                      },
                      "any": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/components/schemas/Cost/$defs/__schema0"
                          }
                        }
                      },
                      "not": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/components/schemas/Cost/$defs/__schema0"
                        }
                      }
                    },
                    "additionalProperties": {},
                    "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
                  },
                  "price": {
                    "type": "number"
                  },
                  "reasoning": {
                    "type": "number"
                  }
                },
                "required": [
                  "when"
                ],
                "additionalProperties": {}
              }
            }
          },
          "additionalProperties": {}
        }
      },
      "additionalProperties": {},
      "description": "Text prices in USD per million tokens unless a unit is specified. Missing is unknown; zero is a listed zero price."
    },
    "multipliers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "when": {
            "type": "object",
            "properties": {
              "context": {
                "type": "object",
                "properties": {
                  "gt": {
                    "type": "number"
                  },
                  "gte": {
                    "type": "number"
                  },
                  "lt": {
                    "type": "number"
                  },
                  "lte": {
                    "type": "number"
                  },
                  "equals": {
                    "type": "number"
                  }
                },
                "additionalProperties": {}
              },
              "service_tier": {
                "type": "object",
                "properties": {
                  "equals": {
                    "type": "string"
                  },
                  "in": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "gt": {
                    "type": "string"
                  },
                  "gte": {
                    "type": "string"
                  },
                  "lt": {
                    "type": "string"
                  },
                  "lte": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              },
              "region": {
                "type": "object",
                "properties": {
                  "equals": {
                    "type": "string"
                  },
                  "in": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "gt": {
                    "type": "string"
                  },
                  "gte": {
                    "type": "string"
                  },
                  "lt": {
                    "type": "string"
                  },
                  "lte": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              },
              "date": {
                "type": "object",
                "properties": {
                  "equals": {
                    "type": "string"
                  },
                  "in": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "gt": {
                    "type": "string"
                  },
                  "gte": {
                    "type": "string"
                  },
                  "lt": {
                    "type": "string"
                  },
                  "lte": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              },
              "utc_hours": {
                "type": "object",
                "properties": {
                  "equals": {
                    "type": "string"
                  },
                  "in": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "gt": {
                    "type": "string"
                  },
                  "gte": {
                    "type": "string"
                  },
                  "lt": {
                    "type": "string"
                  },
                  "lte": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              },
              "utc_days": {
                "type": "object",
                "properties": {
                  "equals": {
                    "type": "string"
                  },
                  "in": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "gt": {
                    "type": "string"
                  },
                  "gte": {
                    "type": "string"
                  },
                  "lt": {
                    "type": "string"
                  },
                  "lte": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              },
              "holiday": {
                "type": "object",
                "properties": {
                  "equals": {
                    "type": "string"
                  },
                  "in": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "gt": {
                    "type": "string"
                  },
                  "gte": {
                    "type": "string"
                  },
                  "lt": {
                    "type": "string"
                  },
                  "lte": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              },
              "thinking": {
                "type": "object",
                "properties": {
                  "equals": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": {}
              },
              "all": {
                "type": "array",
                "items": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "$ref": "#/components/schemas/Cost/$defs/__schema0"
                  }
                }
              },
              "any": {
                "type": "array",
                "items": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "$ref": "#/components/schemas/Cost/$defs/__schema0"
                  }
                }
              },
              "not": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "$ref": "#/components/schemas/Cost/$defs/__schema0"
                }
              }
            },
            "additionalProperties": {},
            "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
          },
          "factor": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "object",
                "properties": {
                  "text": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "object",
                        "properties": {
                          "input": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "price": {
                                    "type": "number"
                                  },
                                  "cache": {
                                    "type": "object",
                                    "properties": {
                                      "read": {
                                        "type": "number"
                                      },
                                      "write": {
                                        "anyOf": [
                                          {
                                            "type": "number"
                                          },
                                          {
                                            "type": "object",
                                            "propertyNames": {
                                              "type": "string"
                                            },
                                            "additionalProperties": {
                                              "type": "number"
                                            }
                                          }
                                        ],
                                        "description": "Cache write price, or prices keyed by lifetime."
                                      },
                                      "storage": {
                                        "type": "number"
                                      },
                                      "explicit": {
                                        "type": "object",
                                        "properties": {
                                          "read": {
                                            "type": "number"
                                          },
                                          "write": {
                                            "anyOf": [
                                              {
                                                "type": "number"
                                              },
                                              {
                                                "type": "object",
                                                "propertyNames": {
                                                  "type": "string"
                                                },
                                                "additionalProperties": {
                                                  "type": "number"
                                                }
                                              }
                                            ],
                                            "description": "Cache write price, or prices keyed by lifetime."
                                          },
                                          "storage": {
                                            "type": "number"
                                          }
                                        },
                                        "additionalProperties": {}
                                      }
                                    },
                                    "additionalProperties": {}
                                  }
                                },
                                "additionalProperties": {}
                              }
                            ]
                          },
                          "output": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "price": {
                                    "type": "number"
                                  },
                                  "reasoning": {
                                    "type": "number"
                                  }
                                },
                                "additionalProperties": {}
                              }
                            ]
                          }
                        },
                        "additionalProperties": {}
                      }
                    ]
                  }
                },
                "additionalProperties": {}
              }
            ]
          }
        },
        "required": [
          "when",
          "factor"
        ],
        "additionalProperties": {}
      }
    }
  },
  "additionalProperties": {},
  "description": "List prices and conditional changes. Other modalities and future price fields are passed through unchanged.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Cost/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Cost/$defs/__schema0"
          }
        }
      ]
    }
  }
}

TextPrice

Text prices in USD per million tokens unless a unit is specified. Missing is unknown; zero is a listed zero price.

Field (* required)TypeMeaning
inputobject
outputobject
Full JSON Schema
{
  "type": "object",
  "properties": {
    "input": {
      "type": "object",
      "properties": {
        "price": {
          "type": "number"
        },
        "cache": {
          "type": "object",
          "properties": {
            "read": {
              "type": "number"
            },
            "write": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": "number"
                  }
                }
              ],
              "description": "Cache write price, or prices keyed by lifetime."
            },
            "storage": {
              "type": "number"
            },
            "explicit": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "number"
                },
                "write": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "number"
                      }
                    }
                  ],
                  "description": "Cache write price, or prices keyed by lifetime."
                },
                "storage": {
                  "type": "number"
                }
              },
              "additionalProperties": {}
            }
          },
          "additionalProperties": {}
        },
        "unit": {
          "description": "Alternative source unit. Absent means per million tokens.",
          "type": "string"
        },
        "overrides": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "when": {
                "type": "object",
                "properties": {
                  "context": {
                    "type": "object",
                    "properties": {
                      "gt": {
                        "type": "number"
                      },
                      "gte": {
                        "type": "number"
                      },
                      "lt": {
                        "type": "number"
                      },
                      "lte": {
                        "type": "number"
                      },
                      "equals": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "service_tier": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "region": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "date": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "utc_hours": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "utc_days": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "holiday": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "thinking": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "all": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/components/schemas/TextPrice/$defs/__schema0"
                      }
                    }
                  },
                  "any": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/components/schemas/TextPrice/$defs/__schema0"
                      }
                    }
                  },
                  "not": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "$ref": "#/components/schemas/TextPrice/$defs/__schema0"
                    }
                  }
                },
                "additionalProperties": {},
                "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
              },
              "price": {
                "type": "number"
              },
              "cache": {
                "type": "object",
                "properties": {
                  "read": {
                    "type": "number"
                  },
                  "write": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "number"
                        }
                      }
                    ],
                    "description": "Cache write price, or prices keyed by lifetime."
                  },
                  "storage": {
                    "type": "number"
                  },
                  "explicit": {
                    "type": "object",
                    "properties": {
                      "read": {
                        "type": "number"
                      },
                      "write": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "type": "number"
                            }
                          }
                        ],
                        "description": "Cache write price, or prices keyed by lifetime."
                      },
                      "storage": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": {}
                  }
                },
                "additionalProperties": {}
              }
            },
            "required": [
              "when"
            ],
            "additionalProperties": {}
          }
        }
      },
      "additionalProperties": {}
    },
    "output": {
      "type": "object",
      "properties": {
        "price": {
          "type": "number"
        },
        "reasoning": {
          "type": "number"
        },
        "unit": {
          "type": "string"
        },
        "overrides": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "when": {
                "type": "object",
                "properties": {
                  "context": {
                    "type": "object",
                    "properties": {
                      "gt": {
                        "type": "number"
                      },
                      "gte": {
                        "type": "number"
                      },
                      "lt": {
                        "type": "number"
                      },
                      "lte": {
                        "type": "number"
                      },
                      "equals": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "service_tier": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "region": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "date": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "utc_hours": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "utc_days": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "holiday": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "string"
                      },
                      "in": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "gt": {
                        "type": "string"
                      },
                      "gte": {
                        "type": "string"
                      },
                      "lt": {
                        "type": "string"
                      },
                      "lte": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "thinking": {
                    "type": "object",
                    "properties": {
                      "equals": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "all": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/components/schemas/TextPrice/$defs/__schema0"
                      }
                    }
                  },
                  "any": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/components/schemas/TextPrice/$defs/__schema0"
                      }
                    }
                  },
                  "not": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "$ref": "#/components/schemas/TextPrice/$defs/__schema0"
                    }
                  }
                },
                "additionalProperties": {},
                "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
              },
              "price": {
                "type": "number"
              },
              "reasoning": {
                "type": "number"
              }
            },
            "required": [
              "when"
            ],
            "additionalProperties": {}
          }
        }
      },
      "additionalProperties": {}
    }
  },
  "additionalProperties": {},
  "description": "Text prices in USD per million tokens unless a unit is specified. Missing is unknown; zero is a listed zero price.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/TextPrice/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/TextPrice/$defs/__schema0"
          }
        }
      ]
    }
  }
}

CachePrice

Field (* required)TypeMeaning
readnumber
writenumber | objectCache write price, or prices keyed by lifetime.
storagenumber
explicitobject
Full JSON Schema
{
  "type": "object",
  "properties": {
    "read": {
      "type": "number"
    },
    "write": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "number"
          }
        }
      ],
      "description": "Cache write price, or prices keyed by lifetime."
    },
    "storage": {
      "type": "number"
    },
    "explicit": {
      "type": "object",
      "properties": {
        "read": {
          "type": "number"
        },
        "write": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "number"
              }
            }
          ],
          "description": "Cache write price, or prices keyed by lifetime."
        },
        "storage": {
          "type": "number"
        }
      },
      "additionalProperties": {}
    }
  },
  "additionalProperties": {}
}

PriceCondition

Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON.

Field (* required)TypeMeaning
contextobject
service_tierobject
regionobject
dateobject
utc_hoursobject
utc_daysobject
holidayobject
thinkingobject
allobject[]
anyobject[]
notobject
Full JSON Schema
{
  "type": "object",
  "properties": {
    "context": {
      "type": "object",
      "properties": {
        "gt": {
          "type": "number"
        },
        "gte": {
          "type": "number"
        },
        "lt": {
          "type": "number"
        },
        "lte": {
          "type": "number"
        },
        "equals": {
          "type": "number"
        }
      },
      "additionalProperties": {}
    },
    "service_tier": {
      "type": "object",
      "properties": {
        "equals": {
          "type": "string"
        },
        "in": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "gt": {
          "type": "string"
        },
        "gte": {
          "type": "string"
        },
        "lt": {
          "type": "string"
        },
        "lte": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "region": {
      "type": "object",
      "properties": {
        "equals": {
          "type": "string"
        },
        "in": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "gt": {
          "type": "string"
        },
        "gte": {
          "type": "string"
        },
        "lt": {
          "type": "string"
        },
        "lte": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "date": {
      "type": "object",
      "properties": {
        "equals": {
          "type": "string"
        },
        "in": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "gt": {
          "type": "string"
        },
        "gte": {
          "type": "string"
        },
        "lt": {
          "type": "string"
        },
        "lte": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "utc_hours": {
      "type": "object",
      "properties": {
        "equals": {
          "type": "string"
        },
        "in": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "gt": {
          "type": "string"
        },
        "gte": {
          "type": "string"
        },
        "lt": {
          "type": "string"
        },
        "lte": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "utc_days": {
      "type": "object",
      "properties": {
        "equals": {
          "type": "string"
        },
        "in": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "gt": {
          "type": "string"
        },
        "gte": {
          "type": "string"
        },
        "lt": {
          "type": "string"
        },
        "lte": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "holiday": {
      "type": "object",
      "properties": {
        "equals": {
          "type": "string"
        },
        "in": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "gt": {
          "type": "string"
        },
        "gte": {
          "type": "string"
        },
        "lt": {
          "type": "string"
        },
        "lte": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "thinking": {
      "type": "object",
      "properties": {
        "equals": {
          "type": "boolean"
        }
      },
      "additionalProperties": {}
    },
    "all": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {
          "$ref": "#/components/schemas/PriceCondition/$defs/__schema0"
        }
      }
    },
    "any": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {
          "$ref": "#/components/schemas/PriceCondition/$defs/__schema0"
        }
      }
    },
    "not": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "$ref": "#/components/schemas/PriceCondition/$defs/__schema0"
      }
    }
  },
  "additionalProperties": {},
  "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/PriceCondition/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/PriceCondition/$defs/__schema0"
          }
        }
      ]
    }
  }
}

ApiEndpoint

Field (* required)TypeMeaning
base_urlstring
pathstring
sdkobject
capabilitiesobjectDocumented capabilities. Missing fields remain unknown.
compatibilityobject
Full JSON Schema
{
  "type": "object",
  "properties": {
    "base_url": {
      "type": "string"
    },
    "path": {
      "type": "string"
    },
    "sdk": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "capabilities": {
      "type": "object",
      "properties": {
        "cache": {
          "anyOf": [
            {
              "type": "boolean",
              "const": false
            },
            {
              "type": "object",
              "properties": {
                "implicit": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "ttl": {
                          "description": "Documented lifetimes, such as 5m or 1h.",
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "min_tokens": {
                          "type": "number",
                          "minimum": 0
                        },
                        "max_breakpoints": {
                          "type": "number",
                          "minimum": 0
                        },
                        "targets": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "additionalProperties": {}
                    }
                  ]
                },
                "explicit": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "ttl": {
                          "description": "Documented lifetimes, such as 5m or 1h.",
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "min_tokens": {
                          "type": "number",
                          "minimum": 0
                        },
                        "max_breakpoints": {
                          "type": "number",
                          "minimum": 0
                        },
                        "targets": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "additionalProperties": {}
                    }
                  ]
                }
              },
              "additionalProperties": {}
            }
          ],
          "description": "False explicitly disables caching. Missing modes are unknown."
        },
        "temperature": {
          "type": "boolean"
        },
        "top_k": {
          "type": "boolean"
        },
        "top_p": {
          "type": "boolean"
        },
        "structured_output": {
          "type": "boolean"
        },
        "prompt_cache_key": {
          "type": "boolean"
        },
        "store": {
          "type": "boolean"
        },
        "stream_usage": {
          "type": "boolean"
        },
        "system_updates": {
          "type": "boolean"
        },
        "effort_updates": {
          "type": "boolean"
        },
        "service_tier": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "tools": {
          "type": "object",
          "properties": {
            "supported": {
              "type": "boolean"
            },
            "choice": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "freeform": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "strict": {
              "type": "boolean"
            },
            "updates": {
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        },
        "reasoning": {
          "type": "object",
          "properties": {
            "supported": {
              "type": "boolean"
            },
            "toggle": {
              "type": "boolean"
            },
            "effort": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "budget": {
              "type": "object",
              "properties": {
                "min": {
                  "type": "number"
                },
                "max": {
                  "type": "number"
                }
              },
              "additionalProperties": {}
            },
            "default": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string"
                },
                "value": {
                  "type": [
                    "boolean",
                    "string",
                    "number"
                  ]
                }
              },
              "additionalProperties": {}
            }
          },
          "additionalProperties": {}
        }
      },
      "additionalProperties": {},
      "description": "Documented capabilities. Missing fields remain unknown."
    },
    "compatibility": {
      "type": "object",
      "properties": {
        "max_tokens_field": {
          "type": "string"
        },
        "reasoning_field": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    }
  },
  "additionalProperties": {}
}

Condition

Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.

Field (* required)TypeMeaning
"predicate".kind*"predicate"
"predicate".field*string
"predicate".op*"eq" | "in" | "gt" | "gte" | "lt" | "lte" | "min_items"
"predicate".value*__schema0
"all" | "any".kind*"all" | "any"
"all" | "any".conditions*Condition[]
"not".kind*"not"
"not".condition*Condition
"unknown".kind*"unknown"
"unknown".raw*__schema1
Full JSON Schema
{
  "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "const": "predicate"
        },
        "field": {
          "type": "string",
          "minLength": 1
        },
        "op": {
          "type": "string",
          "enum": [
            "eq",
            "in",
            "gt",
            "gte",
            "lt",
            "lte",
            "min_items"
          ]
        },
        "value": {
          "$ref": "#/components/schemas/Condition/$defs/__schema0"
        }
      },
      "required": [
        "kind",
        "field",
        "op",
        "value"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "all",
            "any"
          ]
        },
        "conditions": {
          "minItems": 1,
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Condition"
          }
        }
      },
      "required": [
        "kind",
        "conditions"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "const": "not"
        },
        "condition": {
          "$ref": "#/components/schemas/Condition"
        }
      },
      "required": [
        "kind",
        "condition"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "const": "unknown"
        },
        "raw": {
          "$ref": "#/components/schemas/Condition/$defs/__schema1"
        }
      },
      "required": [
        "kind",
        "raw"
      ],
      "additionalProperties": false
    }
  ],
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Condition/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Condition/$defs/__schema0"
          }
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Condition/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Condition/$defs/__schema1"
          }
        }
      ]
    }
  }
}

PolicyEvidence

Field (* required)TypeMeaning
kind*"documented" | "measured"
url*string
date*string | null
note*string
Full JSON Schema
{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "documented",
        "measured"
      ]
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "date": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "kind",
    "url",
    "date",
    "note"
  ],
  "additionalProperties": false
}

BillingUnit

Field (* required)TypeMeaning
name*stringFor example token, character, request, second or token_hour.
quantity*number | nullAmount is charged per this many units. Null = the source does not establish the scale.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "For example token, character, request, second or token_hour."
    },
    "quantity": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Amount is charged per this many units. Null = the source does not establish the scale."
    }
  },
  "required": [
    "name",
    "quantity"
  ],
  "additionalProperties": false
}

PricingRule

Field (* required)TypeMeaning
id*string
when*__schema0 | nullNull = unconditional base rule. A condition with kind=unknown remains unresolved.
meter*stringThe charge affected. For text: text.input, text.output, text.reasoning_output, text.cache_read, text.cache_write, text.cache_storage. The same charges exist for audio, image and video (audio.input, image.output, video.output and so on), each priced in its own unit. web_search is the charge for web searches. A multiply rule names one charge or a scope: text.* is every text charge, audio.* every audio charge, * every charge.
operation*"set" | "multiply"
amount*numberA price for set, or a factor for multiply. Zero is a known zero, never missing.
currency*string | nullISO currency for a price; null for multipliers or an unknown currency.
unit*object | nullBilling unit and scale. Null for multipliers or an unknown unit.
applies_to*"all_usage" | "above_threshold" | nullall_usage = the rate holds for the whole request that matches the condition. above_threshold = only for the part above a size threshold. Imported rules are all_usage: models.dev evaluates a condition per request, and a matching rule prices that request. Null = not established; never infer marginal billing.
source_path*string | nullField in the original cost record. Null for a separately authored rule.
period*"peak" | "off_peak" | nullSet on a rule whose condition reads the time of day or the day of the week (request.utc_hours, request.utc_days): peak = the rule raises the base rate in its window, off_peak = it lowers it. The base rate is the price outside the window. Null = not a time rule, or one that leaves the base rate as it is.
resulting_rates*object[] | nullOn a multiply rule: each unconditional base rate in its scope times the factor, which is the price when this rule applies and no other conditional rule does. Null on a set rule, whose amount is the rate itself, and on a multiply rule with no base rate in its scope.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "when": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/PricingRule/$defs/__schema0"
        },
        {
          "type": "null"
        }
      ],
      "description": "Null = unconditional base rule. A condition with kind=unknown remains unresolved."
    },
    "meter": {
      "type": "string",
      "minLength": 1,
      "description": "The charge affected. For text: text.input, text.output, text.reasoning_output, text.cache_read, text.cache_write, text.cache_storage. The same charges exist for audio, image and video (audio.input, image.output, video.output and so on), each priced in its own unit. web_search is the charge for web searches. A multiply rule names one charge or a scope: text.* is every text charge, audio.* every audio charge, * every charge."
    },
    "operation": {
      "type": "string",
      "enum": [
        "set",
        "multiply"
      ]
    },
    "amount": {
      "type": "number",
      "minimum": 0,
      "description": "A price for set, or a factor for multiply. Zero is a known zero, never missing."
    },
    "currency": {
      "description": "ISO currency for a price; null for multipliers or an unknown currency.",
      "type": [
        "string",
        "null"
      ]
    },
    "unit": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "minLength": 1,
              "description": "For example token, character, request, second or token_hour."
            },
            "quantity": {
              "anyOf": [
                {
                  "type": "number",
                  "exclusiveMinimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "description": "Amount is charged per this many units. Null = the source does not establish the scale."
            }
          },
          "required": [
            "name",
            "quantity"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Billing unit and scale. Null for multipliers or an unknown unit."
    },
    "applies_to": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "all_usage",
            "above_threshold"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "all_usage = the rate holds for the whole request that matches the condition. above_threshold = only for the part above a size threshold. Imported rules are all_usage: models.dev evaluates a condition per request, and a matching rule prices that request. Null = not established; never infer marginal billing."
    },
    "source_path": {
      "description": "Field in the original cost record. Null for a separately authored rule.",
      "type": [
        "string",
        "null"
      ]
    },
    "period": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "peak",
            "off_peak"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Set on a rule whose condition reads the time of day or the day of the week (request.utc_hours, request.utc_days): peak = the rule raises the base rate in its window, off_peak = it lowers it. The base rate is the price outside the window. Null = not a time rule, or one that leaves the base rate as it is."
    },
    "resulting_rates": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "meter": {
                "type": "string",
                "minLength": 1
              },
              "amount": {
                "type": "number",
                "minimum": 0
              },
              "currency": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "unit": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "minLength": 1,
                        "description": "For example token, character, request, second or token_hour."
                      },
                      "quantity": {
                        "anyOf": [
                          {
                            "type": "number",
                            "exclusiveMinimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                      }
                    },
                    "required": [
                      "name",
                      "quantity"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "meter",
              "amount",
              "currency",
              "unit"
            ],
            "additionalProperties": false,
            "description": "A base rate after a multiplier."
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "On a multiply rule: each unconditional base rate in its scope times the factor, which is the price when this rule applies and no other conditional rule does. Null on a set rule, whose amount is the rate itself, and on a multiply rule with no base rate in its scope."
    }
  },
  "required": [
    "id",
    "when",
    "meter",
    "operation",
    "amount",
    "currency",
    "unit",
    "applies_to",
    "source_path",
    "period",
    "resulting_rates"
  ],
  "additionalProperties": false,
  "$defs": {
    "__schema0": {
      "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "predicate"
            },
            "field": {
              "type": "string",
              "minLength": 1
            },
            "op": {
              "type": "string",
              "enum": [
                "eq",
                "in",
                "gt",
                "gte",
                "lt",
                "lte",
                "min_items"
              ]
            },
            "value": {
              "$ref": "#/components/schemas/PricingRule/$defs/__schema1"
            }
          },
          "required": [
            "kind",
            "field",
            "op",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ]
            },
            "conditions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/PricingRule/$defs/__schema0"
              }
            }
          },
          "required": [
            "kind",
            "conditions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "not"
            },
            "condition": {
              "$ref": "#/components/schemas/PricingRule/$defs/__schema0"
            }
          },
          "required": [
            "kind",
            "condition"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "unknown"
            },
            "raw": {
              "$ref": "#/components/schemas/PricingRule/$defs/__schema2"
            }
          },
          "required": [
            "kind",
            "raw"
          ],
          "additionalProperties": false
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/PricingRule/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/PricingRule/$defs/__schema1"
          }
        }
      ]
    },
    "__schema2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/PricingRule/$defs/__schema2"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/PricingRule/$defs/__schema2"
          }
        }
      ]
    }
  }
}

Pricing

Normalized pricing present on every entry and summary. Source imports are partial unless completeness is explicitly confirmed. Unknown applicability, units or rule interactions must not silently resolve to a base price.

Field (* required)TypeMeaning
coverage*"unknown" | "partial" | "complete" | "not_applicable"unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence.
billing*"per_use" | "reference" | "not_applicable" | "unknown"per_use = the entry is billed at these rates. reference = a subscription entry: the rates are the API list prices of reference_ref, not the subscription's bill. not_applicable = a subscription entry with no API entry of the same model to refer to. unknown = rates are listed for the entry and what they bill is not established.
reference_ref*string | nullWith billing = reference: the API entry the rates are taken from. That is the entry a providers.dev entry inherits from, or the entry of the lab's own provider for the same canonical model. Otherwise null.
rules*object[] | nullBase prices, conditional replacements and multipliers. Null = unknown. [] proves no rules only with complete coverage.
rule_order*"listed" | nulllisted = process matching rules in array order per meter: set replaces the rate and multiply scales it. Imported rules are listed: base rates first, then models.dev's overrides in their order, then its multipliers, which is how models.dev defines a price. Null = combination precedence is unconfirmed; this record cannot produce an authoritative combined quote.
unparsed*object[]Source fields not normalized, retained without loss. Nonempty means coverage is partial.
evidence*object[]
Example (fictional)
{
  "coverage": "complete",
  "billing": "per_use",
  "reference_ref": null,
  "rules": [
    {
      "operation": "set",
      "currency": "USD",
      "unit": {
        "name": "token",
        "quantity": 1000000
      },
      "applies_to": "all_usage",
      "source_path": null,
      "id": "input",
      "meter": "text.input",
      "amount": 2,
      "when": null,
      "period": null,
      "resulting_rates": null
    },
    {
      "operation": "set",
      "currency": "USD",
      "unit": {
        "name": "token",
        "quantity": 1000000
      },
      "applies_to": "all_usage",
      "source_path": null,
      "id": "output",
      "meter": "text.output",
      "amount": 10,
      "when": null,
      "period": null,
      "resulting_rates": null
    },
    {
      "operation": "set",
      "currency": "USD",
      "unit": {
        "name": "token",
        "quantity": 1000000
      },
      "applies_to": "all_usage",
      "source_path": null,
      "id": "cache-read",
      "meter": "text.cache_read",
      "amount": 0.2,
      "when": null,
      "period": null,
      "resulting_rates": null
    },
    {
      "operation": "set",
      "currency": "USD",
      "unit": {
        "name": "token",
        "quantity": 1000000
      },
      "applies_to": "all_usage",
      "source_path": null,
      "id": "short-write",
      "meter": "text.cache_write",
      "amount": 2.5,
      "when": {
        "kind": "predicate",
        "field": "cache.retention_s",
        "op": "eq",
        "value": 300
      },
      "period": null,
      "resulting_rates": null
    },
    {
      "operation": "set",
      "currency": "USD",
      "unit": {
        "name": "token",
        "quantity": 1000000
      },
      "applies_to": "all_usage",
      "source_path": null,
      "id": "long-write",
      "meter": "text.cache_write",
      "amount": 4,
      "when": {
        "kind": "predicate",
        "field": "cache.retention_s",
        "op": "eq",
        "value": 3600
      },
      "period": null,
      "resulting_rates": null
    },
    {
      "id": "long-context",
      "meter": "text.*",
      "operation": "multiply",
      "amount": 2,
      "currency": null,
      "unit": null,
      "applies_to": "all_usage",
      "source_path": null,
      "when": {
        "kind": "predicate",
        "field": "request.input_tokens",
        "op": "gt",
        "value": 200000
      },
      "period": null,
      "resulting_rates": [
        {
          "meter": "text.input",
          "amount": 4,
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          }
        },
        {
          "meter": "text.output",
          "amount": 20,
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          }
        },
        {
          "meter": "text.cache_read",
          "amount": 0.4,
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          }
        }
      ]
    },
    {
      "id": "off-peak",
      "meter": "*",
      "operation": "multiply",
      "amount": 0.5,
      "currency": null,
      "unit": null,
      "applies_to": "all_usage",
      "source_path": null,
      "when": {
        "kind": "predicate",
        "field": "request.utc_hours",
        "op": "gte",
        "value": "16:00"
      },
      "period": "off_peak",
      "resulting_rates": [
        {
          "meter": "text.input",
          "amount": 1,
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          }
        },
        {
          "meter": "text.output",
          "amount": 5,
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          }
        },
        {
          "meter": "text.cache_read",
          "amount": 0.1,
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          }
        }
      ]
    }
  ],
  "rule_order": "listed",
  "unparsed": [],
  "evidence": [
    {
      "kind": "documented",
      "url": "https://example.com/pricing",
      "date": "2026-11-14",
      "note": "Illustrative contract example; not actual provider pricing or settings."
    }
  ]
}
Full JSON Schema
{
  "type": "object",
  "properties": {
    "coverage": {
      "type": "string",
      "enum": [
        "unknown",
        "partial",
        "complete",
        "not_applicable"
      ],
      "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
    },
    "billing": {
      "type": "string",
      "enum": [
        "per_use",
        "reference",
        "not_applicable",
        "unknown"
      ],
      "description": "per_use = the entry is billed at these rates. reference = a subscription entry: the rates are the API list prices of reference_ref, not the subscription's bill. not_applicable = a subscription entry with no API entry of the same model to refer to. unknown = rates are listed for the entry and what they bill is not established."
    },
    "reference_ref": {
      "description": "With billing = reference: the API entry the rates are taken from. That is the entry a providers.dev entry inherits from, or the entry of the lab's own provider for the same canonical model. Otherwise null.",
      "type": [
        "string",
        "null"
      ]
    },
    "rules": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1
              },
              "when": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/Pricing/$defs/__schema0"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Null = unconditional base rule. A condition with kind=unknown remains unresolved."
              },
              "meter": {
                "type": "string",
                "minLength": 1,
                "description": "The charge affected. For text: text.input, text.output, text.reasoning_output, text.cache_read, text.cache_write, text.cache_storage. The same charges exist for audio, image and video (audio.input, image.output, video.output and so on), each priced in its own unit. web_search is the charge for web searches. A multiply rule names one charge or a scope: text.* is every text charge, audio.* every audio charge, * every charge."
              },
              "operation": {
                "type": "string",
                "enum": [
                  "set",
                  "multiply"
                ]
              },
              "amount": {
                "type": "number",
                "minimum": 0,
                "description": "A price for set, or a factor for multiply. Zero is a known zero, never missing."
              },
              "currency": {
                "description": "ISO currency for a price; null for multipliers or an unknown currency.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "unit": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "minLength": 1,
                        "description": "For example token, character, request, second or token_hour."
                      },
                      "quantity": {
                        "anyOf": [
                          {
                            "type": "number",
                            "exclusiveMinimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                      }
                    },
                    "required": [
                      "name",
                      "quantity"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Billing unit and scale. Null for multipliers or an unknown unit."
              },
              "applies_to": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "all_usage",
                      "above_threshold"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "all_usage = the rate holds for the whole request that matches the condition. above_threshold = only for the part above a size threshold. Imported rules are all_usage: models.dev evaluates a condition per request, and a matching rule prices that request. Null = not established; never infer marginal billing."
              },
              "source_path": {
                "description": "Field in the original cost record. Null for a separately authored rule.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "period": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "peak",
                      "off_peak"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Set on a rule whose condition reads the time of day or the day of the week (request.utc_hours, request.utc_days): peak = the rule raises the base rate in its window, off_peak = it lowers it. The base rate is the price outside the window. Null = not a time rule, or one that leaves the base rate as it is."
              },
              "resulting_rates": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "meter": {
                          "type": "string",
                          "minLength": 1
                        },
                        "amount": {
                          "type": "number",
                          "minimum": 0
                        },
                        "currency": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "unit": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "For example token, character, request, second or token_hour."
                                },
                                "quantity": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "exclusiveMinimum": 0
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                                }
                              },
                              "required": [
                                "name",
                                "quantity"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "meter",
                        "amount",
                        "currency",
                        "unit"
                      ],
                      "additionalProperties": false,
                      "description": "A base rate after a multiplier."
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "On a multiply rule: each unconditional base rate in its scope times the factor, which is the price when this rule applies and no other conditional rule does. Null on a set rule, whose amount is the rate itself, and on a multiply rule with no base rate in its scope."
              }
            },
            "required": [
              "id",
              "when",
              "meter",
              "operation",
              "amount",
              "currency",
              "unit",
              "applies_to",
              "source_path",
              "period",
              "resulting_rates"
            ],
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "Base prices, conditional replacements and multipliers. Null = unknown. [] proves no rules only with complete coverage."
    },
    "rule_order": {
      "anyOf": [
        {
          "type": "string",
          "const": "listed"
        },
        {
          "type": "null"
        }
      ],
      "description": "listed = process matching rules in array order per meter: set replaces the rate and multiply scales it. Imported rules are listed: base rates first, then models.dev's overrides in their order, then its multipliers, which is how models.dev defines a price. Null = combination precedence is unconfirmed; this record cannot produce an authoritative combined quote."
    },
    "unparsed": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string"
          },
          "value": {
            "$ref": "#/components/schemas/Pricing/$defs/__schema3"
          }
        },
        "required": [
          "path",
          "value"
        ],
        "additionalProperties": false
      },
      "description": "Source fields not normalized, retained without loss. Nonempty means coverage is partial."
    },
    "evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "documented",
              "measured"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "date": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "kind",
          "url",
          "date",
          "note"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "coverage",
    "billing",
    "reference_ref",
    "rules",
    "rule_order",
    "unparsed",
    "evidence"
  ],
  "additionalProperties": false,
  "description": "Normalized pricing present on every entry and summary. Source imports are partial unless completeness is explicitly confirmed. Unknown applicability, units or rule interactions must not silently resolve to a base price.",
  "$defs": {
    "__schema0": {
      "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "predicate"
            },
            "field": {
              "type": "string",
              "minLength": 1
            },
            "op": {
              "type": "string",
              "enum": [
                "eq",
                "in",
                "gt",
                "gte",
                "lt",
                "lte",
                "min_items"
              ]
            },
            "value": {
              "$ref": "#/components/schemas/Pricing/$defs/__schema1"
            }
          },
          "required": [
            "kind",
            "field",
            "op",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ]
            },
            "conditions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/Pricing/$defs/__schema0"
              }
            }
          },
          "required": [
            "kind",
            "conditions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "not"
            },
            "condition": {
              "$ref": "#/components/schemas/Pricing/$defs/__schema0"
            }
          },
          "required": [
            "kind",
            "condition"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "unknown"
            },
            "raw": {
              "$ref": "#/components/schemas/Pricing/$defs/__schema2"
            }
          },
          "required": [
            "kind",
            "raw"
          ],
          "additionalProperties": false
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Pricing/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Pricing/$defs/__schema1"
          }
        }
      ]
    },
    "__schema2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Pricing/$defs/__schema2"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Pricing/$defs/__schema2"
          }
        }
      ]
    },
    "__schema3": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Pricing/$defs/__schema3"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Pricing/$defs/__schema3"
          }
        }
      ]
    }
  },
  "examples": [
    {
      "coverage": "complete",
      "billing": "per_use",
      "reference_ref": null,
      "rules": [
        {
          "operation": "set",
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          },
          "applies_to": "all_usage",
          "source_path": null,
          "id": "input",
          "meter": "text.input",
          "amount": 2,
          "when": null,
          "period": null,
          "resulting_rates": null
        },
        {
          "operation": "set",
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          },
          "applies_to": "all_usage",
          "source_path": null,
          "id": "output",
          "meter": "text.output",
          "amount": 10,
          "when": null,
          "period": null,
          "resulting_rates": null
        },
        {
          "operation": "set",
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          },
          "applies_to": "all_usage",
          "source_path": null,
          "id": "cache-read",
          "meter": "text.cache_read",
          "amount": 0.2,
          "when": null,
          "period": null,
          "resulting_rates": null
        },
        {
          "operation": "set",
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          },
          "applies_to": "all_usage",
          "source_path": null,
          "id": "short-write",
          "meter": "text.cache_write",
          "amount": 2.5,
          "when": {
            "kind": "predicate",
            "field": "cache.retention_s",
            "op": "eq",
            "value": 300
          },
          "period": null,
          "resulting_rates": null
        },
        {
          "operation": "set",
          "currency": "USD",
          "unit": {
            "name": "token",
            "quantity": 1000000
          },
          "applies_to": "all_usage",
          "source_path": null,
          "id": "long-write",
          "meter": "text.cache_write",
          "amount": 4,
          "when": {
            "kind": "predicate",
            "field": "cache.retention_s",
            "op": "eq",
            "value": 3600
          },
          "period": null,
          "resulting_rates": null
        },
        {
          "id": "long-context",
          "meter": "text.*",
          "operation": "multiply",
          "amount": 2,
          "currency": null,
          "unit": null,
          "applies_to": "all_usage",
          "source_path": null,
          "when": {
            "kind": "predicate",
            "field": "request.input_tokens",
            "op": "gt",
            "value": 200000
          },
          "period": null,
          "resulting_rates": [
            {
              "meter": "text.input",
              "amount": 4,
              "currency": "USD",
              "unit": {
                "name": "token",
                "quantity": 1000000
              }
            },
            {
              "meter": "text.output",
              "amount": 20,
              "currency": "USD",
              "unit": {
                "name": "token",
                "quantity": 1000000
              }
            },
            {
              "meter": "text.cache_read",
              "amount": 0.4,
              "currency": "USD",
              "unit": {
                "name": "token",
                "quantity": 1000000
              }
            }
          ]
        },
        {
          "id": "off-peak",
          "meter": "*",
          "operation": "multiply",
          "amount": 0.5,
          "currency": null,
          "unit": null,
          "applies_to": "all_usage",
          "source_path": null,
          "when": {
            "kind": "predicate",
            "field": "request.utc_hours",
            "op": "gte",
            "value": "16:00"
          },
          "period": "off_peak",
          "resulting_rates": [
            {
              "meter": "text.input",
              "amount": 1,
              "currency": "USD",
              "unit": {
                "name": "token",
                "quantity": 1000000
              }
            },
            {
              "meter": "text.output",
              "amount": 5,
              "currency": "USD",
              "unit": {
                "name": "token",
                "quantity": 1000000
              }
            },
            {
              "meter": "text.cache_read",
              "amount": 0.1,
              "currency": "USD",
              "unit": {
                "name": "token",
                "quantity": 1000000
              }
            }
          ]
        }
      ],
      "rule_order": "listed",
      "unparsed": [],
      "evidence": [
        {
          "kind": "documented",
          "url": "https://example.com/pricing",
          "date": "2026-11-14",
          "note": "Illustrative contract example; not actual provider pricing or settings."
        }
      ]
    }
  ]
}

RequestBinding

Field (* required)TypeMeaning
location*"header" | "body" | "query"
path*stringHeader/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name.
scope*"request" | "content_block" | nullWhere the binding is applied. Null = scope unknown.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "enum": [
        "header",
        "body",
        "query"
      ]
    },
    "path": {
      "type": "string",
      "minLength": 1,
      "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
    },
    "scope": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "request",
            "content_block"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Where the binding is applied. Null = scope unknown."
    }
  },
  "required": [
    "location",
    "path",
    "scope"
  ],
  "additionalProperties": false
}

RequestSetting

Field (* required)TypeMeaning
location*"header" | "body" | "query"
path*stringHeader/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name.
scope*"request" | "content_block" | nullWhere the binding is applied. Null = scope unknown.
value*__schema0
Full JSON Schema
{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "enum": [
        "header",
        "body",
        "query"
      ]
    },
    "path": {
      "type": "string",
      "minLength": 1,
      "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
    },
    "scope": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "request",
            "content_block"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Where the binding is applied. Null = scope unknown."
    },
    "value": {
      "$ref": "#/components/schemas/RequestSetting/$defs/__schema0"
    }
  },
  "required": [
    "location",
    "path",
    "scope",
    "value"
  ],
  "additionalProperties": false,
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestSetting/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestSetting/$defs/__schema0"
          }
        }
      ]
    }
  }
}

RequestOption

Field (* required)TypeMeaning
value*__schema0The provider's actual accepted value, not a display alias.
attributes*object | nullNormalized meaning when known, e.g. retention_s: 3600 and profile: long. Short/long alone never specifies a duration.
settings*object[] | nullExact fields and any companion headers for this option. Null = transport unknown.
when*__schema3 | null
Full JSON Schema
{
  "type": "object",
  "properties": {
    "value": {
      "description": "The provider's actual accepted value, not a display alias.",
      "$ref": "#/components/schemas/RequestOption/$defs/__schema0"
    },
    "attributes": {
      "anyOf": [
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema1"
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "Normalized meaning when known, e.g. retention_s: 3600 and profile: long. Short/long alone never specifies a duration."
    },
    "settings": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "header",
                  "body",
                  "query"
                ]
              },
              "path": {
                "type": "string",
                "minLength": 1,
                "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
              },
              "scope": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "request",
                      "content_block"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Where the binding is applied. Null = scope unknown."
              },
              "value": {
                "$ref": "#/components/schemas/RequestOption/$defs/__schema2"
              }
            },
            "required": [
              "location",
              "path",
              "scope",
              "value"
            ],
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "Exact fields and any companion headers for this option. Null = transport unknown."
    },
    "when": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/RequestOption/$defs/__schema3"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "value",
    "attributes",
    "settings",
    "when"
  ],
  "additionalProperties": false,
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema0"
          }
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema1"
          }
        }
      ]
    },
    "__schema2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema2"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema2"
          }
        }
      ]
    },
    "__schema3": {
      "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "predicate"
            },
            "field": {
              "type": "string",
              "minLength": 1
            },
            "op": {
              "type": "string",
              "enum": [
                "eq",
                "in",
                "gt",
                "gte",
                "lt",
                "lte",
                "min_items"
              ]
            },
            "value": {
              "$ref": "#/components/schemas/RequestOption/$defs/__schema4"
            }
          },
          "required": [
            "kind",
            "field",
            "op",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ]
            },
            "conditions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/RequestOption/$defs/__schema3"
              }
            }
          },
          "required": [
            "kind",
            "conditions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "not"
            },
            "condition": {
              "$ref": "#/components/schemas/RequestOption/$defs/__schema3"
            }
          },
          "required": [
            "kind",
            "condition"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "unknown"
            },
            "raw": {
              "$ref": "#/components/schemas/RequestOption/$defs/__schema5"
            }
          },
          "required": [
            "kind",
            "raw"
          ],
          "additionalProperties": false
        }
      ]
    },
    "__schema4": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema4"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema4"
          }
        }
      ]
    },
    "__schema5": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema5"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestOption/$defs/__schema5"
          }
        }
      ]
    }
  }
}

RequestControl

Field (* required)TypeMeaning
id*stringSemantic id, e.g. cache.retention or service_tier; independent of the provider's wire field.
support*"supported" | "unsupported" | "unknown"
when*__schema0 | nullScope of the support claim: endpoint, protocol, region or another request condition.
bindings*object[] | nullKnown places this control is sent. Null means transport is unconfirmed, even when support is documented.
options*object[] | null
default*object | nullKnown default wrapped in value so an explicit JSON null differs from an unknown default.
conditions*string[]Source restrictions not yet represented as condition trees. Nonempty means a caller must not treat the control as unconditional.
evidence*object[]
Example (fictional)
{
  "id": "cache.retention",
  "support": "supported",
  "when": {
    "kind": "predicate",
    "field": "request.endpoint",
    "op": "eq",
    "value": "/v1/example"
  },
  "bindings": [
    {
      "location": "body",
      "path": "/cache_control/ttl",
      "scope": "content_block"
    }
  ],
  "options": [
    {
      "value": "5m",
      "attributes": {
        "retention_s": 300,
        "profile": "short"
      },
      "when": null,
      "settings": [
        {
          "location": "body",
          "path": "/cache_control/type",
          "scope": "content_block",
          "value": "ephemeral"
        },
        {
          "location": "body",
          "path": "/cache_control/ttl",
          "scope": "content_block",
          "value": "5m"
        }
      ]
    },
    {
      "value": "1h",
      "attributes": {
        "retention_s": 3600,
        "profile": "long"
      },
      "when": null,
      "settings": [
        {
          "location": "body",
          "path": "/cache_control/type",
          "scope": "content_block",
          "value": "ephemeral"
        },
        {
          "location": "body",
          "path": "/cache_control/ttl",
          "scope": "content_block",
          "value": "1h"
        },
        {
          "location": "header",
          "path": "x-example-cache",
          "scope": "request",
          "value": "extended"
        }
      ]
    }
  ],
  "default": {
    "value": "5m"
  },
  "conditions": [],
  "evidence": [
    {
      "kind": "documented",
      "url": "https://example.com/pricing",
      "date": "2026-11-14",
      "note": "Illustrative contract example; not actual provider pricing or settings."
    }
  ]
}
Full JSON Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Semantic id, e.g. cache.retention or service_tier; independent of the provider's wire field."
    },
    "support": {
      "type": "string",
      "enum": [
        "supported",
        "unsupported",
        "unknown"
      ]
    },
    "when": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/RequestControl/$defs/__schema0"
        },
        {
          "type": "null"
        }
      ],
      "description": "Scope of the support claim: endpoint, protocol, region or another request condition."
    },
    "bindings": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "header",
                  "body",
                  "query"
                ]
              },
              "path": {
                "type": "string",
                "minLength": 1,
                "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
              },
              "scope": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "request",
                      "content_block"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Where the binding is applied. Null = scope unknown."
              }
            },
            "required": [
              "location",
              "path",
              "scope"
            ],
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "Known places this control is sent. Null means transport is unconfirmed, even when support is documented."
    },
    "options": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "description": "The provider's actual accepted value, not a display alias.",
                "$ref": "#/components/schemas/RequestControl/$defs/__schema3"
              },
              "attributes": {
                "anyOf": [
                  {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "$ref": "#/components/schemas/RequestControl/$defs/__schema4"
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Normalized meaning when known, e.g. retention_s: 3600 and profile: long. Short/long alone never specifies a duration."
              },
              "settings": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "location": {
                          "type": "string",
                          "enum": [
                            "header",
                            "body",
                            "query"
                          ]
                        },
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                        },
                        "scope": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "request",
                                "content_block"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Where the binding is applied. Null = scope unknown."
                        },
                        "value": {
                          "$ref": "#/components/schemas/RequestControl/$defs/__schema5"
                        }
                      },
                      "required": [
                        "location",
                        "path",
                        "scope",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Exact fields and any companion headers for this option. Null = transport unknown."
              },
              "when": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/RequestControl/$defs/__schema0"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "value",
              "attributes",
              "settings",
              "when"
            ],
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "default": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "#/components/schemas/RequestControl/$defs/__schema6"
            }
          },
          "required": [
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Known default wrapped in value so an explicit JSON null differs from an unknown default."
    },
    "conditions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Source restrictions not yet represented as condition trees. Nonempty means a caller must not treat the control as unconditional."
    },
    "evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "documented",
              "measured"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "date": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "kind",
          "url",
          "date",
          "note"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "id",
    "support",
    "when",
    "bindings",
    "options",
    "default",
    "conditions",
    "evidence"
  ],
  "additionalProperties": false,
  "$defs": {
    "__schema0": {
      "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "predicate"
            },
            "field": {
              "type": "string",
              "minLength": 1
            },
            "op": {
              "type": "string",
              "enum": [
                "eq",
                "in",
                "gt",
                "gte",
                "lt",
                "lte",
                "min_items"
              ]
            },
            "value": {
              "$ref": "#/components/schemas/RequestControl/$defs/__schema1"
            }
          },
          "required": [
            "kind",
            "field",
            "op",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ]
            },
            "conditions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/RequestControl/$defs/__schema0"
              }
            }
          },
          "required": [
            "kind",
            "conditions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "not"
            },
            "condition": {
              "$ref": "#/components/schemas/RequestControl/$defs/__schema0"
            }
          },
          "required": [
            "kind",
            "condition"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "unknown"
            },
            "raw": {
              "$ref": "#/components/schemas/RequestControl/$defs/__schema2"
            }
          },
          "required": [
            "kind",
            "raw"
          ],
          "additionalProperties": false
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema1"
          }
        }
      ]
    },
    "__schema2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema2"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema2"
          }
        }
      ]
    },
    "__schema3": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema3"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema3"
          }
        }
      ]
    },
    "__schema4": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema4"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema4"
          }
        }
      ]
    },
    "__schema5": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema5"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema5"
          }
        }
      ]
    },
    "__schema6": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema6"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControl/$defs/__schema6"
          }
        }
      ]
    }
  },
  "examples": [
    {
      "id": "cache.retention",
      "support": "supported",
      "when": {
        "kind": "predicate",
        "field": "request.endpoint",
        "op": "eq",
        "value": "/v1/example"
      },
      "bindings": [
        {
          "location": "body",
          "path": "/cache_control/ttl",
          "scope": "content_block"
        }
      ],
      "options": [
        {
          "value": "5m",
          "attributes": {
            "retention_s": 300,
            "profile": "short"
          },
          "when": null,
          "settings": [
            {
              "location": "body",
              "path": "/cache_control/type",
              "scope": "content_block",
              "value": "ephemeral"
            },
            {
              "location": "body",
              "path": "/cache_control/ttl",
              "scope": "content_block",
              "value": "5m"
            }
          ]
        },
        {
          "value": "1h",
          "attributes": {
            "retention_s": 3600,
            "profile": "long"
          },
          "when": null,
          "settings": [
            {
              "location": "body",
              "path": "/cache_control/type",
              "scope": "content_block",
              "value": "ephemeral"
            },
            {
              "location": "body",
              "path": "/cache_control/ttl",
              "scope": "content_block",
              "value": "1h"
            },
            {
              "location": "header",
              "path": "x-example-cache",
              "scope": "request",
              "value": "extended"
            }
          ]
        }
      ],
      "default": {
        "value": "5m"
      },
      "conditions": [],
      "evidence": [
        {
          "kind": "documented",
          "url": "https://example.com/pricing",
          "date": "2026-11-14",
          "note": "Illustrative contract example; not actual provider pricing or settings."
        }
      ]
    }
  ]
}

RequestControls

Field (* required)TypeMeaning
coverage*"unknown" | "partial" | "complete" | "not_applicable"unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence.
items*object[]Always includes cache.retention and service_tier. Additional controls use the same schema. No control is inherited across access routes.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "coverage": {
      "type": "string",
      "enum": [
        "unknown",
        "partial",
        "complete",
        "not_applicable"
      ],
      "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Semantic id, e.g. cache.retention or service_tier; independent of the provider's wire field."
          },
          "support": {
            "type": "string",
            "enum": [
              "supported",
              "unsupported",
              "unknown"
            ]
          },
          "when": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RequestControls/$defs/__schema0"
              },
              {
                "type": "null"
              }
            ],
            "description": "Scope of the support claim: endpoint, protocol, region or another request condition."
          },
          "bindings": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "location": {
                      "type": "string",
                      "enum": [
                        "header",
                        "body",
                        "query"
                      ]
                    },
                    "path": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                    },
                    "scope": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "request",
                            "content_block"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Where the binding is applied. Null = scope unknown."
                    }
                  },
                  "required": [
                    "location",
                    "path",
                    "scope"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Known places this control is sent. Null means transport is unconfirmed, even when support is documented."
          },
          "options": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "description": "The provider's actual accepted value, not a display alias.",
                      "$ref": "#/components/schemas/RequestControls/$defs/__schema3"
                    },
                    "attributes": {
                      "anyOf": [
                        {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/components/schemas/RequestControls/$defs/__schema4"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Normalized meaning when known, e.g. retention_s: 3600 and profile: long. Short/long alone never specifies a duration."
                    },
                    "settings": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "location": {
                                "type": "string",
                                "enum": [
                                  "header",
                                  "body",
                                  "query"
                                ]
                              },
                              "path": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                              },
                              "scope": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "enum": [
                                      "request",
                                      "content_block"
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Where the binding is applied. Null = scope unknown."
                              },
                              "value": {
                                "$ref": "#/components/schemas/RequestControls/$defs/__schema5"
                              }
                            },
                            "required": [
                              "location",
                              "path",
                              "scope",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Exact fields and any companion headers for this option. Null = transport unknown."
                    },
                    "when": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/RequestControls/$defs/__schema0"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "value",
                    "attributes",
                    "settings",
                    "when"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "default": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "value": {
                    "$ref": "#/components/schemas/RequestControls/$defs/__schema6"
                  }
                },
                "required": [
                  "value"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "description": "Known default wrapped in value so an explicit JSON null differs from an unknown default."
          },
          "conditions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Source restrictions not yet represented as condition trees. Nonempty means a caller must not treat the control as unconditional."
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "documented",
                    "measured"
                  ]
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "note": {
                  "type": "string"
                }
              },
              "required": [
                "kind",
                "url",
                "date",
                "note"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "id",
          "support",
          "when",
          "bindings",
          "options",
          "default",
          "conditions",
          "evidence"
        ],
        "additionalProperties": false
      },
      "description": "Always includes cache.retention and service_tier. Additional controls use the same schema. No control is inherited across access routes."
    }
  },
  "required": [
    "coverage",
    "items"
  ],
  "additionalProperties": false,
  "$defs": {
    "__schema0": {
      "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "predicate"
            },
            "field": {
              "type": "string",
              "minLength": 1
            },
            "op": {
              "type": "string",
              "enum": [
                "eq",
                "in",
                "gt",
                "gte",
                "lt",
                "lte",
                "min_items"
              ]
            },
            "value": {
              "$ref": "#/components/schemas/RequestControls/$defs/__schema1"
            }
          },
          "required": [
            "kind",
            "field",
            "op",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ]
            },
            "conditions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/RequestControls/$defs/__schema0"
              }
            }
          },
          "required": [
            "kind",
            "conditions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "not"
            },
            "condition": {
              "$ref": "#/components/schemas/RequestControls/$defs/__schema0"
            }
          },
          "required": [
            "kind",
            "condition"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "unknown"
            },
            "raw": {
              "$ref": "#/components/schemas/RequestControls/$defs/__schema2"
            }
          },
          "required": [
            "kind",
            "raw"
          ],
          "additionalProperties": false
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema1"
          }
        }
      ]
    },
    "__schema2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema2"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema2"
          }
        }
      ]
    },
    "__schema3": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema3"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema3"
          }
        }
      ]
    },
    "__schema4": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema4"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema4"
          }
        }
      ]
    },
    "__schema5": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema5"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema5"
          }
        }
      ]
    },
    "__schema6": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema6"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/RequestControls/$defs/__schema6"
          }
        }
      ]
    }
  }
}

MeasuredLimit

One limit evaluation. Every evaluation has every field; what it did not measure is null.

Field (* required)TypeMeaning
route*string
route_label*string
client*string
client_label*string
context*number | nullTokens: the context window found. Null = this evaluation did not measure it.
output*number | nullTokens: the largest response found. Null = not measured.
input_accepted*number | nullTokens: the largest input seen accepted. The real limit is at least this. Null = not measured.
input_refused*number | nullTokens: the smallest input seen refused. The real limit is below this. Null = not measured.
input_read*number | nullTokens: the largest input for which the reply showed the route read it to the end (a word before the filler and one after it, both returned). Never above input_accepted. Null = not checked.
output_accepted*number | nullTokens: the largest requested output seen accepted. Null = not measured.
note*string | nullNull = no note.
date*string | nullThe day the requests were sent: the evaluation's own date, else the date in the name of its results folder. Null = the result carries no date.
source*string
Full JSON Schema
{
  "type": "object",
  "properties": {
    "route": {
      "type": "string"
    },
    "route_label": {
      "type": "string"
    },
    "client": {
      "type": "string"
    },
    "client_label": {
      "type": "string"
    },
    "context": {
      "description": "Tokens: the context window found. Null = this evaluation did not measure it.",
      "type": [
        "number",
        "null"
      ]
    },
    "output": {
      "description": "Tokens: the largest response found. Null = not measured.",
      "type": [
        "number",
        "null"
      ]
    },
    "input_accepted": {
      "description": "Tokens: the largest input seen accepted. The real limit is at least this. Null = not measured.",
      "type": [
        "number",
        "null"
      ]
    },
    "input_refused": {
      "description": "Tokens: the smallest input seen refused. The real limit is below this. Null = not measured.",
      "type": [
        "number",
        "null"
      ]
    },
    "input_read": {
      "description": "Tokens: the largest input for which the reply showed the route read it to the end (a word before the filler and one after it, both returned). Never above input_accepted. Null = not checked.",
      "type": [
        "number",
        "null"
      ]
    },
    "output_accepted": {
      "description": "Tokens: the largest requested output seen accepted. Null = not measured.",
      "type": [
        "number",
        "null"
      ]
    },
    "note": {
      "description": "Null = no note.",
      "type": [
        "string",
        "null"
      ]
    },
    "date": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "The day the requests were sent: the evaluation's own date, else the date in the name of its results folder. Null = the result carries no date."
    },
    "source": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "route",
    "route_label",
    "client",
    "client_label",
    "context",
    "output",
    "input_accepted",
    "input_refused",
    "input_read",
    "output_accepted",
    "note",
    "date",
    "source"
  ],
  "additionalProperties": false,
  "description": "One limit evaluation. Every evaluation has every field; what it did not measure is null."
}

InputWindow

How much input a request can carry on this entry, and what that rests on: the documented value, the measured one beside it, and which the rule chose. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee.

Field (* required)TypeMeaning
tokens*integer | nullThe most input a request can carry on this entry, in tokens as the provider counts them, the client's own system prompt and tools included: documented_tokens unless a counted evaluation clearly contradicts it, else measured_tokens, else null. basis says which. Null = not known. Never 0.
basis*"documented" | "measured" | "none"documented: tokens is documented_tokens. measured: tokens is measured_tokens. none: exactly when tokens is null.
bound*"limit" | "at_least" | nulllimit: the value is the limit, as documented or as the route names it. at_least: the value is the largest input seen accepted, and the real limit is this or more; measured_refused, where set, is an input seen refused. A documented value is always limit. Null with none.
scope*"input" | "window" | nullinput: a figure for the input alone (limit.input, or an input size seen accepted). window: a context window that input and output share (limit.context, or a window the route names): the response is counted against the same figure. Null with none.
source*"providers.dev" | "models.dev" | nullWho the value is from. measured: always providers.dev. documented: documented_source. Null with none.
date*string | nullmeasured: measured_date. documented: documented_date. Null with none, and where the source has no date.
documented_tokens*integer | nullThe documented input of the entry: limit.input where it is above 0, else limit.context where it is above 0 and not a measured value named in limits.from_measurement. 0 means none stated. Nothing is read from another entry. Null = none is documented.
documented_field*"limit.input" | "limit.context" | nullThe field of the entry documented_tokens is read from. Null with documented_tokens.
documented_source*"providers.dev" | "models.dev" | nullmodels.dev for an imported value; providers.dev for a correction of the field and for a value in an entry providers.dev added. Null with documented_tokens.
documented_date*string | nullThe import date for models.dev; the newest evidence date for providers.dev. Null = none is documented, or the source has no date.
documented_status*"contradicted" | "not_contradicted" | nullWhat the rule found of the documented value, where one is documented and at least one evaluation counts. contradicted: an evaluation names a window below it, names another window than a documented limit.context, refused an input at or below 99 % of it, or accepted one at or above 101 % of it; tokens is measured_tokens. not_contradicted: none does, and tokens is documented_tokens; that is not the same as confirmed. Null in every other case.
measured_tokens*integer | nullThe measured value of the entry: the lowest tokens of measurements, whatever the client. Null = no evaluation counts.
measured_bound*"limit" | "at_least" | nullThe bound of the measurement that gives measured_tokens (measurements[0]). Null with measured_tokens.
measured_kind*"window" | "bracket" | "accepted" | nullIts kind. Null with measured_tokens.
measured_refused*integer | nullIts refused where its kind is bracket: the smallest input it saw refused; the limit is below this. Null otherwise.
measured_date*string | nullIts date. Null with measured_tokens, and where the evaluation has no date.
clients*integerHow many different clients measurements has. 0 = not measured.
evaluations*integerHow many items measurements has: the limit evaluations of the entry that count. 0 = none counts.
measurements*object[]One item per counted limit evaluation, ordered by tokens, then limit before at_least, then by client, route, date and source in plain character order, null first. The first item gives the measured_* keys. Empty = none counts. An evaluation that does not count (a refusal with nothing accepted, an accepted size with no refusal, no named window and no read check, the output alone) stays in limits.measured and is in no item.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "tokens": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "The most input a request can carry on this entry, in tokens as the provider counts them, the client's own system prompt and tools included: documented_tokens unless a counted evaluation clearly contradicts it, else measured_tokens, else null. basis says which. Null = not known. Never 0."
    },
    "basis": {
      "type": "string",
      "enum": [
        "documented",
        "measured",
        "none"
      ],
      "description": "documented: tokens is documented_tokens. measured: tokens is measured_tokens. none: exactly when tokens is null."
    },
    "bound": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "limit",
            "at_least"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "limit: the value is the limit, as documented or as the route names it. at_least: the value is the largest input seen accepted, and the real limit is this or more; measured_refused, where set, is an input seen refused. A documented value is always limit. Null with none."
    },
    "scope": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "input",
            "window"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "input: a figure for the input alone (limit.input, or an input size seen accepted). window: a context window that input and output share (limit.context, or a window the route names): the response is counted against the same figure. Null with none."
    },
    "source": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "providers.dev",
            "models.dev"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Who the value is from. measured: always providers.dev. documented: documented_source. Null with none."
    },
    "date": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "measured: measured_date. documented: documented_date. Null with none, and where the source has no date."
    },
    "documented_tokens": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "The documented input of the entry: limit.input where it is above 0, else limit.context where it is above 0 and not a measured value named in limits.from_measurement. 0 means none stated. Nothing is read from another entry. Null = none is documented."
    },
    "documented_field": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "limit.input",
            "limit.context"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "The field of the entry documented_tokens is read from. Null with documented_tokens."
    },
    "documented_source": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "providers.dev",
            "models.dev"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "models.dev for an imported value; providers.dev for a correction of the field and for a value in an entry providers.dev added. Null with documented_tokens."
    },
    "documented_date": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "The import date for models.dev; the newest evidence date for providers.dev. Null = none is documented, or the source has no date."
    },
    "documented_status": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "contradicted",
            "not_contradicted"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "What the rule found of the documented value, where one is documented and at least one evaluation counts. contradicted: an evaluation names a window below it, names another window than a documented limit.context, refused an input at or below 99 % of it, or accepted one at or above 101 % of it; tokens is measured_tokens. not_contradicted: none does, and tokens is documented_tokens; that is not the same as confirmed. Null in every other case."
    },
    "measured_tokens": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "The measured value of the entry: the lowest tokens of measurements, whatever the client. Null = no evaluation counts."
    },
    "measured_bound": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "limit",
            "at_least"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "The bound of the measurement that gives measured_tokens (measurements[0]). Null with measured_tokens."
    },
    "measured_kind": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "window",
            "bracket",
            "accepted"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Its kind. Null with measured_tokens."
    },
    "measured_refused": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Its refused where its kind is bracket: the smallest input it saw refused; the limit is below this. Null otherwise."
    },
    "measured_date": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "Its date. Null with measured_tokens, and where the evaluation has no date."
    },
    "clients": {
      "type": "integer",
      "minimum": 0,
      "description": "How many different clients measurements has. 0 = not measured."
    },
    "evaluations": {
      "type": "integer",
      "minimum": 0,
      "description": "How many items measurements has: the limit evaluations of the entry that count. 0 = none counts."
    },
    "measurements": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "client": {
            "type": "string",
            "description": "The public id of the client the requests went through, as on the evaluation."
          },
          "client_label": {
            "type": "string"
          },
          "route": {
            "type": "string",
            "description": "The access method the requests went through, as on the evaluation."
          },
          "route_label": {
            "type": "string"
          },
          "date": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              {
                "type": "null"
              }
            ],
            "description": "The day the requests were sent, as on the evaluation. Null = the result carries no date."
          },
          "tokens": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "description": "The value this evaluation gives: named for kind window, accepted for bracket, read for accepted."
          },
          "bound": {
            "type": "string",
            "enum": [
              "limit",
              "at_least"
            ],
            "description": "limit for kind window: the route named its limit. at_least for bracket and accepted: the largest input seen accepted; the real limit is this or more."
          },
          "kind": {
            "type": "string",
            "enum": [
              "window",
              "bracket",
              "accepted"
            ],
            "description": "window: the route's own answer named its context window, and no smaller input was refused. bracket: an input was accepted and a larger one refused; the value is the accepted one. accepted: an input was accepted and the reply showed it was read to the end, nothing refused and no window named."
          },
          "accepted": {
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0
              },
              {
                "type": "null"
              }
            ],
            "description": "input_accepted of the evaluation: the largest input seen accepted. Null = none recorded."
          },
          "refused": {
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0
              },
              {
                "type": "null"
              }
            ],
            "description": "input_refused of the evaluation: the smallest input seen refused. Null = none."
          },
          "named": {
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0
              },
              {
                "type": "null"
              }
            ],
            "description": "context of the evaluation: the window the route names. Null = it named none."
          },
          "read": {
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0
              },
              {
                "type": "null"
              }
            ],
            "description": "input_read of the evaluation: the largest input the reply showed was read to the end. Null = not checked."
          },
          "source": {
            "type": "string",
            "format": "uri",
            "description": "The raw result, as on the evaluation."
          }
        },
        "required": [
          "client",
          "client_label",
          "route",
          "route_label",
          "date",
          "tokens",
          "bound",
          "kind",
          "accepted",
          "refused",
          "named",
          "read",
          "source"
        ],
        "additionalProperties": false,
        "description": "One limit evaluation of the entry that counts for the input window, with the value it gives. One route, one client, one model."
      },
      "description": "One item per counted limit evaluation, ordered by tokens, then limit before at_least, then by client, route, date and source in plain character order, null first. The first item gives the measured_* keys. Empty = none counts. An evaluation that does not count (a refusal with nothing accepted, an accepted size with no refusal, no named window and no read check, the output alone) stays in limits.measured and is in no item."
    }
  },
  "required": [
    "tokens",
    "basis",
    "bound",
    "scope",
    "source",
    "date",
    "documented_tokens",
    "documented_field",
    "documented_source",
    "documented_date",
    "documented_status",
    "measured_tokens",
    "measured_bound",
    "measured_kind",
    "measured_refused",
    "measured_date",
    "clients",
    "evaluations",
    "measurements"
  ],
  "additionalProperties": false,
  "description": "How much input a request can carry on this entry, and what that rests on: the documented value, the measured one beside it, and which the rule chose. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee."
}

InputWindowMeasurement

One limit evaluation of the entry that counts for the input window, with the value it gives. One route, one client, one model.

Field (* required)TypeMeaning
client*stringThe public id of the client the requests went through, as on the evaluation.
client_label*string
route*stringThe access method the requests went through, as on the evaluation.
route_label*string
date*string | nullThe day the requests were sent, as on the evaluation. Null = the result carries no date.
tokens*integerThe value this evaluation gives: named for kind window, accepted for bracket, read for accepted.
bound*"limit" | "at_least"limit for kind window: the route named its limit. at_least for bracket and accepted: the largest input seen accepted; the real limit is this or more.
kind*"window" | "bracket" | "accepted"window: the route's own answer named its context window, and no smaller input was refused. bracket: an input was accepted and a larger one refused; the value is the accepted one. accepted: an input was accepted and the reply showed it was read to the end, nothing refused and no window named.
accepted*integer | nullinput_accepted of the evaluation: the largest input seen accepted. Null = none recorded.
refused*integer | nullinput_refused of the evaluation: the smallest input seen refused. Null = none.
named*integer | nullcontext of the evaluation: the window the route names. Null = it named none.
read*integer | nullinput_read of the evaluation: the largest input the reply showed was read to the end. Null = not checked.
source*stringThe raw result, as on the evaluation.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "description": "The public id of the client the requests went through, as on the evaluation."
    },
    "client_label": {
      "type": "string"
    },
    "route": {
      "type": "string",
      "description": "The access method the requests went through, as on the evaluation."
    },
    "route_label": {
      "type": "string"
    },
    "date": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "The day the requests were sent, as on the evaluation. Null = the result carries no date."
    },
    "tokens": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "The value this evaluation gives: named for kind window, accepted for bracket, read for accepted."
    },
    "bound": {
      "type": "string",
      "enum": [
        "limit",
        "at_least"
      ],
      "description": "limit for kind window: the route named its limit. at_least for bracket and accepted: the largest input seen accepted; the real limit is this or more."
    },
    "kind": {
      "type": "string",
      "enum": [
        "window",
        "bracket",
        "accepted"
      ],
      "description": "window: the route's own answer named its context window, and no smaller input was refused. bracket: an input was accepted and a larger one refused; the value is the accepted one. accepted: an input was accepted and the reply showed it was read to the end, nothing refused and no window named."
    },
    "accepted": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "input_accepted of the evaluation: the largest input seen accepted. Null = none recorded."
    },
    "refused": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "input_refused of the evaluation: the smallest input seen refused. Null = none."
    },
    "named": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "context of the evaluation: the window the route names. Null = it named none."
    },
    "read": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "input_read of the evaluation: the largest input the reply showed was read to the end. Null = not checked."
    },
    "source": {
      "type": "string",
      "format": "uri",
      "description": "The raw result, as on the evaluation."
    }
  },
  "required": [
    "client",
    "client_label",
    "route",
    "route_label",
    "date",
    "tokens",
    "bound",
    "kind",
    "accepted",
    "refused",
    "named",
    "read",
    "source"
  ],
  "additionalProperties": false,
  "description": "One limit evaluation of the entry that counts for the input window, with the value it gives. One route, one client, one model."
}

Provenance

One correction by providers.dev to a field imported from models.dev.

Field (* required)TypeMeaning
path*stringThe field, for example limit.context.
op*"set" | "unknown" | "delete"set = a value is published; unknown = published as unknown on purpose; delete = removed.
value*__schema0The published value. Null unless op is set.
had_upstream*booleanWhether models.dev has a value for the field.
upstream*__schema0What models.dev says. Null unless had_upstream is true.
reason*string
evidence*object[]
Full JSON Schema
{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "The field, for example limit.context."
    },
    "op": {
      "type": "string",
      "enum": [
        "set",
        "unknown",
        "delete"
      ],
      "description": "set = a value is published; unknown = published as unknown on purpose; delete = removed."
    },
    "value": {
      "description": "The published value. Null unless op is set.",
      "$ref": "#/components/schemas/Provenance/$defs/__schema0"
    },
    "had_upstream": {
      "type": "boolean",
      "description": "Whether models.dev has a value for the field."
    },
    "upstream": {
      "description": "What models.dev says. Null unless had_upstream is true.",
      "$ref": "#/components/schemas/Provenance/$defs/__schema0"
    },
    "reason": {
      "type": "string"
    },
    "evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "documented",
              "measured",
              "listed"
            ],
            "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "When the source was read or the measurement taken."
          },
          "note": {
            "description": "What the source says. Null = no note.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "kind",
          "url",
          "date",
          "note"
        ],
        "additionalProperties": false,
        "description": "A source for something providers.dev publishes."
      }
    }
  },
  "required": [
    "path",
    "op",
    "value",
    "had_upstream",
    "upstream",
    "reason",
    "evidence"
  ],
  "additionalProperties": false,
  "description": "One correction by providers.dev to a field imported from models.dev.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Provenance/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Provenance/$defs/__schema0"
          }
        }
      ]
    }
  }
}

ProviderSummary

One provider.

Field (* required)TypeMeaning
id*string
name*string
doc*string | nullThe provider's documentation. Null = none recorded.
env*string[]The environment variables a client reads the key from.
access*"api" | "subscription" | "unknown"
access_reviewed*boolean
origin*"upstream" | "added"
entry_count*integer
evidence_entry_count*integerEntries with providers.dev corrections or evaluations.
providers_dev*objectEverything providers.dev adds to a provider. The same keys on every provider.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "doc": {
      "description": "The provider's documentation. Null = none recorded.",
      "type": [
        "string",
        "null"
      ]
    },
    "env": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The environment variables a client reads the key from."
    },
    "access": {
      "type": "string",
      "enum": [
        "api",
        "subscription",
        "unknown"
      ]
    },
    "access_reviewed": {
      "type": "boolean"
    },
    "origin": {
      "type": "string",
      "enum": [
        "upstream",
        "added"
      ]
    },
    "entry_count": {
      "type": "integer",
      "minimum": 0
    },
    "evidence_entry_count": {
      "type": "integer",
      "minimum": 0,
      "description": "Entries with providers.dev corrections or evaluations."
    },
    "providers_dev": {
      "type": "object",
      "properties": {
        "origin": {
          "type": "string",
          "enum": [
            "upstream",
            "added"
          ]
        },
        "access": {
          "type": "string",
          "enum": [
            "api",
            "subscription",
            "unknown"
          ]
        },
        "access_basis": {
          "type": "string",
          "description": "Why the provider is classified this way."
        },
        "access_reviewed": {
          "type": "boolean",
          "description": "False = classified by a general rule, not looked at one by one."
        },
        "access_source": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ],
          "description": "The source of the classification. Null = none recorded."
        },
        "note": {
          "type": [
            "string",
            "null"
          ]
        },
        "evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "documented",
                  "measured",
                  "listed"
                ],
                "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "date": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "When the source was read or the measurement taken."
              },
              "note": {
                "description": "What the source says. Null = no note.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "kind",
              "url",
              "date",
              "note"
            ],
            "additionalProperties": false,
            "description": "A source for something providers.dev publishes."
          },
          "description": "Sources for a provider that providers.dev added. Empty = none."
        },
        "provenance": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string",
                "description": "The field, for example limit.context."
              },
              "op": {
                "type": "string",
                "enum": [
                  "set",
                  "unknown",
                  "delete"
                ],
                "description": "set = a value is published; unknown = published as unknown on purpose; delete = removed."
              },
              "value": {
                "description": "The published value. Null unless op is set.",
                "$ref": "#/components/schemas/ProviderSummary/$defs/__schema0"
              },
              "had_upstream": {
                "type": "boolean",
                "description": "Whether models.dev has a value for the field."
              },
              "upstream": {
                "description": "What models.dev says. Null unless had_upstream is true.",
                "$ref": "#/components/schemas/ProviderSummary/$defs/__schema0"
              },
              "reason": {
                "type": "string"
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "documented",
                        "measured",
                        "listed"
                      ],
                      "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "date": {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                      "description": "When the source was read or the measurement taken."
                    },
                    "note": {
                      "description": "What the source says. Null = no note.",
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "kind",
                    "url",
                    "date",
                    "note"
                  ],
                  "additionalProperties": false,
                  "description": "A source for something providers.dev publishes."
                }
              }
            },
            "required": [
              "path",
              "op",
              "value",
              "had_upstream",
              "upstream",
              "reason",
              "evidence"
            ],
            "additionalProperties": false,
            "description": "One correction by providers.dev to a field imported from models.dev."
          },
          "description": "Corrections to the provider's imported fields. Empty = none."
        }
      },
      "required": [
        "origin",
        "access",
        "access_basis",
        "access_reviewed",
        "access_source",
        "note",
        "evidence",
        "provenance"
      ],
      "additionalProperties": false,
      "description": "Everything providers.dev adds to a provider. The same keys on every provider."
    }
  },
  "required": [
    "id",
    "name",
    "doc",
    "env",
    "access",
    "access_reviewed",
    "origin",
    "entry_count",
    "evidence_entry_count",
    "providers_dev"
  ],
  "additionalProperties": false,
  "description": "One provider.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ProviderSummary/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/ProviderSummary/$defs/__schema0"
          }
        }
      ]
    }
  }
}

ProviderExtension

Everything providers.dev adds to a provider. The same keys on every provider.

Field (* required)TypeMeaning
origin*"upstream" | "added"
access*"api" | "subscription" | "unknown"
access_basis*stringWhy the provider is classified this way.
access_reviewed*booleanFalse = classified by a general rule, not looked at one by one.
access_source*string | nullThe source of the classification. Null = none recorded.
note*string | null
evidence*object[]Sources for a provider that providers.dev added. Empty = none.
provenance*object[]Corrections to the provider's imported fields. Empty = none.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "enum": [
        "upstream",
        "added"
      ]
    },
    "access": {
      "type": "string",
      "enum": [
        "api",
        "subscription",
        "unknown"
      ]
    },
    "access_basis": {
      "type": "string",
      "description": "Why the provider is classified this way."
    },
    "access_reviewed": {
      "type": "boolean",
      "description": "False = classified by a general rule, not looked at one by one."
    },
    "access_source": {
      "anyOf": [
        {
          "type": "string",
          "format": "uri"
        },
        {
          "type": "null"
        }
      ],
      "description": "The source of the classification. Null = none recorded."
    },
    "note": {
      "type": [
        "string",
        "null"
      ]
    },
    "evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "documented",
              "measured",
              "listed"
            ],
            "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "When the source was read or the measurement taken."
          },
          "note": {
            "description": "What the source says. Null = no note.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "kind",
          "url",
          "date",
          "note"
        ],
        "additionalProperties": false,
        "description": "A source for something providers.dev publishes."
      },
      "description": "Sources for a provider that providers.dev added. Empty = none."
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "The field, for example limit.context."
          },
          "op": {
            "type": "string",
            "enum": [
              "set",
              "unknown",
              "delete"
            ],
            "description": "set = a value is published; unknown = published as unknown on purpose; delete = removed."
          },
          "value": {
            "description": "The published value. Null unless op is set.",
            "$ref": "#/components/schemas/ProviderExtension/$defs/__schema0"
          },
          "had_upstream": {
            "type": "boolean",
            "description": "Whether models.dev has a value for the field."
          },
          "upstream": {
            "description": "What models.dev says. Null unless had_upstream is true.",
            "$ref": "#/components/schemas/ProviderExtension/$defs/__schema0"
          },
          "reason": {
            "type": "string"
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "documented",
                    "measured",
                    "listed"
                  ],
                  "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "date": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "description": "When the source was read or the measurement taken."
                },
                "note": {
                  "description": "What the source says. Null = no note.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "kind",
                "url",
                "date",
                "note"
              ],
              "additionalProperties": false,
              "description": "A source for something providers.dev publishes."
            }
          }
        },
        "required": [
          "path",
          "op",
          "value",
          "had_upstream",
          "upstream",
          "reason",
          "evidence"
        ],
        "additionalProperties": false,
        "description": "One correction by providers.dev to a field imported from models.dev."
      },
      "description": "Corrections to the provider's imported fields. Empty = none."
    }
  },
  "required": [
    "origin",
    "access",
    "access_basis",
    "access_reviewed",
    "access_source",
    "note",
    "evidence",
    "provenance"
  ],
  "additionalProperties": false,
  "description": "Everything providers.dev adds to a provider. The same keys on every provider.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ProviderExtension/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/ProviderExtension/$defs/__schema0"
          }
        }
      ]
    }
  }
}

Provider

One provider in full, in the models.dev structure.

Field (* required)TypeMeaning
id*string
name*string
docstring
envstring[]
models*objectThe provider's entries in full, by model id.
providers_dev*objectEverything providers.dev adds to a provider. The same keys on every provider.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "doc": {
      "type": "string"
    },
    "env": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "models": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1
          },
          "name": {
            "type": "string",
            "minLength": 1
          },
          "description": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "family": {
            "type": "string"
          },
          "canonical_id": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "release_date": {
            "type": "string"
          },
          "limit": {
            "type": "object",
            "properties": {
              "context": {
                "description": "Context window in tokens.",
                "type": "number",
                "minimum": 0
              },
              "input": {
                "description": "Maximum input in tokens.",
                "type": "number",
                "minimum": 0
              },
              "output": {
                "description": "Maximum output in tokens.",
                "type": "number",
                "minimum": 0
              }
            },
            "additionalProperties": {}
          },
          "capabilities": {
            "type": "object",
            "properties": {
              "cache": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "const": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "implicit": {
                        "anyOf": [
                          {
                            "type": "boolean"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "ttl": {
                                "description": "Documented lifetimes, such as 5m or 1h.",
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "min_tokens": {
                                "type": "number",
                                "minimum": 0
                              },
                              "max_breakpoints": {
                                "type": "number",
                                "minimum": 0
                              },
                              "targets": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "additionalProperties": {}
                          }
                        ]
                      },
                      "explicit": {
                        "anyOf": [
                          {
                            "type": "boolean"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "ttl": {
                                "description": "Documented lifetimes, such as 5m or 1h.",
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "min_tokens": {
                                "type": "number",
                                "minimum": 0
                              },
                              "max_breakpoints": {
                                "type": "number",
                                "minimum": 0
                              },
                              "targets": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "additionalProperties": {}
                          }
                        ]
                      }
                    },
                    "additionalProperties": {}
                  }
                ],
                "description": "False explicitly disables caching. Missing modes are unknown."
              },
              "temperature": {
                "type": "boolean"
              },
              "top_k": {
                "type": "boolean"
              },
              "top_p": {
                "type": "boolean"
              },
              "structured_output": {
                "type": "boolean"
              },
              "prompt_cache_key": {
                "type": "boolean"
              },
              "store": {
                "type": "boolean"
              },
              "stream_usage": {
                "type": "boolean"
              },
              "system_updates": {
                "type": "boolean"
              },
              "effort_updates": {
                "type": "boolean"
              },
              "service_tier": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "tools": {
                "type": "object",
                "properties": {
                  "supported": {
                    "type": "boolean"
                  },
                  "choice": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "freeform": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "strict": {
                    "type": "boolean"
                  },
                  "updates": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": {}
              },
              "reasoning": {
                "type": "object",
                "properties": {
                  "supported": {
                    "type": "boolean"
                  },
                  "toggle": {
                    "type": "boolean"
                  },
                  "effort": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "budget": {
                    "type": "object",
                    "properties": {
                      "min": {
                        "type": "number"
                      },
                      "max": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": {}
                  },
                  "default": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "value": {
                        "type": [
                          "boolean",
                          "string",
                          "number"
                        ]
                      }
                    },
                    "additionalProperties": {}
                  }
                },
                "additionalProperties": {}
              }
            },
            "additionalProperties": {},
            "description": "Documented capabilities. Missing fields remain unknown."
          },
          "cost": {
            "type": "object",
            "properties": {
              "text": {
                "type": "object",
                "properties": {
                  "input": {
                    "type": "object",
                    "properties": {
                      "price": {
                        "type": "number"
                      },
                      "cache": {
                        "type": "object",
                        "properties": {
                          "read": {
                            "type": "number"
                          },
                          "write": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string"
                                },
                                "additionalProperties": {
                                  "type": "number"
                                }
                              }
                            ],
                            "description": "Cache write price, or prices keyed by lifetime."
                          },
                          "storage": {
                            "type": "number"
                          },
                          "explicit": {
                            "type": "object",
                            "properties": {
                              "read": {
                                "type": "number"
                              },
                              "write": {
                                "anyOf": [
                                  {
                                    "type": "number"
                                  },
                                  {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "type": "number"
                                    }
                                  }
                                ],
                                "description": "Cache write price, or prices keyed by lifetime."
                              },
                              "storage": {
                                "type": "number"
                              }
                            },
                            "additionalProperties": {}
                          }
                        },
                        "additionalProperties": {}
                      },
                      "unit": {
                        "description": "Alternative source unit. Absent means per million tokens.",
                        "type": "string"
                      },
                      "overrides": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "when": {
                              "type": "object",
                              "properties": {
                                "context": {
                                  "type": "object",
                                  "properties": {
                                    "gt": {
                                      "type": "number"
                                    },
                                    "gte": {
                                      "type": "number"
                                    },
                                    "lt": {
                                      "type": "number"
                                    },
                                    "lte": {
                                      "type": "number"
                                    },
                                    "equals": {
                                      "type": "number"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "service_tier": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "region": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "date": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "utc_hours": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "utc_days": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "holiday": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "thinking": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "boolean"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "all": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/components/schemas/Provider/$defs/__schema0"
                                    }
                                  }
                                },
                                "any": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/components/schemas/Provider/$defs/__schema0"
                                    }
                                  }
                                },
                                "not": {
                                  "type": "object",
                                  "propertyNames": {
                                    "type": "string"
                                  },
                                  "additionalProperties": {
                                    "$ref": "#/components/schemas/Provider/$defs/__schema0"
                                  }
                                }
                              },
                              "additionalProperties": {},
                              "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
                            },
                            "price": {
                              "type": "number"
                            },
                            "cache": {
                              "type": "object",
                              "properties": {
                                "read": {
                                  "type": "number"
                                },
                                "write": {
                                  "anyOf": [
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "object",
                                      "propertyNames": {
                                        "type": "string"
                                      },
                                      "additionalProperties": {
                                        "type": "number"
                                      }
                                    }
                                  ],
                                  "description": "Cache write price, or prices keyed by lifetime."
                                },
                                "storage": {
                                  "type": "number"
                                },
                                "explicit": {
                                  "type": "object",
                                  "properties": {
                                    "read": {
                                      "type": "number"
                                    },
                                    "write": {
                                      "anyOf": [
                                        {
                                          "type": "number"
                                        },
                                        {
                                          "type": "object",
                                          "propertyNames": {
                                            "type": "string"
                                          },
                                          "additionalProperties": {
                                            "type": "number"
                                          }
                                        }
                                      ],
                                      "description": "Cache write price, or prices keyed by lifetime."
                                    },
                                    "storage": {
                                      "type": "number"
                                    }
                                  },
                                  "additionalProperties": {}
                                }
                              },
                              "additionalProperties": {}
                            }
                          },
                          "required": [
                            "when"
                          ],
                          "additionalProperties": {}
                        }
                      }
                    },
                    "additionalProperties": {}
                  },
                  "output": {
                    "type": "object",
                    "properties": {
                      "price": {
                        "type": "number"
                      },
                      "reasoning": {
                        "type": "number"
                      },
                      "unit": {
                        "type": "string"
                      },
                      "overrides": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "when": {
                              "type": "object",
                              "properties": {
                                "context": {
                                  "type": "object",
                                  "properties": {
                                    "gt": {
                                      "type": "number"
                                    },
                                    "gte": {
                                      "type": "number"
                                    },
                                    "lt": {
                                      "type": "number"
                                    },
                                    "lte": {
                                      "type": "number"
                                    },
                                    "equals": {
                                      "type": "number"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "service_tier": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "region": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "date": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "utc_hours": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "utc_days": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "holiday": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "string"
                                    },
                                    "in": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "gt": {
                                      "type": "string"
                                    },
                                    "gte": {
                                      "type": "string"
                                    },
                                    "lt": {
                                      "type": "string"
                                    },
                                    "lte": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "thinking": {
                                  "type": "object",
                                  "properties": {
                                    "equals": {
                                      "type": "boolean"
                                    }
                                  },
                                  "additionalProperties": {}
                                },
                                "all": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/components/schemas/Provider/$defs/__schema0"
                                    }
                                  }
                                },
                                "any": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/components/schemas/Provider/$defs/__schema0"
                                    }
                                  }
                                },
                                "not": {
                                  "type": "object",
                                  "propertyNames": {
                                    "type": "string"
                                  },
                                  "additionalProperties": {
                                    "$ref": "#/components/schemas/Provider/$defs/__schema0"
                                  }
                                }
                              },
                              "additionalProperties": {},
                              "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
                            },
                            "price": {
                              "type": "number"
                            },
                            "reasoning": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "when"
                          ],
                          "additionalProperties": {}
                        }
                      }
                    },
                    "additionalProperties": {}
                  }
                },
                "additionalProperties": {},
                "description": "Text prices in USD per million tokens unless a unit is specified. Missing is unknown; zero is a listed zero price."
              },
              "multipliers": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "when": {
                      "type": "object",
                      "properties": {
                        "context": {
                          "type": "object",
                          "properties": {
                            "gt": {
                              "type": "number"
                            },
                            "gte": {
                              "type": "number"
                            },
                            "lt": {
                              "type": "number"
                            },
                            "lte": {
                              "type": "number"
                            },
                            "equals": {
                              "type": "number"
                            }
                          },
                          "additionalProperties": {}
                        },
                        "service_tier": {
                          "type": "object",
                          "properties": {
                            "equals": {
                              "type": "string"
                            },
                            "in": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "gt": {
                              "type": "string"
                            },
                            "gte": {
                              "type": "string"
                            },
                            "lt": {
                              "type": "string"
                            },
                            "lte": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": {}
                        },
                        "region": {
                          "type": "object",
                          "properties": {
                            "equals": {
                              "type": "string"
                            },
                            "in": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "gt": {
                              "type": "string"
                            },
                            "gte": {
                              "type": "string"
                            },
                            "lt": {
                              "type": "string"
                            },
                            "lte": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": {}
                        },
                        "date": {
                          "type": "object",
                          "properties": {
                            "equals": {
                              "type": "string"
                            },
                            "in": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "gt": {
                              "type": "string"
                            },
                            "gte": {
                              "type": "string"
                            },
                            "lt": {
                              "type": "string"
                            },
                            "lte": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": {}
                        },
                        "utc_hours": {
                          "type": "object",
                          "properties": {
                            "equals": {
                              "type": "string"
                            },
                            "in": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "gt": {
                              "type": "string"
                            },
                            "gte": {
                              "type": "string"
                            },
                            "lt": {
                              "type": "string"
                            },
                            "lte": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": {}
                        },
                        "utc_days": {
                          "type": "object",
                          "properties": {
                            "equals": {
                              "type": "string"
                            },
                            "in": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "gt": {
                              "type": "string"
                            },
                            "gte": {
                              "type": "string"
                            },
                            "lt": {
                              "type": "string"
                            },
                            "lte": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": {}
                        },
                        "holiday": {
                          "type": "object",
                          "properties": {
                            "equals": {
                              "type": "string"
                            },
                            "in": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "gt": {
                              "type": "string"
                            },
                            "gte": {
                              "type": "string"
                            },
                            "lt": {
                              "type": "string"
                            },
                            "lte": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": {}
                        },
                        "thinking": {
                          "type": "object",
                          "properties": {
                            "equals": {
                              "type": "boolean"
                            }
                          },
                          "additionalProperties": {}
                        },
                        "all": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "$ref": "#/components/schemas/Provider/$defs/__schema0"
                            }
                          }
                        },
                        "any": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "$ref": "#/components/schemas/Provider/$defs/__schema0"
                            }
                          }
                        },
                        "not": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/components/schemas/Provider/$defs/__schema0"
                          }
                        }
                      },
                      "additionalProperties": {},
                      "description": "Conditions for a price override or multiplier. Composite and future conditions are preserved as JSON."
                    },
                    "factor": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "object",
                          "properties": {
                            "text": {
                              "anyOf": [
                                {
                                  "type": "number"
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "input": {
                                      "anyOf": [
                                        {
                                          "type": "number"
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "price": {
                                              "type": "number"
                                            },
                                            "cache": {
                                              "type": "object",
                                              "properties": {
                                                "read": {
                                                  "type": "number"
                                                },
                                                "write": {
                                                  "anyOf": [
                                                    {
                                                      "type": "number"
                                                    },
                                                    {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string"
                                                      },
                                                      "additionalProperties": {
                                                        "type": "number"
                                                      }
                                                    }
                                                  ],
                                                  "description": "Cache write price, or prices keyed by lifetime."
                                                },
                                                "storage": {
                                                  "type": "number"
                                                },
                                                "explicit": {
                                                  "type": "object",
                                                  "properties": {
                                                    "read": {
                                                      "type": "number"
                                                    },
                                                    "write": {
                                                      "anyOf": [
                                                        {
                                                          "type": "number"
                                                        },
                                                        {
                                                          "type": "object",
                                                          "propertyNames": {
                                                            "type": "string"
                                                          },
                                                          "additionalProperties": {
                                                            "type": "number"
                                                          }
                                                        }
                                                      ],
                                                      "description": "Cache write price, or prices keyed by lifetime."
                                                    },
                                                    "storage": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "additionalProperties": {}
                                                }
                                              },
                                              "additionalProperties": {}
                                            }
                                          },
                                          "additionalProperties": {}
                                        }
                                      ]
                                    },
                                    "output": {
                                      "anyOf": [
                                        {
                                          "type": "number"
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "price": {
                                              "type": "number"
                                            },
                                            "reasoning": {
                                              "type": "number"
                                            }
                                          },
                                          "additionalProperties": {}
                                        }
                                      ]
                                    }
                                  },
                                  "additionalProperties": {}
                                }
                              ]
                            }
                          },
                          "additionalProperties": {}
                        }
                      ]
                    }
                  },
                  "required": [
                    "when",
                    "factor"
                  ],
                  "additionalProperties": {}
                }
              }
            },
            "additionalProperties": {},
            "description": "List prices and conditional changes. Other modalities and future price fields are passed through unchanged."
          },
          "modalities": {
            "type": "object",
            "properties": {
              "input": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "output": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": {}
          },
          "api": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "object",
              "properties": {
                "base_url": {
                  "type": "string"
                },
                "path": {
                  "type": "string"
                },
                "sdk": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "capabilities": {
                  "type": "object",
                  "properties": {
                    "cache": {
                      "anyOf": [
                        {
                          "type": "boolean",
                          "const": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "implicit": {
                              "anyOf": [
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "ttl": {
                                      "description": "Documented lifetimes, such as 5m or 1h.",
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "min_tokens": {
                                      "type": "number",
                                      "minimum": 0
                                    },
                                    "max_breakpoints": {
                                      "type": "number",
                                      "minimum": 0
                                    },
                                    "targets": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    }
                                  },
                                  "additionalProperties": {}
                                }
                              ]
                            },
                            "explicit": {
                              "anyOf": [
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "ttl": {
                                      "description": "Documented lifetimes, such as 5m or 1h.",
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "min_tokens": {
                                      "type": "number",
                                      "minimum": 0
                                    },
                                    "max_breakpoints": {
                                      "type": "number",
                                      "minimum": 0
                                    },
                                    "targets": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    }
                                  },
                                  "additionalProperties": {}
                                }
                              ]
                            }
                          },
                          "additionalProperties": {}
                        }
                      ],
                      "description": "False explicitly disables caching. Missing modes are unknown."
                    },
                    "temperature": {
                      "type": "boolean"
                    },
                    "top_k": {
                      "type": "boolean"
                    },
                    "top_p": {
                      "type": "boolean"
                    },
                    "structured_output": {
                      "type": "boolean"
                    },
                    "prompt_cache_key": {
                      "type": "boolean"
                    },
                    "store": {
                      "type": "boolean"
                    },
                    "stream_usage": {
                      "type": "boolean"
                    },
                    "system_updates": {
                      "type": "boolean"
                    },
                    "effort_updates": {
                      "type": "boolean"
                    },
                    "service_tier": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "tools": {
                      "type": "object",
                      "properties": {
                        "supported": {
                          "type": "boolean"
                        },
                        "choice": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "freeform": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "strict": {
                          "type": "boolean"
                        },
                        "updates": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": {}
                    },
                    "reasoning": {
                      "type": "object",
                      "properties": {
                        "supported": {
                          "type": "boolean"
                        },
                        "toggle": {
                          "type": "boolean"
                        },
                        "effort": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "budget": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "additionalProperties": {}
                        },
                        "default": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string"
                            },
                            "value": {
                              "type": [
                                "boolean",
                                "string",
                                "number"
                              ]
                            }
                          },
                          "additionalProperties": {}
                        }
                      },
                      "additionalProperties": {}
                    }
                  },
                  "additionalProperties": {},
                  "description": "Documented capabilities. Missing fields remain unknown."
                },
                "compatibility": {
                  "type": "object",
                  "properties": {
                    "max_tokens_field": {
                      "type": "string"
                    },
                    "reasoning_field": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": {}
                }
              },
              "additionalProperties": {}
            }
          },
          "providers_dev": {
            "type": "object",
            "properties": {
              "origin": {
                "type": "string",
                "enum": [
                  "upstream",
                  "added"
                ],
                "description": "upstream = the entry is imported from models.dev. added = models.dev has no entry for this access method."
              },
              "access": {
                "type": "string",
                "enum": [
                  "api",
                  "subscription",
                  "unknown"
                ]
              },
              "provenance": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "path": {
                      "type": "string",
                      "description": "The field, for example limit.context."
                    },
                    "op": {
                      "type": "string",
                      "enum": [
                        "set",
                        "unknown",
                        "delete"
                      ],
                      "description": "set = a value is published; unknown = published as unknown on purpose; delete = removed."
                    },
                    "value": {
                      "description": "The published value. Null unless op is set.",
                      "$ref": "#/components/schemas/Provider/$defs/__schema1"
                    },
                    "had_upstream": {
                      "type": "boolean",
                      "description": "Whether models.dev has a value for the field."
                    },
                    "upstream": {
                      "description": "What models.dev says. Null unless had_upstream is true.",
                      "$ref": "#/components/schemas/Provider/$defs/__schema1"
                    },
                    "reason": {
                      "type": "string"
                    },
                    "evidence": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "documented",
                              "measured",
                              "listed"
                            ],
                            "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "date": {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                            "description": "When the source was read or the measurement taken."
                          },
                          "note": {
                            "description": "What the source says. Null = no note.",
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "kind",
                          "url",
                          "date",
                          "note"
                        ],
                        "additionalProperties": false,
                        "description": "A source for something providers.dev publishes."
                      }
                    }
                  },
                  "required": [
                    "path",
                    "op",
                    "value",
                    "had_upstream",
                    "upstream",
                    "reason",
                    "evidence"
                  ],
                  "additionalProperties": false,
                  "description": "One correction by providers.dev to a field imported from models.dev."
                },
                "description": "Corrections to imported fields. Empty = none."
              },
              "inherited": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "from": {
                        "type": "string"
                      },
                      "fields": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "from",
                      "fields"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Fields an added entry takes from another entry: identity, and cost where a subscription entry carries the API list price. Null = nothing is inherited."
              },
              "cache": {
                "type": "object",
                "properties": {
                  "documented": {
                    "type": "object",
                    "properties": {
                      "support": {
                        "type": "string",
                        "enum": [
                          "supported",
                          "unsupported",
                          "unknown"
                        ]
                      },
                      "modes": {
                        "type": "object",
                        "properties": {
                          "implicit": {
                            "type": "object",
                            "properties": {
                              "support": {
                                "type": "string",
                                "enum": [
                                  "supported",
                                  "unsupported",
                                  "unknown"
                                ],
                                "description": "An absent mode is unknown. Only an explicit negative means unsupported."
                              },
                              "min_tokens": {
                                "description": "Minimum prompt size in tokens. Null = unknown.",
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "max_breakpoints": {
                                "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "targets": {
                                "anyOf": [
                                  {
                                    "type": "array",
                                    "items": {
                                      "type": "string"
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Parts of the request that can be cached. Null = unknown or not applicable."
                              }
                            },
                            "required": [
                              "support",
                              "min_tokens",
                              "max_breakpoints",
                              "targets"
                            ],
                            "additionalProperties": false
                          },
                          "explicit": {
                            "type": "object",
                            "properties": {
                              "support": {
                                "type": "string",
                                "enum": [
                                  "supported",
                                  "unsupported",
                                  "unknown"
                                ],
                                "description": "An absent mode is unknown. Only an explicit negative means unsupported."
                              },
                              "min_tokens": {
                                "description": "Minimum prompt size in tokens. Null = unknown.",
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "max_breakpoints": {
                                "description": "Maximum cache markers. Null = unknown or not applicable to this mode.",
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "targets": {
                                "anyOf": [
                                  {
                                    "type": "array",
                                    "items": {
                                      "type": "string"
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Parts of the request that can be cached. Null = unknown or not applicable."
                              }
                            },
                            "required": [
                              "support",
                              "min_tokens",
                              "max_breakpoints",
                              "targets"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "implicit",
                          "explicit"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "support",
                      "modes"
                    ],
                    "additionalProperties": false,
                    "description": "Documented caching normalized for the API and every page. Unknown stays distinct from unsupported."
                  },
                  "retention": {
                    "type": "object",
                    "properties": {
                      "support": {
                        "type": "string",
                        "enum": [
                          "supported",
                          "unsupported",
                          "unknown"
                        ],
                        "description": "Whether a request parameter controls retention, confirmed by explicit evidence. A sent parameter or a cache hit alone leaves this unknown."
                      },
                      "parameter": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1
                              },
                              "location": {
                                "type": "string",
                                "minLength": 1
                              }
                            },
                            "required": [
                              "name",
                              "location"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The confirmed request field and its location. Null = unknown."
                      },
                      "accepted_values": {
                        "anyOf": [
                          {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Values explicitly confirmed by the evidence. Requested values alone are not accepted values. Null = unknown."
                      },
                      "default": {
                        "description": "The lifetime when the parameter is omitted. Null = unknown.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "profiles": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "enum": [
                                "short",
                                "long"
                              ],
                              "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
                            },
                            "value": {
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          },
                          "required": [
                            "profile",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        "description": "Confirmed short and long settings. A null value means omit the parameter. Empty = unknown."
                      },
                      "conditions": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Restrictions by client, protocol or header."
                      },
                      "evidence": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "enum": [
                                "documented",
                                "measured"
                              ]
                            },
                            "url": {
                              "type": "string",
                              "format": "uri"
                            },
                            "date": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "note": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "kind",
                            "url",
                            "date",
                            "note"
                          ],
                          "additionalProperties": false
                        },
                        "description": "Evidence for parameter support, values and conditions."
                      }
                    },
                    "required": [
                      "support",
                      "parameter",
                      "accepted_values",
                      "default",
                      "profiles",
                      "conditions",
                      "evidence"
                    ],
                    "additionalProperties": false,
                    "description": "Confirmed retention controls. Observed cache behavior and requested settings are published separately in evaluations."
                  },
                  "lifetime": {
                    "type": "object",
                    "properties": {
                      "short": {
                        "type": "object",
                        "properties": {
                          "safe_s": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
                          },
                          "basis": {
                            "type": "string",
                            "enum": [
                              "measured",
                              "documented",
                              "none"
                            ],
                            "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
                          },
                          "source": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "providers.dev",
                                  "models.dev"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
                          },
                          "date": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
                          },
                          "documented_s": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
                          },
                          "measured_s": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
                          },
                          "documented_status": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "contradicted",
                                  "not_contradicted"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
                          },
                          "clients": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "How many clients were measured. 0 = not measured."
                          },
                          "evaluations": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "How many evaluations were counted. 0 = not measured."
                          },
                          "checks": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "Re-sends made in them, the control included."
                          },
                          "hits": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "How many of those were served from the cache."
                          },
                          "checks_inside": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
                          },
                          "hits_inside": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "How many of checks_inside were served from the cache. Null with checks_inside."
                          },
                          "tested_from_s": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
                          },
                          "first_miss_s": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
                          }
                        },
                        "required": [
                          "safe_s",
                          "basis",
                          "source",
                          "date",
                          "documented_s",
                          "measured_s",
                          "documented_status",
                          "clients",
                          "evaluations",
                          "checks",
                          "hits",
                          "checks_inside",
                          "hits_inside",
                          "tested_from_s",
                          "first_miss_s"
                        ],
                        "additionalProperties": false,
                        "description": "The short profile: no lifetime asked for, or the shortest documented one."
                      },
                      "long": {
                        "type": "object",
                        "properties": {
                          "safe_s": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
                          },
                          "basis": {
                            "type": "string",
                            "enum": [
                              "measured",
                              "documented",
                              "none"
                            ],
                            "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
                          },
                          "source": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "providers.dev",
                                  "models.dev"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
                          },
                          "date": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
                          },
                          "documented_s": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
                          },
                          "measured_s": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
                          },
                          "documented_status": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "contradicted",
                                  "not_contradicted"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
                          },
                          "clients": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "How many clients were measured. 0 = not measured."
                          },
                          "evaluations": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "How many evaluations were counted. 0 = not measured."
                          },
                          "checks": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "Re-sends made in them, the control included."
                          },
                          "hits": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "How many of those were served from the cache."
                          },
                          "checks_inside": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
                          },
                          "hits_inside": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "How many of checks_inside were served from the cache. Null with checks_inside."
                          },
                          "tested_from_s": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
                          },
                          "first_miss_s": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
                          }
                        },
                        "required": [
                          "safe_s",
                          "basis",
                          "source",
                          "date",
                          "documented_s",
                          "measured_s",
                          "documented_status",
                          "clients",
                          "evaluations",
                          "checks",
                          "hits",
                          "checks_inside",
                          "hits_inside",
                          "tested_from_s",
                          "first_miss_s"
                        ],
                        "additionalProperties": false,
                        "description": "The long profile: a longer lifetime asked for."
                      },
                      "lifetimes": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "retention_profile": {
                              "type": "string",
                              "enum": [
                                "short",
                                "long"
                              ],
                              "description": "Documented: short for the shortest lifetime the entry documents, long for every other. Measured: the profile of its evaluations."
                            },
                            "basis": {
                              "type": "string",
                              "enum": [
                                "measured",
                                "documented"
                              ],
                              "description": "documented = a lifetime the source documents. measured = what the evaluations of one client with one retention setting showed. Says which of the keys below apply."
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "providers.dev",
                                "models.dev"
                              ],
                              "description": "Documented: models.dev, or providers.dev where the lifetime is a providers.dev correction or the entry is one providers.dev added. Measured: always providers.dev."
                            },
                            "date": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Documented: the import date for models.dev, the newest evidence date for providers.dev. Measured: the newest of its evaluations. Null = the source has no date."
                            },
                            "lifetime_s": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "Documented: the lifetime in whole seconds; 0 only on the item that says the entry does not cache. A documented text that is not a whole number of seconds above 0 is no item. Measured: the oldest tested age through which every check of every one of its evaluations hit; 0 = no such age."
                            },
                            "mode": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "implicit",
                                    "explicit"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Documented: the way of caching the lifetime is documented for. Null on the item that says the entry does not cache, and on a measured item."
                            },
                            "documented_as": {
                              "description": "Documented: the lifetime as the source writes it, for example 5m. Null on the item that says the entry does not cache, and on a measured item.",
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "client": {
                              "description": "Measured: the public id of the client the requests went through, as on the evaluations. Null on a documented item.",
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "client_label": {
                              "description": "Measured: its public label. Null on a documented item.",
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "parameter": {
                              "description": "Measured: the request field that asked for the lifetime, as on the evaluations. Null = no lifetime was asked for, and on a documented item.",
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "value": {
                              "description": "Measured: the value sent in it. Null together with parameter.",
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "evaluations": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "Measured: how many evaluations the item is made from, at least 1. 0 on a documented item."
                            },
                            "evaluation_ids": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "Measured: their ids, sorted, as in the entry's evaluations and in /api/v1/evaluations/cache. Empty on a documented item."
                            },
                            "checks": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "Measured: re-sends made in them, the control included. 0 on a documented item."
                            },
                            "hits": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "Measured: how many of those were served from the cache. 0 on a documented item."
                            },
                            "tested_from_s": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Measured: the youngest timed age any of them checked; no younger age was checked. Null = none made a timed check, and on a documented item."
                            },
                            "first_miss_s": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Measured: the youngest age at which any of them had a check that missed; 0 = the immediate re-send. Null = no miss, and on a documented item."
                            },
                            "results": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "enum": [
                                          "control",
                                          "timed"
                                        ],
                                        "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                                      },
                                      "age_s": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                                      },
                                      "hits": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "description": "Re-sends served from the cache."
                                      },
                                      "checks": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "description": "Re-sends made. An age nobody checked has no result at all."
                                      },
                                      "hit_rate_pct": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 100,
                                        "description": "hits / checks, in percent, two decimals."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "age_s",
                                      "hits",
                                      "checks",
                                      "hit_rate_pct"
                                    ],
                                    "additionalProperties": false,
                                    "description": "What was seen at one age."
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Measured: the results of its evaluations added up by exact age, the control first. lifetime_s is read from each evaluation on its own and the lowest taken, so on an item of several evaluations it can be below what these sums show. Null on a documented item."
                            }
                          },
                          "required": [
                            "retention_profile",
                            "basis",
                            "source",
                            "date",
                            "lifetime_s",
                            "mode",
                            "documented_as",
                            "client",
                            "client_label",
                            "parameter",
                            "value",
                            "evaluations",
                            "evaluation_ids",
                            "checks",
                            "hits",
                            "tested_from_s",
                            "first_miss_s",
                            "results"
                          ],
                          "additionalProperties": false,
                          "description": "One lifetime of an entry: documented by a source, or measured for one client with one retention setting. One shape for both; the keys of the other kind are null, 0 or empty."
                        },
                        "description": "Every lifetime known for the entry: short, then long; in each, the documented items by seconds, implicit before explicit, then by text; then the measured ones, the setting that asked for no lifetime first, then by seconds and value, then by client, then by parameter. Text is compared in plain character order. Empty = none is known."
                      }
                    },
                    "required": [
                      "short",
                      "long",
                      "lifetimes"
                    ],
                    "additionalProperties": false,
                    "description": "Every cache lifetime of an entry in one list, and the safe value of each retention profile. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee."
                  },
                  "evaluations": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "The id of the evaluation in the results repository."
                        },
                        "route": {
                          "type": "string",
                          "description": "The access method the requests went through."
                        },
                        "route_label": {
                          "type": "string"
                        },
                        "client": {
                          "type": "string",
                          "description": "What sent the requests: direct, cliproxyapi, a coding tool."
                        },
                        "client_label": {
                          "type": "string"
                        },
                        "date": {
                          "type": "string",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                        },
                        "request_settings": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/components/schemas/Provider/$defs/__schema1"
                          },
                          "description": "What the requests were sent with, as recorded: format, reasoning effort, lifetime and so on."
                        },
                        "retention_profile": {
                          "type": "string",
                          "enum": [
                            "short",
                            "long"
                          ],
                          "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
                        },
                        "parameter": {
                          "description": "The request field that asked for the lifetime, for example cache_control.ttl, prompt_cache_retention or prompt_cache_options.ttl. Null = no lifetime was asked for.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "value": {
                          "description": "The value sent in it, for example 1h. Null together with parameter.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "control",
                                  "timed"
                                ],
                                "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                              },
                              "age_s": {
                                "type": "integer",
                                "minimum": 0,
                                "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                              },
                              "hits": {
                                "type": "integer",
                                "minimum": 0,
                                "description": "Re-sends served from the cache."
                              },
                              "checks": {
                                "type": "integer",
                                "minimum": 1,
                                "description": "Re-sends made. An age nobody checked has no result at all."
                              },
                              "hit_rate_pct": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 100,
                                "description": "hits / checks, in percent, two decimals."
                              }
                            },
                            "required": [
                              "kind",
                              "age_s",
                              "hits",
                              "checks",
                              "hit_rate_pct"
                            ],
                            "additionalProperties": false,
                            "description": "What was seen at one age."
                          },
                          "description": "One result per exact age, the control first."
                        },
                        "late_excluded": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Checks left out because they ran too late for their age. Null = the evaluation does not record it."
                        },
                        "note": {
                          "description": "Null = no note.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "source": {
                          "type": "string",
                          "format": "uri",
                          "description": "The raw result."
                        }
                      },
                      "required": [
                        "id",
                        "route",
                        "route_label",
                        "client",
                        "client_label",
                        "date",
                        "request_settings",
                        "retention_profile",
                        "parameter",
                        "value",
                        "results",
                        "late_excluded",
                        "note",
                        "source"
                      ],
                      "additionalProperties": false,
                      "description": "One cache evaluation: a fresh prompt cached once, then sent again at once and at set ages."
                    },
                    "description": "Every published evaluation of the entry, each with its own results, newest first, then by id in plain character order. The measured items of lifetime name them by id."
                  }
                },
                "required": [
                  "documented",
                  "retention",
                  "lifetime",
                  "evaluations"
                ],
                "additionalProperties": false,
                "description": "Documented caching, confirmed retention controls and evaluations, shared by the website and API."
              },
              "pricing": {
                "type": "object",
                "properties": {
                  "coverage": {
                    "type": "string",
                    "enum": [
                      "unknown",
                      "partial",
                      "complete",
                      "not_applicable"
                    ],
                    "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
                  },
                  "billing": {
                    "type": "string",
                    "enum": [
                      "per_use",
                      "reference",
                      "not_applicable",
                      "unknown"
                    ],
                    "description": "per_use = the entry is billed at these rates. reference = a subscription entry: the rates are the API list prices of reference_ref, not the subscription's bill. not_applicable = a subscription entry with no API entry of the same model to refer to. unknown = rates are listed for the entry and what they bill is not established."
                  },
                  "reference_ref": {
                    "description": "With billing = reference: the API entry the rates are taken from. That is the entry a providers.dev entry inherits from, or the entry of the lab's own provider for the same canonical model. Otherwise null.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "rules": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1
                            },
                            "when": {
                              "anyOf": [
                                {
                                  "$ref": "#/components/schemas/Provider/$defs/__schema2"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Null = unconditional base rule. A condition with kind=unknown remains unresolved."
                            },
                            "meter": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The charge affected. For text: text.input, text.output, text.reasoning_output, text.cache_read, text.cache_write, text.cache_storage. The same charges exist for audio, image and video (audio.input, image.output, video.output and so on), each priced in its own unit. web_search is the charge for web searches. A multiply rule names one charge or a scope: text.* is every text charge, audio.* every audio charge, * every charge."
                            },
                            "operation": {
                              "type": "string",
                              "enum": [
                                "set",
                                "multiply"
                              ]
                            },
                            "amount": {
                              "type": "number",
                              "minimum": 0,
                              "description": "A price for set, or a factor for multiply. Zero is a known zero, never missing."
                            },
                            "currency": {
                              "description": "ISO currency for a price; null for multipliers or an unknown currency.",
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "unit": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "For example token, character, request, second or token_hour."
                                    },
                                    "quantity": {
                                      "anyOf": [
                                        {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "quantity"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Billing unit and scale. Null for multipliers or an unknown unit."
                            },
                            "applies_to": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "all_usage",
                                    "above_threshold"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "all_usage = the rate holds for the whole request that matches the condition. above_threshold = only for the part above a size threshold. Imported rules are all_usage: models.dev evaluates a condition per request, and a matching rule prices that request. Null = not established; never infer marginal billing."
                            },
                            "source_path": {
                              "description": "Field in the original cost record. Null for a separately authored rule.",
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "period": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "peak",
                                    "off_peak"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Set on a rule whose condition reads the time of day or the day of the week (request.utc_hours, request.utc_days): peak = the rule raises the base rate in its window, off_peak = it lowers it. The base rate is the price outside the window. Null = not a time rule, or one that leaves the base rate as it is."
                            },
                            "resulting_rates": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "meter": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "amount": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "currency": {
                                        "type": [
                                          "string",
                                          "null"
                                        ]
                                      },
                                      "unit": {
                                        "anyOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "name": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "For example token, character, request, second or token_hour."
                                              },
                                              "quantity": {
                                                "anyOf": [
                                                  {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ],
                                                "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                                              }
                                            },
                                            "required": [
                                              "name",
                                              "quantity"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      }
                                    },
                                    "required": [
                                      "meter",
                                      "amount",
                                      "currency",
                                      "unit"
                                    ],
                                    "additionalProperties": false,
                                    "description": "A base rate after a multiplier."
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "On a multiply rule: each unconditional base rate in its scope times the factor, which is the price when this rule applies and no other conditional rule does. Null on a set rule, whose amount is the rate itself, and on a multiply rule with no base rate in its scope."
                            }
                          },
                          "required": [
                            "id",
                            "when",
                            "meter",
                            "operation",
                            "amount",
                            "currency",
                            "unit",
                            "applies_to",
                            "source_path",
                            "period",
                            "resulting_rates"
                          ],
                          "additionalProperties": false
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Base prices, conditional replacements and multipliers. Null = unknown. [] proves no rules only with complete coverage."
                  },
                  "rule_order": {
                    "anyOf": [
                      {
                        "type": "string",
                        "const": "listed"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "listed = process matching rules in array order per meter: set replaces the rate and multiply scales it. Imported rules are listed: base rates first, then models.dev's overrides in their order, then its multipliers, which is how models.dev defines a price. Null = combination precedence is unconfirmed; this record cannot produce an authoritative combined quote."
                  },
                  "unparsed": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string"
                        },
                        "value": {
                          "$ref": "#/components/schemas/Provider/$defs/__schema5"
                        }
                      },
                      "required": [
                        "path",
                        "value"
                      ],
                      "additionalProperties": false
                    },
                    "description": "Source fields not normalized, retained without loss. Nonempty means coverage is partial."
                  },
                  "evidence": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "documented",
                            "measured"
                          ]
                        },
                        "url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "date": {
                          "anyOf": [
                            {
                              "type": "string",
                              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "note": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "url",
                        "date",
                        "note"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "coverage",
                  "billing",
                  "reference_ref",
                  "rules",
                  "rule_order",
                  "unparsed",
                  "evidence"
                ],
                "additionalProperties": false,
                "description": "Normalized pricing present on every entry and summary. Source imports are partial unless completeness is explicitly confirmed. Unknown applicability, units or rule interactions must not silently resolve to a base price."
              },
              "request_controls": {
                "type": "object",
                "properties": {
                  "coverage": {
                    "type": "string",
                    "enum": [
                      "unknown",
                      "partial",
                      "complete",
                      "not_applicable"
                    ],
                    "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Semantic id, e.g. cache.retention or service_tier; independent of the provider's wire field."
                        },
                        "support": {
                          "type": "string",
                          "enum": [
                            "supported",
                            "unsupported",
                            "unknown"
                          ]
                        },
                        "when": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/Provider/$defs/__schema2"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Scope of the support claim: endpoint, protocol, region or another request condition."
                        },
                        "bindings": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "location": {
                                    "type": "string",
                                    "enum": [
                                      "header",
                                      "body",
                                      "query"
                                    ]
                                  },
                                  "path": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                                  },
                                  "scope": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "request",
                                          "content_block"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Where the binding is applied. Null = scope unknown."
                                  }
                                },
                                "required": [
                                  "location",
                                  "path",
                                  "scope"
                                ],
                                "additionalProperties": false
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Known places this control is sent. Null means transport is unconfirmed, even when support is documented."
                        },
                        "options": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "value": {
                                    "description": "The provider's actual accepted value, not a display alias.",
                                    "$ref": "#/components/schemas/Provider/$defs/__schema6"
                                  },
                                  "attributes": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string"
                                        },
                                        "additionalProperties": {
                                          "$ref": "#/components/schemas/Provider/$defs/__schema7"
                                        }
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Normalized meaning when known, e.g. retention_s: 3600 and profile: long. Short/long alone never specifies a duration."
                                  },
                                  "settings": {
                                    "anyOf": [
                                      {
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "location": {
                                              "type": "string",
                                              "enum": [
                                                "header",
                                                "body",
                                                "query"
                                              ]
                                            },
                                            "path": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                                            },
                                            "scope": {
                                              "anyOf": [
                                                {
                                                  "type": "string",
                                                  "enum": [
                                                    "request",
                                                    "content_block"
                                                  ]
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ],
                                              "description": "Where the binding is applied. Null = scope unknown."
                                            },
                                            "value": {
                                              "$ref": "#/components/schemas/Provider/$defs/__schema8"
                                            }
                                          },
                                          "required": [
                                            "location",
                                            "path",
                                            "scope",
                                            "value"
                                          ],
                                          "additionalProperties": false
                                        }
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Exact fields and any companion headers for this option. Null = transport unknown."
                                  },
                                  "when": {
                                    "anyOf": [
                                      {
                                        "$ref": "#/components/schemas/Provider/$defs/__schema2"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "value",
                                  "attributes",
                                  "settings",
                                  "when"
                                ],
                                "additionalProperties": false
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "default": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "value": {
                                  "$ref": "#/components/schemas/Provider/$defs/__schema9"
                                }
                              },
                              "required": [
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Known default wrapped in value so an explicit JSON null differs from an unknown default."
                        },
                        "conditions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Source restrictions not yet represented as condition trees. Nonempty means a caller must not treat the control as unconditional."
                        },
                        "evidence": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "documented",
                                  "measured"
                                ]
                              },
                              "url": {
                                "type": "string",
                                "format": "uri"
                              },
                              "date": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "note": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "kind",
                              "url",
                              "date",
                              "note"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "support",
                        "when",
                        "bindings",
                        "options",
                        "default",
                        "conditions",
                        "evidence"
                      ],
                      "additionalProperties": false
                    },
                    "description": "Always includes cache.retention and service_tier. Additional controls use the same schema. No control is inherited across access routes."
                  }
                },
                "required": [
                  "coverage",
                  "items"
                ],
                "additionalProperties": false
              },
              "limits": {
                "type": "object",
                "properties": {
                  "measured": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "route": {
                          "type": "string"
                        },
                        "route_label": {
                          "type": "string"
                        },
                        "client": {
                          "type": "string"
                        },
                        "client_label": {
                          "type": "string"
                        },
                        "context": {
                          "description": "Tokens: the context window found. Null = this evaluation did not measure it.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "output": {
                          "description": "Tokens: the largest response found. Null = not measured.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "input_accepted": {
                          "description": "Tokens: the largest input seen accepted. The real limit is at least this. Null = not measured.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "input_refused": {
                          "description": "Tokens: the smallest input seen refused. The real limit is below this. Null = not measured.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "input_read": {
                          "description": "Tokens: the largest input for which the reply showed the route read it to the end (a word before the filler and one after it, both returned). Never above input_accepted. Null = not checked.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "output_accepted": {
                          "description": "Tokens: the largest requested output seen accepted. Null = not measured.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "note": {
                          "description": "Null = no note.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "date": {
                          "anyOf": [
                            {
                              "type": "string",
                              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The day the requests were sent: the evaluation's own date, else the date in the name of its results folder. Null = the result carries no date."
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      },
                      "required": [
                        "route",
                        "route_label",
                        "client",
                        "client_label",
                        "context",
                        "output",
                        "input_accepted",
                        "input_refused",
                        "input_read",
                        "output_accepted",
                        "note",
                        "date",
                        "source"
                      ],
                      "additionalProperties": false,
                      "description": "One limit evaluation. Every evaluation has every field; what it did not measure is null."
                    },
                    "description": "Limit evaluations on this entry. Empty = none."
                  },
                  "from_measurement": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "context",
                        "output"
                      ]
                    },
                    "description": "On an added entry: which of limit.context and limit.output are measured values. Empty = none."
                  },
                  "input_window": {
                    "type": "object",
                    "properties": {
                      "tokens": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The most input a request can carry on this entry, in tokens as the provider counts them, the client's own system prompt and tools included: documented_tokens unless a counted evaluation clearly contradicts it, else measured_tokens, else null. basis says which. Null = not known. Never 0."
                      },
                      "basis": {
                        "type": "string",
                        "enum": [
                          "documented",
                          "measured",
                          "none"
                        ],
                        "description": "documented: tokens is documented_tokens. measured: tokens is measured_tokens. none: exactly when tokens is null."
                      },
                      "bound": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "limit",
                              "at_least"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "limit: the value is the limit, as documented or as the route names it. at_least: the value is the largest input seen accepted, and the real limit is this or more; measured_refused, where set, is an input seen refused. A documented value is always limit. Null with none."
                      },
                      "scope": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "input",
                              "window"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "input: a figure for the input alone (limit.input, or an input size seen accepted). window: a context window that input and output share (limit.context, or a window the route names): the response is counted against the same figure. Null with none."
                      },
                      "source": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "providers.dev",
                              "models.dev"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Who the value is from. measured: always providers.dev. documented: documented_source. Null with none."
                      },
                      "date": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "measured: measured_date. documented: documented_date. Null with none, and where the source has no date."
                      },
                      "documented_tokens": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The documented input of the entry: limit.input where it is above 0, else limit.context where it is above 0 and not a measured value named in limits.from_measurement. 0 means none stated. Nothing is read from another entry. Null = none is documented."
                      },
                      "documented_field": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "limit.input",
                              "limit.context"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The field of the entry documented_tokens is read from. Null with documented_tokens."
                      },
                      "documented_source": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "providers.dev",
                              "models.dev"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "models.dev for an imported value; providers.dev for a correction of the field and for a value in an entry providers.dev added. Null with documented_tokens."
                      },
                      "documented_date": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The import date for models.dev; the newest evidence date for providers.dev. Null = none is documented, or the source has no date."
                      },
                      "documented_status": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "contradicted",
                              "not_contradicted"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "What the rule found of the documented value, where one is documented and at least one evaluation counts. contradicted: an evaluation names a window below it, names another window than a documented limit.context, refused an input at or below 99 % of it, or accepted one at or above 101 % of it; tokens is measured_tokens. not_contradicted: none does, and tokens is documented_tokens; that is not the same as confirmed. Null in every other case."
                      },
                      "measured_tokens": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The measured value of the entry: the lowest tokens of measurements, whatever the client. Null = no evaluation counts."
                      },
                      "measured_bound": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "limit",
                              "at_least"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The bound of the measurement that gives measured_tokens (measurements[0]). Null with measured_tokens."
                      },
                      "measured_kind": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "window",
                              "bracket",
                              "accepted"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Its kind. Null with measured_tokens."
                      },
                      "measured_refused": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Its refused where its kind is bracket: the smallest input it saw refused; the limit is below this. Null otherwise."
                      },
                      "measured_date": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Its date. Null with measured_tokens, and where the evaluation has no date."
                      },
                      "clients": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "How many different clients measurements has. 0 = not measured."
                      },
                      "evaluations": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "How many items measurements has: the limit evaluations of the entry that count. 0 = none counts."
                      },
                      "measurements": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "client": {
                              "type": "string",
                              "description": "The public id of the client the requests went through, as on the evaluation."
                            },
                            "client_label": {
                              "type": "string"
                            },
                            "route": {
                              "type": "string",
                              "description": "The access method the requests went through, as on the evaluation."
                            },
                            "route_label": {
                              "type": "string"
                            },
                            "date": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The day the requests were sent, as on the evaluation. Null = the result carries no date."
                            },
                            "tokens": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "description": "The value this evaluation gives: named for kind window, accepted for bracket, read for accepted."
                            },
                            "bound": {
                              "type": "string",
                              "enum": [
                                "limit",
                                "at_least"
                              ],
                              "description": "limit for kind window: the route named its limit. at_least for bracket and accepted: the largest input seen accepted; the real limit is this or more."
                            },
                            "kind": {
                              "type": "string",
                              "enum": [
                                "window",
                                "bracket",
                                "accepted"
                              ],
                              "description": "window: the route's own answer named its context window, and no smaller input was refused. bracket: an input was accepted and a larger one refused; the value is the accepted one. accepted: an input was accepted and the reply showed it was read to the end, nothing refused and no window named."
                            },
                            "accepted": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "input_accepted of the evaluation: the largest input seen accepted. Null = none recorded."
                            },
                            "refused": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "input_refused of the evaluation: the smallest input seen refused. Null = none."
                            },
                            "named": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "context of the evaluation: the window the route names. Null = it named none."
                            },
                            "read": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "input_read of the evaluation: the largest input the reply showed was read to the end. Null = not checked."
                            },
                            "source": {
                              "type": "string",
                              "format": "uri",
                              "description": "The raw result, as on the evaluation."
                            }
                          },
                          "required": [
                            "client",
                            "client_label",
                            "route",
                            "route_label",
                            "date",
                            "tokens",
                            "bound",
                            "kind",
                            "accepted",
                            "refused",
                            "named",
                            "read",
                            "source"
                          ],
                          "additionalProperties": false,
                          "description": "One limit evaluation of the entry that counts for the input window, with the value it gives. One route, one client, one model."
                        },
                        "description": "One item per counted limit evaluation, ordered by tokens, then limit before at_least, then by client, route, date and source in plain character order, null first. The first item gives the measured_* keys. Empty = none counts. An evaluation that does not count (a refusal with nothing accepted, an accepted size with no refusal, no named window and no read check, the output alone) stays in limits.measured and is in no item."
                      }
                    },
                    "required": [
                      "tokens",
                      "basis",
                      "bound",
                      "scope",
                      "source",
                      "date",
                      "documented_tokens",
                      "documented_field",
                      "documented_source",
                      "documented_date",
                      "documented_status",
                      "measured_tokens",
                      "measured_bound",
                      "measured_kind",
                      "measured_refused",
                      "measured_date",
                      "clients",
                      "evaluations",
                      "measurements"
                    ],
                    "additionalProperties": false,
                    "description": "How much input a request can carry on this entry, and what that rests on: the documented value, the measured one beside it, and which the rule chose. Worked out once when the data is built. What the documentation says and what evaluations found on their dates, not a guarantee."
                  }
                },
                "required": [
                  "measured",
                  "from_measurement",
                  "input_window"
                ],
                "additionalProperties": false
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "documented",
                        "measured",
                        "listed"
                      ],
                      "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "date": {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                      "description": "When the source was read or the measurement taken."
                    },
                    "note": {
                      "description": "What the source says. Null = no note.",
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "kind",
                    "url",
                    "date",
                    "note"
                  ],
                  "additionalProperties": false,
                  "description": "A source for something providers.dev publishes."
                },
                "description": "Sources for an added entry and for authored declarations. Empty = none."
              },
              "verified": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The newest date of providers.dev evidence or evaluations for this entry. Null = it has none."
              }
            },
            "required": [
              "origin",
              "access",
              "provenance",
              "inherited",
              "cache",
              "pricing",
              "request_controls",
              "limits",
              "evidence",
              "verified"
            ],
            "additionalProperties": false,
            "description": "Everything providers.dev adds to an entry. The same keys on every entry."
          }
        },
        "required": [
          "id",
          "name",
          "providers_dev"
        ],
        "additionalProperties": {},
        "description": "One entry in full: the models.dev record of the model at this provider, with providers_dev added. Fields not listed here are passed on from models.dev unchanged."
      },
      "description": "The provider's entries in full, by model id."
    },
    "providers_dev": {
      "type": "object",
      "properties": {
        "origin": {
          "type": "string",
          "enum": [
            "upstream",
            "added"
          ]
        },
        "access": {
          "type": "string",
          "enum": [
            "api",
            "subscription",
            "unknown"
          ]
        },
        "access_basis": {
          "type": "string",
          "description": "Why the provider is classified this way."
        },
        "access_reviewed": {
          "type": "boolean",
          "description": "False = classified by a general rule, not looked at one by one."
        },
        "access_source": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ],
          "description": "The source of the classification. Null = none recorded."
        },
        "note": {
          "type": [
            "string",
            "null"
          ]
        },
        "evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "documented",
                  "measured",
                  "listed"
                ],
                "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "date": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "When the source was read or the measurement taken."
              },
              "note": {
                "description": "What the source says. Null = no note.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "kind",
              "url",
              "date",
              "note"
            ],
            "additionalProperties": false,
            "description": "A source for something providers.dev publishes."
          },
          "description": "Sources for a provider that providers.dev added. Empty = none."
        },
        "provenance": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string",
                "description": "The field, for example limit.context."
              },
              "op": {
                "type": "string",
                "enum": [
                  "set",
                  "unknown",
                  "delete"
                ],
                "description": "set = a value is published; unknown = published as unknown on purpose; delete = removed."
              },
              "value": {
                "description": "The published value. Null unless op is set.",
                "$ref": "#/components/schemas/Provider/$defs/__schema1"
              },
              "had_upstream": {
                "type": "boolean",
                "description": "Whether models.dev has a value for the field."
              },
              "upstream": {
                "description": "What models.dev says. Null unless had_upstream is true.",
                "$ref": "#/components/schemas/Provider/$defs/__schema1"
              },
              "reason": {
                "type": "string"
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "documented",
                        "measured",
                        "listed"
                      ],
                      "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "date": {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                      "description": "When the source was read or the measurement taken."
                    },
                    "note": {
                      "description": "What the source says. Null = no note.",
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "kind",
                    "url",
                    "date",
                    "note"
                  ],
                  "additionalProperties": false,
                  "description": "A source for something providers.dev publishes."
                }
              }
            },
            "required": [
              "path",
              "op",
              "value",
              "had_upstream",
              "upstream",
              "reason",
              "evidence"
            ],
            "additionalProperties": false,
            "description": "One correction by providers.dev to a field imported from models.dev."
          },
          "description": "Corrections to the provider's imported fields. Empty = none."
        }
      },
      "required": [
        "origin",
        "access",
        "access_basis",
        "access_reviewed",
        "access_source",
        "note",
        "evidence",
        "provenance"
      ],
      "additionalProperties": false,
      "description": "Everything providers.dev adds to a provider. The same keys on every provider."
    }
  },
  "required": [
    "id",
    "name",
    "models",
    "providers_dev"
  ],
  "additionalProperties": {},
  "description": "One provider in full, in the models.dev structure.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Provider/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Provider/$defs/__schema0"
          }
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Provider/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Provider/$defs/__schema1"
          }
        }
      ]
    },
    "__schema2": {
      "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "predicate"
            },
            "field": {
              "type": "string",
              "minLength": 1
            },
            "op": {
              "type": "string",
              "enum": [
                "eq",
                "in",
                "gt",
                "gte",
                "lt",
                "lte",
                "min_items"
              ]
            },
            "value": {
              "$ref": "#/components/schemas/Provider/$defs/__schema3"
            }
          },
          "required": [
            "kind",
            "field",
            "op",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ]
            },
            "conditions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/Provider/$defs/__schema2"
              }
            }
          },
          "required": [
            "kind",
            "conditions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "not"
            },
            "condition": {
              "$ref": "#/components/schemas/Provider/$defs/__schema2"
            }
          },
          "required": [
            "kind",
            "condition"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "unknown"
            },
            "raw": {
              "$ref": "#/components/schemas/Provider/$defs/__schema4"
            }
          },
          "required": [
            "kind",
            "raw"
          ],
          "additionalProperties": false
        }
      ]
    },
    "__schema3": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Provider/$defs/__schema3"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Provider/$defs/__schema3"
          }
        }
      ]
    },
    "__schema4": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Provider/$defs/__schema4"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Provider/$defs/__schema4"
          }
        }
      ]
    },
    "__schema5": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Provider/$defs/__schema5"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Provider/$defs/__schema5"
          }
        }
      ]
    },
    "__schema6": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Provider/$defs/__schema6"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Provider/$defs/__schema6"
          }
        }
      ]
    },
    "__schema7": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Provider/$defs/__schema7"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Provider/$defs/__schema7"
          }
        }
      ]
    },
    "__schema8": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Provider/$defs/__schema8"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Provider/$defs/__schema8"
          }
        }
      ]
    },
    "__schema9": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Provider/$defs/__schema9"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Provider/$defs/__schema9"
          }
        }
      ]
    }
  }
}

CanonicalModel

A model as its lab names it, and how its entries compare.

Field (* required)TypeMeaning
id*stringlab/model: the canonical_id of its entries.
name*string
lab*string
reference_ref*string | nullThe entry at the lab's own provider, where the catalog has one.
entry_count*integer
subscription_entry_count*integer
evidence_entry_count*integer
context_min*number | nullThe smallest context window among its entries, in tokens. Null = no entry states one.
context_max*number | null
max_output_min*number | null
max_output_max*number | null
Full JSON Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "lab/model: the canonical_id of its entries."
    },
    "name": {
      "type": "string"
    },
    "lab": {
      "type": "string"
    },
    "reference_ref": {
      "description": "The entry at the lab's own provider, where the catalog has one.",
      "type": [
        "string",
        "null"
      ]
    },
    "entry_count": {
      "type": "integer",
      "minimum": 1
    },
    "subscription_entry_count": {
      "type": "integer",
      "minimum": 0
    },
    "evidence_entry_count": {
      "type": "integer",
      "minimum": 0
    },
    "context_min": {
      "description": "The smallest context window among its entries, in tokens. Null = no entry states one.",
      "type": [
        "number",
        "null"
      ]
    },
    "context_max": {
      "type": [
        "number",
        "null"
      ]
    },
    "max_output_min": {
      "type": [
        "number",
        "null"
      ]
    },
    "max_output_max": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "required": [
    "id",
    "name",
    "lab",
    "reference_ref",
    "entry_count",
    "subscription_entry_count",
    "evidence_entry_count",
    "context_min",
    "context_max",
    "max_output_min",
    "max_output_max"
  ],
  "additionalProperties": false,
  "description": "A model as its lab names it, and how its entries compare."
}

CanonicalModelDetail

A canonical model with every entry that serves it.

Field (* required)TypeMeaning
id*stringlab/model: the canonical_id of its entries.
name*string
lab*string
reference_ref*string | nullThe entry at the lab's own provider, where the catalog has one.
entry_count*integer
subscription_entry_count*integer
evidence_entry_count*integer
context_min*number | nullThe smallest context window among its entries, in tokens. Null = no entry states one.
context_max*number | null
max_output_min*number | null
max_output_max*number | null
entries*object[]Every entry for the model: the lab's own API first, then subscriptions, then the rest by provider.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "lab/model: the canonical_id of its entries."
    },
    "name": {
      "type": "string"
    },
    "lab": {
      "type": "string"
    },
    "reference_ref": {
      "description": "The entry at the lab's own provider, where the catalog has one.",
      "type": [
        "string",
        "null"
      ]
    },
    "entry_count": {
      "type": "integer",
      "minimum": 1
    },
    "subscription_entry_count": {
      "type": "integer",
      "minimum": 0
    },
    "evidence_entry_count": {
      "type": "integer",
      "minimum": 0
    },
    "context_min": {
      "description": "The smallest context window among its entries, in tokens. Null = no entry states one.",
      "type": [
        "number",
        "null"
      ]
    },
    "context_max": {
      "type": [
        "number",
        "null"
      ]
    },
    "max_output_min": {
      "type": [
        "number",
        "null"
      ]
    },
    "max_output_max": {
      "type": [
        "number",
        "null"
      ]
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ref": {
            "type": "string",
            "description": "provider/model. Provider ids never contain a slash, so the first slash ends the provider."
          },
          "provider": {
            "type": "string"
          },
          "model": {
            "type": "string",
            "description": "The model's id at this provider."
          },
          "name": {
            "type": "string"
          },
          "type": {
            "description": "chat, embedding, image and so on, as models.dev records it. Null = unknown.",
            "type": [
              "string",
              "null"
            ]
          },
          "family": {
            "type": [
              "string",
              "null"
            ]
          },
          "canonical_id": {
            "description": "The canonical model this entry serves, as in /api/v1/models. Null = none is recorded.",
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "description": "alpha, beta or deprecated. Null = none of these.",
            "type": [
              "string",
              "null"
            ]
          },
          "release_date": {
            "description": "When the model was released, as models.dev records it. Null = unknown.",
            "type": [
              "string",
              "null"
            ]
          },
          "access": {
            "type": "string",
            "enum": [
              "api",
              "subscription",
              "unknown"
            ]
          },
          "origin": {
            "type": "string",
            "enum": [
              "upstream",
              "modified",
              "added"
            ],
            "description": "upstream = as imported. modified = imported, with providers.dev corrections or evaluations. added = an entry models.dev does not have."
          },
          "context": {
            "description": "limit.context in tokens: the window this provider exposes for the model. Null = unknown.",
            "type": [
              "number",
              "null"
            ]
          },
          "input": {
            "description": "limit.input in tokens, stated where the input limit is lower than the window. Null = not stated.",
            "type": [
              "number",
              "null"
            ]
          },
          "max_output": {
            "description": "limit.output in tokens: the most one response can hold. A maximum, not a default. Null = unknown.",
            "type": [
              "number",
              "null"
            ]
          },
          "input_window": {
            "type": "object",
            "properties": {
              "tokens": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The most input a request can carry on this entry, in tokens as the provider counts them, the client's own system prompt and tools included: documented_tokens unless a counted evaluation clearly contradicts it, else measured_tokens, else null. basis says which. Null = not known. Never 0."
              },
              "basis": {
                "type": "string",
                "enum": [
                  "documented",
                  "measured",
                  "none"
                ],
                "description": "documented: tokens is documented_tokens. measured: tokens is measured_tokens. none: exactly when tokens is null."
              },
              "bound": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "limit",
                      "at_least"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "limit: the value is the limit, as documented or as the route names it. at_least: the value is the largest input seen accepted, and the real limit is this or more; measured_refused, where set, is an input seen refused. A documented value is always limit. Null with none."
              },
              "scope": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "input",
                      "window"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "input: a figure for the input alone (limit.input, or an input size seen accepted). window: a context window that input and output share (limit.context, or a window the route names): the response is counted against the same figure. Null with none."
              },
              "source": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "providers.dev",
                      "models.dev"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Who the value is from. measured: always providers.dev. documented: documented_source. Null with none."
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "measured: measured_date. documented: documented_date. Null with none, and where the source has no date."
              },
              "documented_tokens": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The documented input of the entry: limit.input where it is above 0, else limit.context where it is above 0 and not a measured value named in limits.from_measurement. 0 means none stated. Nothing is read from another entry. Null = none is documented."
              },
              "documented_field": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "limit.input",
                      "limit.context"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The field of the entry documented_tokens is read from. Null with documented_tokens."
              },
              "documented_source": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "providers.dev",
                      "models.dev"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "models.dev for an imported value; providers.dev for a correction of the field and for a value in an entry providers.dev added. Null with documented_tokens."
              },
              "documented_date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The import date for models.dev; the newest evidence date for providers.dev. Null = none is documented, or the source has no date."
              },
              "documented_status": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "contradicted",
                      "not_contradicted"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "What the rule found of the documented value, where one is documented and at least one evaluation counts. contradicted: an evaluation names a window below it, names another window than a documented limit.context, refused an input at or below 99 % of it, or accepted one at or above 101 % of it; tokens is measured_tokens. not_contradicted: none does, and tokens is documented_tokens; that is not the same as confirmed. Null in every other case."
              },
              "measured_tokens": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The measured value of the entry: the lowest tokens of measurements, whatever the client. Null = no evaluation counts."
              },
              "measured_bound": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "limit",
                      "at_least"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The bound of the measurement that gives measured_tokens (measurements[0]). Null with measured_tokens."
              },
              "measured_kind": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "window",
                      "bracket",
                      "accepted"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Its kind. Null with measured_tokens."
              },
              "measured_refused": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Its refused where its kind is bracket: the smallest input it saw refused; the limit is below this. Null otherwise."
              },
              "measured_date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Its date. Null with measured_tokens, and where the evaluation has no date."
              },
              "clients": {
                "type": "integer",
                "minimum": 0,
                "description": "How many different clients measurements has. 0 = not measured."
              },
              "evaluations": {
                "type": "integer",
                "minimum": 0,
                "description": "How many items measurements has: the limit evaluations of the entry that count. 0 = none counts."
              },
              "measurements": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "client": {
                      "type": "string",
                      "description": "The public id of the client the requests went through, as on the evaluation."
                    },
                    "client_label": {
                      "type": "string"
                    },
                    "route": {
                      "type": "string",
                      "description": "The access method the requests went through, as on the evaluation."
                    },
                    "route_label": {
                      "type": "string"
                    },
                    "date": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The day the requests were sent, as on the evaluation. Null = the result carries no date."
                    },
                    "tokens": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "description": "The value this evaluation gives: named for kind window, accepted for bracket, read for accepted."
                    },
                    "bound": {
                      "type": "string",
                      "enum": [
                        "limit",
                        "at_least"
                      ],
                      "description": "limit for kind window: the route named its limit. at_least for bracket and accepted: the largest input seen accepted; the real limit is this or more."
                    },
                    "kind": {
                      "type": "string",
                      "enum": [
                        "window",
                        "bracket",
                        "accepted"
                      ],
                      "description": "window: the route's own answer named its context window, and no smaller input was refused. bracket: an input was accepted and a larger one refused; the value is the accepted one. accepted: an input was accepted and the reply showed it was read to the end, nothing refused and no window named."
                    },
                    "accepted": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "exclusiveMinimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "input_accepted of the evaluation: the largest input seen accepted. Null = none recorded."
                    },
                    "refused": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "exclusiveMinimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "input_refused of the evaluation: the smallest input seen refused. Null = none."
                    },
                    "named": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "exclusiveMinimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "context of the evaluation: the window the route names. Null = it named none."
                    },
                    "read": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "exclusiveMinimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "input_read of the evaluation: the largest input the reply showed was read to the end. Null = not checked."
                    },
                    "source": {
                      "type": "string",
                      "format": "uri",
                      "description": "The raw result, as on the evaluation."
                    }
                  },
                  "required": [
                    "client",
                    "client_label",
                    "route",
                    "route_label",
                    "date",
                    "tokens",
                    "bound",
                    "kind",
                    "accepted",
                    "refused",
                    "named",
                    "read",
                    "source"
                  ],
                  "additionalProperties": false,
                  "description": "One limit evaluation of the entry that counts for the input window, with the value it gives. One route, one client, one model."
                },
                "description": "One item per counted limit evaluation, ordered by tokens, then limit before at_least, then by client, route, date and source in plain character order, null first. The first item gives the measured_* keys. Empty = none counts. An evaluation that does not count (a refusal with nothing accepted, an accepted size with no refusal, no named window and no read check, the output alone) stays in limits.measured and is in no item."
              }
            },
            "required": [
              "tokens",
              "basis",
              "bound",
              "scope",
              "source",
              "date",
              "documented_tokens",
              "documented_field",
              "documented_source",
              "documented_date",
              "documented_status",
              "measured_tokens",
              "measured_bound",
              "measured_kind",
              "measured_refused",
              "measured_date",
              "clients",
              "evaluations",
              "measurements"
            ],
            "additionalProperties": false,
            "description": "How much input a request can carry on this entry, documented or measured, and what that rests on: the same object as providers_dev.limits.input_window of the full entry. context, input and max_output beside it are limit as published, unchanged."
          },
          "cache": {
            "type": "string",
            "enum": [
              "yes",
              "no",
              "unknown"
            ],
            "description": "Prompt caching as documented. unknown = the source says nothing, which is not the same as no."
          },
          "cache_modes": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "implicit",
                "explicit"
              ]
            },
            "description": "implicit = the provider caches on its own. explicit = the request marks what to cache."
          },
          "cache_mode_support": {
            "type": "object",
            "properties": {
              "implicit": {
                "type": "string",
                "enum": [
                  "supported",
                  "unsupported",
                  "unknown"
                ]
              },
              "explicit": {
                "type": "string",
                "enum": [
                  "supported",
                  "unsupported",
                  "unknown"
                ]
              }
            },
            "required": [
              "implicit",
              "explicit"
            ],
            "additionalProperties": false,
            "description": "Support for each mode, from providers_dev.cache.documented.modes. An omitted mode stays unknown."
          },
          "cache_retention": {
            "type": "string",
            "enum": [
              "supported",
              "unsupported",
              "unknown"
            ],
            "description": "Whether a request can ask for a cache lifetime: providers_dev.cache.retention.support of the full entry."
          },
          "cache_lifetime": {
            "type": "object",
            "properties": {
              "short": {
                "type": "object",
                "properties": {
                  "safe_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
                  },
                  "basis": {
                    "type": "string",
                    "enum": [
                      "measured",
                      "documented",
                      "none"
                    ],
                    "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
                  },
                  "source": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "providers.dev",
                          "models.dev"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
                  },
                  "date": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
                  },
                  "documented_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
                  },
                  "measured_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
                  },
                  "documented_status": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "contradicted",
                          "not_contradicted"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
                  },
                  "clients": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "How many clients were measured. 0 = not measured."
                  },
                  "evaluations": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "How many evaluations were counted. 0 = not measured."
                  },
                  "checks": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Re-sends made in them, the control included."
                  },
                  "hits": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "How many of those were served from the cache."
                  },
                  "checks_inside": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
                  },
                  "hits_inside": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "How many of checks_inside were served from the cache. Null with checks_inside."
                  },
                  "tested_from_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
                  },
                  "first_miss_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
                  }
                },
                "required": [
                  "safe_s",
                  "basis",
                  "source",
                  "date",
                  "documented_s",
                  "measured_s",
                  "documented_status",
                  "clients",
                  "evaluations",
                  "checks",
                  "hits",
                  "checks_inside",
                  "hits_inside",
                  "tested_from_s",
                  "first_miss_s"
                ],
                "additionalProperties": false,
                "description": "The short profile: no lifetime asked for, or the shortest documented one."
              },
              "long": {
                "type": "object",
                "properties": {
                  "safe_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Seconds a cached prompt can be relied on: documented_s, unless an evaluation of the profile contradicts it (at an age up to documented_s, fewer than half of its checks hit), and then measured_s; measured_s where nothing is documented. Never above documented_s. 0 = no cache to rely on (basis says whether documented or measured). Null = not known."
                  },
                  "basis": {
                    "type": "string",
                    "enum": [
                      "measured",
                      "documented",
                      "none"
                    ],
                    "description": "documented: safe_s is documented_s. measured: safe_s is measured_s. none: exactly when safe_s is null."
                  },
                  "source": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "providers.dev",
                          "models.dev"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Who the value is from. measured: always providers.dev. documented: the source of the documented item it is taken from. Null with none."
                  },
                  "date": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "measured: the newest evaluation counted. documented: the date of the documented item it is taken from. Null with none, and where the source has no date."
                  },
                  "documented_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The documented lifetime of the profile: the lowest lifetime_s of its documented items. 0 = the provider documents that it does not cache. Null = none is documented."
                  },
                  "measured_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The measured lifetime of the profile: the lowest lifetime_s of its measured items, the oldest age through which every check hit in every client. 0 = no such age. Null = not measured."
                  },
                  "documented_status": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "contradicted",
                          "not_contradicted"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "What the rule found of the documented lifetime, where a lifetime above 0 is documented and one is measured. contradicted: an evaluation of the profile contradicts documented_s, and safe_s is measured_s (basis measured). not_contradicted: no evaluation contradicts it, and safe_s is documented_s (basis documented); that is not the same as confirmed. Null: nothing documented, nothing measured, or documented_s 0 (the provider documents that it does not cache, which the rule never calls contradicted; measured_s is beside it)."
                  },
                  "clients": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "How many clients were measured. 0 = not measured."
                  },
                  "evaluations": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "How many evaluations were counted. 0 = not measured."
                  },
                  "checks": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Re-sends made in them, the control included."
                  },
                  "hits": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "How many of those were served from the cache."
                  },
                  "checks_inside": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Of checks, those at an age up to and including documented_s, the control included. Null where the profile is not both documented and measured."
                  },
                  "hits_inside": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "How many of checks_inside were served from the cache. Null with checks_inside."
                  },
                  "tested_from_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The youngest age, after the control, that any counted evaluation checked. No age below it was checked. Null = not measured, or no timed check was made."
                  },
                  "first_miss_s": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The youngest age at which any check of a counted evaluation missed. 0 = the immediate re-send missed. Null = not measured, or no check missed."
                  }
                },
                "required": [
                  "safe_s",
                  "basis",
                  "source",
                  "date",
                  "documented_s",
                  "measured_s",
                  "documented_status",
                  "clients",
                  "evaluations",
                  "checks",
                  "hits",
                  "checks_inside",
                  "hits_inside",
                  "tested_from_s",
                  "first_miss_s"
                ],
                "additionalProperties": false,
                "description": "The long profile: a longer lifetime asked for."
              },
              "lifetimes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "retention_profile": {
                      "type": "string",
                      "enum": [
                        "short",
                        "long"
                      ],
                      "description": "Documented: short for the shortest lifetime the entry documents, long for every other. Measured: the profile of its evaluations."
                    },
                    "basis": {
                      "type": "string",
                      "enum": [
                        "measured",
                        "documented"
                      ],
                      "description": "documented = a lifetime the source documents. measured = what the evaluations of one client with one retention setting showed. Says which of the keys below apply."
                    },
                    "source": {
                      "type": "string",
                      "enum": [
                        "providers.dev",
                        "models.dev"
                      ],
                      "description": "Documented: models.dev, or providers.dev where the lifetime is a providers.dev correction or the entry is one providers.dev added. Measured: always providers.dev."
                    },
                    "date": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Documented: the import date for models.dev, the newest evidence date for providers.dev. Measured: the newest of its evaluations. Null = the source has no date."
                    },
                    "lifetime_s": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Documented: the lifetime in whole seconds; 0 only on the item that says the entry does not cache. A documented text that is not a whole number of seconds above 0 is no item. Measured: the oldest tested age through which every check of every one of its evaluations hit; 0 = no such age."
                    },
                    "mode": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "implicit",
                            "explicit"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Documented: the way of caching the lifetime is documented for. Null on the item that says the entry does not cache, and on a measured item."
                    },
                    "documented_as": {
                      "description": "Documented: the lifetime as the source writes it, for example 5m. Null on the item that says the entry does not cache, and on a measured item.",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "client": {
                      "description": "Measured: the public id of the client the requests went through, as on the evaluations. Null on a documented item.",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "client_label": {
                      "description": "Measured: its public label. Null on a documented item.",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "parameter": {
                      "description": "Measured: the request field that asked for the lifetime, as on the evaluations. Null = no lifetime was asked for, and on a documented item.",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "value": {
                      "description": "Measured: the value sent in it. Null together with parameter.",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "evaluations": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Measured: how many evaluations the item is made from, at least 1. 0 on a documented item."
                    },
                    "evaluation_ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Measured: their ids, sorted, as in the entry's evaluations and in /api/v1/evaluations/cache. Empty on a documented item."
                    },
                    "checks": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Measured: re-sends made in them, the control included. 0 on a documented item."
                    },
                    "hits": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Measured: how many of those were served from the cache. 0 on a documented item."
                    },
                    "tested_from_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Measured: the youngest timed age any of them checked; no younger age was checked. Null = none made a timed check, and on a documented item."
                    },
                    "first_miss_s": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Measured: the youngest age at which any of them had a check that missed; 0 = the immediate re-send. Null = no miss, and on a documented item."
                    },
                    "results": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "control",
                                  "timed"
                                ],
                                "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
                              },
                              "age_s": {
                                "type": "integer",
                                "minimum": 0,
                                "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
                              },
                              "hits": {
                                "type": "integer",
                                "minimum": 0,
                                "description": "Re-sends served from the cache."
                              },
                              "checks": {
                                "type": "integer",
                                "minimum": 1,
                                "description": "Re-sends made. An age nobody checked has no result at all."
                              },
                              "hit_rate_pct": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 100,
                                "description": "hits / checks, in percent, two decimals."
                              }
                            },
                            "required": [
                              "kind",
                              "age_s",
                              "hits",
                              "checks",
                              "hit_rate_pct"
                            ],
                            "additionalProperties": false,
                            "description": "What was seen at one age."
                          }
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Measured: the results of its evaluations added up by exact age, the control first. lifetime_s is read from each evaluation on its own and the lowest taken, so on an item of several evaluations it can be below what these sums show. Null on a documented item."
                    }
                  },
                  "required": [
                    "retention_profile",
                    "basis",
                    "source",
                    "date",
                    "lifetime_s",
                    "mode",
                    "documented_as",
                    "client",
                    "client_label",
                    "parameter",
                    "value",
                    "evaluations",
                    "evaluation_ids",
                    "checks",
                    "hits",
                    "tested_from_s",
                    "first_miss_s",
                    "results"
                  ],
                  "additionalProperties": false,
                  "description": "One lifetime of an entry: documented by a source, or measured for one client with one retention setting. One shape for both; the keys of the other kind are null, 0 or empty."
                },
                "description": "Every lifetime known for the entry: short, then long; in each, the documented items by seconds, implicit before explicit, then by text; then the measured ones, the setting that asked for no lifetime first, then by seconds and value, then by client, then by parameter. Text is compared in plain character order. Empty = none is known."
              }
            },
            "required": [
              "short",
              "long",
              "lifetimes"
            ],
            "additionalProperties": false,
            "description": "Every cache lifetime of the entry, documented and measured, and the safe value of each retention profile: the same object as providers_dev.cache.lifetime of the full entry."
          },
          "evaluation_count": {
            "type": "integer",
            "minimum": 0,
            "description": "How many cache evaluations this entry has."
          },
          "price_in": {
            "description": "The base price of text input in US dollars per million tokens, before any conditional rate. On a subscription entry it is the API reference price named by price_from. Null = unknown, or priced in another unit.",
            "type": [
              "number",
              "null"
            ]
          },
          "price_out": {
            "description": "The same for output.",
            "type": [
              "number",
              "null"
            ]
          },
          "price_from": {
            "description": "On a subscription entry: the ref of the API entry whose list price this is. The entry itself is not paid per token. Null = the price is the entry's own.",
            "type": [
              "string",
              "null"
            ]
          },
          "pricing": {
            "type": "object",
            "properties": {
              "coverage": {
                "type": "string",
                "enum": [
                  "unknown",
                  "partial",
                  "complete",
                  "not_applicable"
                ],
                "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
              },
              "billing": {
                "type": "string",
                "enum": [
                  "per_use",
                  "reference",
                  "not_applicable",
                  "unknown"
                ],
                "description": "per_use = the entry is billed at these rates. reference = a subscription entry: the rates are the API list prices of reference_ref, not the subscription's bill. not_applicable = a subscription entry with no API entry of the same model to refer to. unknown = rates are listed for the entry and what they bill is not established."
              },
              "reference_ref": {
                "description": "With billing = reference: the API entry the rates are taken from. That is the entry a providers.dev entry inherits from, or the entry of the lab's own provider for the same canonical model. Otherwise null.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "rules": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1
                        },
                        "when": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema0"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Null = unconditional base rule. A condition with kind=unknown remains unresolved."
                        },
                        "meter": {
                          "type": "string",
                          "minLength": 1,
                          "description": "The charge affected. For text: text.input, text.output, text.reasoning_output, text.cache_read, text.cache_write, text.cache_storage. The same charges exist for audio, image and video (audio.input, image.output, video.output and so on), each priced in its own unit. web_search is the charge for web searches. A multiply rule names one charge or a scope: text.* is every text charge, audio.* every audio charge, * every charge."
                        },
                        "operation": {
                          "type": "string",
                          "enum": [
                            "set",
                            "multiply"
                          ]
                        },
                        "amount": {
                          "type": "number",
                          "minimum": 0,
                          "description": "A price for set, or a factor for multiply. Zero is a known zero, never missing."
                        },
                        "currency": {
                          "description": "ISO currency for a price; null for multipliers or an unknown currency.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "unit": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "For example token, character, request, second or token_hour."
                                },
                                "quantity": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "exclusiveMinimum": 0
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                                }
                              },
                              "required": [
                                "name",
                                "quantity"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Billing unit and scale. Null for multipliers or an unknown unit."
                        },
                        "applies_to": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "all_usage",
                                "above_threshold"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "all_usage = the rate holds for the whole request that matches the condition. above_threshold = only for the part above a size threshold. Imported rules are all_usage: models.dev evaluates a condition per request, and a matching rule prices that request. Null = not established; never infer marginal billing."
                        },
                        "source_path": {
                          "description": "Field in the original cost record. Null for a separately authored rule.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "period": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "peak",
                                "off_peak"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Set on a rule whose condition reads the time of day or the day of the week (request.utc_hours, request.utc_days): peak = the rule raises the base rate in its window, off_peak = it lowers it. The base rate is the price outside the window. Null = not a time rule, or one that leaves the base rate as it is."
                        },
                        "resulting_rates": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "meter": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "amount": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "currency": {
                                    "type": [
                                      "string",
                                      "null"
                                    ]
                                  },
                                  "unit": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "name": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "For example token, character, request, second or token_hour."
                                          },
                                          "quantity": {
                                            "anyOf": [
                                              {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ],
                                            "description": "Amount is charged per this many units. Null = the source does not establish the scale."
                                          }
                                        },
                                        "required": [
                                          "name",
                                          "quantity"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "meter",
                                  "amount",
                                  "currency",
                                  "unit"
                                ],
                                "additionalProperties": false,
                                "description": "A base rate after a multiplier."
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "On a multiply rule: each unconditional base rate in its scope times the factor, which is the price when this rule applies and no other conditional rule does. Null on a set rule, whose amount is the rate itself, and on a multiply rule with no base rate in its scope."
                        }
                      },
                      "required": [
                        "id",
                        "when",
                        "meter",
                        "operation",
                        "amount",
                        "currency",
                        "unit",
                        "applies_to",
                        "source_path",
                        "period",
                        "resulting_rates"
                      ],
                      "additionalProperties": false
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Base prices, conditional replacements and multipliers. Null = unknown. [] proves no rules only with complete coverage."
              },
              "rule_order": {
                "anyOf": [
                  {
                    "type": "string",
                    "const": "listed"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "listed = process matching rules in array order per meter: set replaces the rate and multiply scales it. Imported rules are listed: base rates first, then models.dev's overrides in their order, then its multipliers, which is how models.dev defines a price. Null = combination precedence is unconfirmed; this record cannot produce an authoritative combined quote."
              },
              "unparsed": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "path": {
                      "type": "string"
                    },
                    "value": {
                      "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema3"
                    }
                  },
                  "required": [
                    "path",
                    "value"
                  ],
                  "additionalProperties": false
                },
                "description": "Source fields not normalized, retained without loss. Nonempty means coverage is partial."
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "documented",
                        "measured"
                      ]
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "date": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "note": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "kind",
                    "url",
                    "date",
                    "note"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "coverage",
              "billing",
              "reference_ref",
              "rules",
              "rule_order",
              "unparsed",
              "evidence"
            ],
            "additionalProperties": false,
            "description": "The same normalized pricing record as providers_dev.pricing on the full entry, including all conditions and unparsed source fields."
          },
          "request_controls": {
            "type": "object",
            "properties": {
              "coverage": {
                "type": "string",
                "enum": [
                  "unknown",
                  "partial",
                  "complete",
                  "not_applicable"
                ],
                "description": "unknown = no usable record; partial = known fields without a completeness claim; complete = explicitly confirmed for the stated scope; not_applicable = no per-use billing on this access. Empty lists alone never prove absence."
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Semantic id, e.g. cache.retention or service_tier; independent of the provider's wire field."
                    },
                    "support": {
                      "type": "string",
                      "enum": [
                        "supported",
                        "unsupported",
                        "unknown"
                      ]
                    },
                    "when": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema0"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Scope of the support claim: endpoint, protocol, region or another request condition."
                    },
                    "bindings": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "location": {
                                "type": "string",
                                "enum": [
                                  "header",
                                  "body",
                                  "query"
                                ]
                              },
                              "path": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                              },
                              "scope": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "enum": [
                                      "request",
                                      "content_block"
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Where the binding is applied. Null = scope unknown."
                              }
                            },
                            "required": [
                              "location",
                              "path",
                              "scope"
                            ],
                            "additionalProperties": false
                          }
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Known places this control is sent. Null means transport is unconfirmed, even when support is documented."
                    },
                    "options": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "value": {
                                "description": "The provider's actual accepted value, not a display alias.",
                                "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema4"
                              },
                              "attributes": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema5"
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Normalized meaning when known, e.g. retention_s: 3600 and profile: long. Short/long alone never specifies a duration."
                              },
                              "settings": {
                                "anyOf": [
                                  {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "location": {
                                          "type": "string",
                                          "enum": [
                                            "header",
                                            "body",
                                            "query"
                                          ]
                                        },
                                        "path": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "Header/query name, or JSON Pointer relative to the body scope. A body path uses /cache_control/ttl, not a header name."
                                        },
                                        "scope": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "enum": [
                                                "request",
                                                "content_block"
                                              ]
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "Where the binding is applied. Null = scope unknown."
                                        },
                                        "value": {
                                          "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema6"
                                        }
                                      },
                                      "required": [
                                        "location",
                                        "path",
                                        "scope",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Exact fields and any companion headers for this option. Null = transport unknown."
                              },
                              "when": {
                                "anyOf": [
                                  {
                                    "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema0"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "value",
                              "attributes",
                              "settings",
                              "when"
                            ],
                            "additionalProperties": false
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "default": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "value": {
                              "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema7"
                            }
                          },
                          "required": [
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Known default wrapped in value so an explicit JSON null differs from an unknown default."
                    },
                    "conditions": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Source restrictions not yet represented as condition trees. Nonempty means a caller must not treat the control as unconditional."
                    },
                    "evidence": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "documented",
                              "measured"
                            ]
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "date": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "note": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "kind",
                          "url",
                          "date",
                          "note"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "id",
                    "support",
                    "when",
                    "bindings",
                    "options",
                    "default",
                    "conditions",
                    "evidence"
                  ],
                  "additionalProperties": false
                },
                "description": "Always includes cache.retention and service_tier. Additional controls use the same schema. No control is inherited across access routes."
              }
            },
            "required": [
              "coverage",
              "items"
            ],
            "additionalProperties": false,
            "description": "The same controls as providers_dev.request_controls on the full entry. Unknown and unsupported are distinct."
          },
          "measured_input_accepted": {
            "description": "Tokens: the largest input a limit evaluation saw accepted. The real limit is at least this. Null = not measured.",
            "type": [
              "number",
              "null"
            ]
          },
          "measured_input_refused": {
            "description": "Tokens: the smallest input a limit evaluation saw refused. The real limit is below this. Null = not measured.",
            "type": [
              "number",
              "null"
            ]
          },
          "measured_limit_count": {
            "type": "integer",
            "minimum": 0,
            "description": "How many limit evaluations this entry has."
          },
          "overridden_fields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The imported fields providers.dev corrected."
          },
          "verified": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              {
                "type": "null"
              }
            ],
            "description": "The newest date of providers.dev evidence. Null = the entry has none."
          },
          "shard": {
            "type": "integer",
            "minimum": 0,
            "description": "Which file under /data/entries/<provider>/ holds the full entry."
          }
        },
        "required": [
          "ref",
          "provider",
          "model",
          "name",
          "type",
          "family",
          "canonical_id",
          "status",
          "release_date",
          "access",
          "origin",
          "context",
          "input",
          "max_output",
          "input_window",
          "cache",
          "cache_modes",
          "cache_mode_support",
          "cache_retention",
          "cache_lifetime",
          "evaluation_count",
          "price_in",
          "price_out",
          "price_from",
          "pricing",
          "request_controls",
          "measured_input_accepted",
          "measured_input_refused",
          "measured_limit_count",
          "overridden_fields",
          "verified",
          "shard"
        ],
        "additionalProperties": false,
        "description": "One provider-model entry in short: what the lists return and what the tables of the website show. Every summary has every field; a value no source gives is null."
      },
      "description": "Every entry for the model: the lab's own API first, then subscriptions, then the rest by provider."
    }
  },
  "required": [
    "id",
    "name",
    "lab",
    "reference_ref",
    "entry_count",
    "subscription_entry_count",
    "evidence_entry_count",
    "context_min",
    "context_max",
    "max_output_min",
    "max_output_max",
    "entries"
  ],
  "additionalProperties": false,
  "description": "A canonical model with every entry that serves it.",
  "$defs": {
    "__schema0": {
      "description": "Shared condition tree. all = AND, any = OR, not = negation. Unknown conditions cannot be assumed true or false. min_items = the field is a list with at least that many items. request.context_tokens preserves the source's context threshold; it does not mean the model's maximum window or necessarily input-only tokens. Authored rules may use request.input_tokens explicitly.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "predicate"
            },
            "field": {
              "type": "string",
              "minLength": 1
            },
            "op": {
              "type": "string",
              "enum": [
                "eq",
                "in",
                "gt",
                "gte",
                "lt",
                "lte",
                "min_items"
              ]
            },
            "value": {
              "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema1"
            }
          },
          "required": [
            "kind",
            "field",
            "op",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ]
            },
            "conditions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema0"
              }
            }
          },
          "required": [
            "kind",
            "conditions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "not"
            },
            "condition": {
              "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema0"
            }
          },
          "required": [
            "kind",
            "condition"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "unknown"
            },
            "raw": {
              "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema2"
            }
          },
          "required": [
            "kind",
            "raw"
          ],
          "additionalProperties": false
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema1"
          }
        }
      ]
    },
    "__schema2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema2"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema2"
          }
        }
      ]
    },
    "__schema3": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema3"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema3"
          }
        }
      ]
    },
    "__schema4": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema4"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema4"
          }
        }
      ]
    },
    "__schema5": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema5"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema5"
          }
        }
      ]
    },
    "__schema6": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema6"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema6"
          }
        }
      ]
    },
    "__schema7": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema7"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/CanonicalModelDetail/$defs/__schema7"
          }
        }
      ]
    }
  }
}

CacheEvaluationRecord

One cache evaluation with the entry it was made on.

Field (* required)TypeMeaning
kind*"cache"
entry_ref*stringThe entry the evaluation was made on.
entry_name*string
access*"api" | "subscription" | "unknown"
id*stringThe id of the evaluation in the results repository.
route*stringThe access method the requests went through.
route_label*string
client*stringWhat sent the requests: direct, cliproxyapi, a coding tool.
client_label*string
date*string
request_settings*objectWhat the requests were sent with, as recorded: format, reasoning effort, lifetime and so on.
retention_profile*"short" | "long"short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support.
parameter*string | nullThe request field that asked for the lifetime, for example cache_control.ttl, prompt_cache_retention or prompt_cache_options.ttl. Null = no lifetime was asked for.
value*string | nullThe value sent in it, for example 1h. Null together with parameter.
results*object[]One result per exact age, the control first.
late_excluded*integer | nullChecks left out because they ran too late for their age. Null = the evaluation does not record it.
note*string | nullNull = no note.
source*stringThe raw result.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "const": "cache"
    },
    "entry_ref": {
      "type": "string",
      "description": "The entry the evaluation was made on."
    },
    "entry_name": {
      "type": "string"
    },
    "access": {
      "type": "string",
      "enum": [
        "api",
        "subscription",
        "unknown"
      ]
    },
    "id": {
      "type": "string",
      "description": "The id of the evaluation in the results repository."
    },
    "route": {
      "type": "string",
      "description": "The access method the requests went through."
    },
    "route_label": {
      "type": "string"
    },
    "client": {
      "type": "string",
      "description": "What sent the requests: direct, cliproxyapi, a coding tool."
    },
    "client_label": {
      "type": "string"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "request_settings": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "$ref": "#/components/schemas/CacheEvaluationRecord/$defs/__schema0"
      },
      "description": "What the requests were sent with, as recorded: format, reasoning effort, lifetime and so on."
    },
    "retention_profile": {
      "type": "string",
      "enum": [
        "short",
        "long"
      ],
      "description": "short = no lifetime requested, or the shortest documented lifetime. long = another requested lifetime. A profile does not confirm parameter support."
    },
    "parameter": {
      "description": "The request field that asked for the lifetime, for example cache_control.ttl, prompt_cache_retention or prompt_cache_options.ttl. Null = no lifetime was asked for.",
      "type": [
        "string",
        "null"
      ]
    },
    "value": {
      "description": "The value sent in it, for example 1h. Null together with parameter.",
      "type": [
        "string",
        "null"
      ]
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "control",
              "timed"
            ],
            "description": "control = the prompt sent again at once, which shows it was cached at all. timed = sent again at age_s."
          },
          "age_s": {
            "type": "integer",
            "minimum": 0,
            "description": "Seconds since the prompt was cached. 0 for the control. Exact: 450 (7.5 minutes) is its own age, never folded into 600."
          },
          "hits": {
            "type": "integer",
            "minimum": 0,
            "description": "Re-sends served from the cache."
          },
          "checks": {
            "type": "integer",
            "minimum": 1,
            "description": "Re-sends made. An age nobody checked has no result at all."
          },
          "hit_rate_pct": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "hits / checks, in percent, two decimals."
          }
        },
        "required": [
          "kind",
          "age_s",
          "hits",
          "checks",
          "hit_rate_pct"
        ],
        "additionalProperties": false,
        "description": "What was seen at one age."
      },
      "description": "One result per exact age, the control first."
    },
    "late_excluded": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Checks left out because they ran too late for their age. Null = the evaluation does not record it."
    },
    "note": {
      "description": "Null = no note.",
      "type": [
        "string",
        "null"
      ]
    },
    "source": {
      "type": "string",
      "format": "uri",
      "description": "The raw result."
    }
  },
  "required": [
    "kind",
    "entry_ref",
    "entry_name",
    "access",
    "id",
    "route",
    "route_label",
    "client",
    "client_label",
    "date",
    "request_settings",
    "retention_profile",
    "parameter",
    "value",
    "results",
    "late_excluded",
    "note",
    "source"
  ],
  "additionalProperties": false,
  "description": "One cache evaluation with the entry it was made on.",
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CacheEvaluationRecord/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/CacheEvaluationRecord/$defs/__schema0"
          }
        }
      ]
    }
  }
}

LimitEvaluationRecord

One limit evaluation with the entry it was made on.

Field (* required)TypeMeaning
kind*"limit"
entry_ref*stringThe entry the evaluation was made on.
entry_name*string
access*"api" | "subscription" | "unknown"
route*string
route_label*string
client*string
client_label*string
context*number | nullTokens: the context window found. Null = this evaluation did not measure it.
output*number | nullTokens: the largest response found. Null = not measured.
input_accepted*number | nullTokens: the largest input seen accepted. The real limit is at least this. Null = not measured.
input_refused*number | nullTokens: the smallest input seen refused. The real limit is below this. Null = not measured.
input_read*number | nullTokens: the largest input for which the reply showed the route read it to the end (a word before the filler and one after it, both returned). Never above input_accepted. Null = not checked.
output_accepted*number | nullTokens: the largest requested output seen accepted. Null = not measured.
note*string | nullNull = no note.
date*string | nullThe day the requests were sent: the evaluation's own date, else the date in the name of its results folder. Null = the result carries no date.
source*string
Full JSON Schema
{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "const": "limit"
    },
    "entry_ref": {
      "type": "string",
      "description": "The entry the evaluation was made on."
    },
    "entry_name": {
      "type": "string"
    },
    "access": {
      "type": "string",
      "enum": [
        "api",
        "subscription",
        "unknown"
      ]
    },
    "route": {
      "type": "string"
    },
    "route_label": {
      "type": "string"
    },
    "client": {
      "type": "string"
    },
    "client_label": {
      "type": "string"
    },
    "context": {
      "description": "Tokens: the context window found. Null = this evaluation did not measure it.",
      "type": [
        "number",
        "null"
      ]
    },
    "output": {
      "description": "Tokens: the largest response found. Null = not measured.",
      "type": [
        "number",
        "null"
      ]
    },
    "input_accepted": {
      "description": "Tokens: the largest input seen accepted. The real limit is at least this. Null = not measured.",
      "type": [
        "number",
        "null"
      ]
    },
    "input_refused": {
      "description": "Tokens: the smallest input seen refused. The real limit is below this. Null = not measured.",
      "type": [
        "number",
        "null"
      ]
    },
    "input_read": {
      "description": "Tokens: the largest input for which the reply showed the route read it to the end (a word before the filler and one after it, both returned). Never above input_accepted. Null = not checked.",
      "type": [
        "number",
        "null"
      ]
    },
    "output_accepted": {
      "description": "Tokens: the largest requested output seen accepted. Null = not measured.",
      "type": [
        "number",
        "null"
      ]
    },
    "note": {
      "description": "Null = no note.",
      "type": [
        "string",
        "null"
      ]
    },
    "date": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "The day the requests were sent: the evaluation's own date, else the date in the name of its results folder. Null = the result carries no date."
    },
    "source": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "kind",
    "entry_ref",
    "entry_name",
    "access",
    "route",
    "route_label",
    "client",
    "client_label",
    "context",
    "output",
    "input_accepted",
    "input_refused",
    "input_read",
    "output_accepted",
    "note",
    "date",
    "source"
  ],
  "additionalProperties": false,
  "description": "One limit evaluation with the entry it was made on."
}

Meta

The dataset: its version, what it holds and where it comes from.

Field (* required)TypeMeaning
api_version*"v1"
upstream_schema*string
dataset_version*stringA hash of the catalog and summaries. It changes when their data changes. ETags identify each response representation separately.
generated_at*string
counts*object
cache_ages_s*integer[]The ages, in seconds, that every table of cache results by age has a column for, after the control at age 0. Results at other ages are in the data at their exact age.
stale_after_days*integerproviders.dev evidence (a correction, an evaluation, a measured lifetime) whose date is more than this many days before today is shown as stale. The API publishes the dates and this number, set once when the data is built; a reader applies it to its own date. Imported models.dev values carry no such date and are never stale.
upstream*objectThe models.dev import this dataset is built on.
measurements*object | nullThe results repository the evaluations come from. Null = the dataset has no evaluations file.
sync*objectThe last attempt to import. All null = no attempt is recorded.
exclusions*object[]What is left out of the catalog: one item per excluded entry or provider, and one per catalog-wide rule, never a list of the entries a rule removed.
issues*object[]Corrections and evaluations that no longer match an entry.
license*object
Full JSON Schema
{
  "type": "object",
  "properties": {
    "api_version": {
      "type": "string",
      "const": "v1"
    },
    "upstream_schema": {
      "type": "string"
    },
    "dataset_version": {
      "type": "string",
      "description": "A hash of the catalog and summaries. It changes when their data changes. ETags identify each response representation separately."
    },
    "generated_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "counts": {
      "type": "object",
      "properties": {
        "providers": {
          "type": "integer"
        },
        "entries": {
          "type": "integer",
          "description": "Provider-model entries."
        },
        "models": {
          "type": "integer",
          "description": "Canonical models."
        },
        "added_providers": {
          "type": "integer"
        },
        "added_entries": {
          "type": "integer"
        },
        "corrected_entries": {
          "type": "integer"
        },
        "evaluated_entries": {
          "type": "integer"
        },
        "cache_evaluations": {
          "type": "integer"
        },
        "limit_evaluations": {
          "type": "integer"
        }
      },
      "required": [
        "providers",
        "entries",
        "models",
        "added_providers",
        "added_entries",
        "corrected_entries",
        "evaluated_entries",
        "cache_evaluations",
        "limit_evaluations"
      ],
      "additionalProperties": false
    },
    "cache_ages_s": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "The ages, in seconds, that every table of cache results by age has a column for, after the control at age 0. Results at other ages are in the data at their exact age."
    },
    "stale_after_days": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "providers.dev evidence (a correction, an evaluation, a measured lifetime) whose date is more than this many days before today is shown as stale. The API publishes the dates and this number, set once when the data is built; a reader applies it to its own date. Imported models.dev values carry no such date and are never stale."
    },
    "upstream": {
      "type": "object",
      "properties": {
        "source": {
          "type": "string"
        },
        "schema": {
          "type": "string"
        },
        "fetched_at": {
          "type": "string"
        },
        "checked_at": {
          "type": "string"
        },
        "etag": {
          "type": [
            "string",
            "null"
          ]
        },
        "commit": {
          "description": "The models.dev commit of the import. Null = not known.",
          "type": [
            "string",
            "null"
          ]
        },
        "commit_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "sha256": {
          "type": "string"
        },
        "providers": {
          "type": "integer"
        },
        "models": {
          "type": "integer"
        }
      },
      "required": [
        "source",
        "schema",
        "fetched_at",
        "checked_at",
        "etag",
        "commit",
        "commit_date",
        "sha256",
        "providers",
        "models"
      ],
      "additionalProperties": false,
      "description": "The models.dev import this dataset is built on."
    },
    "measurements": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "fetched_at": {
              "type": "string"
            },
            "checked_at": {
              "type": "string"
            },
            "etag": {
              "type": [
                "string",
                "null"
              ]
            },
            "sha256": {
              "type": "string"
            },
            "repository": {
              "type": "string",
              "format": "uri"
            }
          },
          "required": [
            "source",
            "fetched_at",
            "checked_at",
            "etag",
            "sha256",
            "repository"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "The results repository the evaluations come from. Null = the dataset has no evaluations file."
    },
    "sync": {
      "type": "object",
      "properties": {
        "last_attempt_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "last_attempt_ok": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "last_error": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "last_attempt_at",
        "last_attempt_ok",
        "last_error"
      ],
      "additionalProperties": false,
      "description": "The last attempt to import. All null = no attempt is recorded."
    },
    "exclusions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "entry",
              "provider",
              "rule"
            ],
            "description": "entry or provider: an override left it out, with its evidence. rule: a catalog-wide rule, an editorial choice of providers.dev, left out every entry it matches."
          },
          "target": {
            "type": "string",
            "description": "The entry (provider/model), the provider id, or the rule id."
          },
          "leaves_out": {
            "description": "What a rule leaves out, in words. Null for an entry or a provider.",
            "type": [
              "string",
              "null"
            ]
          },
          "reason": {
            "type": "string"
          },
          "date": {
            "description": "The day a rule was decided (YYYY-MM-DD). Null for an entry or a provider: its evidence carries the dates.",
            "type": [
              "string",
              "null"
            ]
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "documented",
                    "measured",
                    "listed"
                  ],
                  "description": "documented = the provider says so. measured = providers.dev ran it. listed = the provider's own model list reports it."
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "date": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "description": "When the source was read or the measurement taken."
                },
                "note": {
                  "description": "What the source says. Null = no note.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "kind",
                "url",
                "date",
                "note"
              ],
              "additionalProperties": false,
              "description": "A source for something providers.dev publishes."
            },
            "description": "The sources for an entry or a provider. Empty for a rule: an editorial choice cites none."
          },
          "entries": {
            "type": "integer",
            "minimum": 0,
            "description": "How many entries it removed in this build."
          }
        },
        "required": [
          "kind",
          "target",
          "leaves_out",
          "reason",
          "date",
          "evidence",
          "entries"
        ],
        "additionalProperties": false
      },
      "description": "What is left out of the catalog: one item per excluded entry or provider, and one per catalog-wide rule, never a list of the entries a rule removed."
    },
    "issues": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "level": {
            "type": "string",
            "enum": [
              "error",
              "warning",
              "notice"
            ]
          },
          "code": {
            "type": "string"
          },
          "target": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "level",
          "code",
          "target",
          "message"
        ],
        "additionalProperties": {}
      },
      "description": "Corrections and evaluations that no longer match an entry."
    },
    "license": {
      "type": "object",
      "properties": {
        "data": {
          "type": "string"
        },
        "upstream": {
          "type": "string"
        },
        "notice": {
          "type": "string"
        }
      },
      "required": [
        "data",
        "upstream",
        "notice"
      ],
      "additionalProperties": {}
    }
  },
  "required": [
    "api_version",
    "upstream_schema",
    "dataset_version",
    "generated_at",
    "counts",
    "cache_ages_s",
    "stale_after_days",
    "upstream",
    "measurements",
    "sync",
    "exclusions",
    "issues",
    "license"
  ],
  "additionalProperties": {},
  "description": "The dataset: its version, what it holds and where it comes from."
}

Error

Field (* required)TypeMeaning
error*object
Full JSON Schema
{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "description": "invalid_parameters, provider_not_found, entry_not_found, model_not_found, method_not_allowed, not_found or snapshot_incomplete."
        },
        "message": {
          "type": "string"
        },
        "details": {
          "$ref": "#/components/schemas/Error/$defs/__schema0"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "error"
  ],
  "additionalProperties": false,
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Error/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/components/schemas/Error/$defs/__schema0"
          }
        }
      ]
    }
  }
}