Sign in
catalog

Get Catalog Model

Changed on

One model and every offering of it this caller may use.

The whole merged catalog is built and grouped to answer for one model. That is deliberate: the identity a model is found by is a property of the group, so narrowing the build to one model would need the grouping done first. The query count is constant; the cost is CPU per page view, growing with the size of the catalog rather than with the number of readers.

A model the caller may not see answers 404, the same as one that does not exist, so the route cannot be used to probe the catalog behind an allow-list. A signed-in caller's offerings also carry their organization's own usage of each over the last 30 days.

get/api/v1/catalog/models/{model_id}

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header Otari-Key
    • API key in header x-api-key

Path parameters

model_idstring required

Response

Successful Response

context_windowinteger nullable

The largest any offering serves.

default_pricingboolean required

Whether an unpriced model is metered at the genai-prices default.

deprecatedboolean

True only when every offering with metadata says so.

descriptionstring nullable

models.dev's, from the offering that named the model.

discoveredboolean required

Whether any offering was discovered from its provider.

familystring nullable
idstring required

The catalog id, vendor-qualified where the vendor is known: z-ai/glm-5.3, else the bare slug.

input_modalitiesstring[] required
knowledge_cutoffstring nullable
max_output_tokensinteger nullable

The largest any offering serves.

min_input_price_per_millionnumber nullable

The cheapest offering's, at the comparison context where one was asked for.

min_output_price_per_millionnumber nullable
namestring required
offering_countinteger required
open_weightsboolean
output_modalitiesstring[] required
price_sourcesstring[] required

Which price lists the priced offerings came from, distinct and sorted.

provider_countinteger required
providersstring[] required

The provider instances offering it, sorted.

release_datestring nullable
resolves_tostring nullable

The offering selector resolves to.

selectorstring nullable

The id as a selector: send it as model and the best offering the caller can reach answers. Priced offerings come first, and among them the organization's own key, then the vendor's own provider, then the cheapest. Null until the gateway has indexed the catalog.

selectorsstring[] required

Every offering's selector, so the list can be searched by one.

unpriced_countinteger required

How many offerings carry no price for this caller.

vendorstring nullable required

Changes