Sign in
catalog

List Catalog

Changed on

The models this caller may use, one entry each however many providers serve it.

Prices are the caller's: an organization's override where one applies, else the deployment's row, else the genai-prices default. Aliases and routing policies are not models and are not listed; see Routing. A visitor, where the catalog is public, sees the configured instances and the hosted models at the deployment's rates, and nothing that belongs to a tenant.

get/api/v1/catalog/models

Request

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

Query parameters

at_contextinteger nullable

Compare prices for a request of this many input tokens: each model's minimum is taken from the pricing tier that request would settle at. Omitted, the base rates compare.

searchstring nullable

Case-insensitive text in a model's name, vendor, id, selectors, or provider instances.

skipinteger

Number of matching models to skip.

limitinteger

Maximum number of models to return.

providerstring[]

Match any named provider instance.

vendorstring[]

Match any vendor; an empty value names unknown vendors.

input_modalitystring[]

Require every input modality.

output_modalitystring[]

Require every output modality.

capabilityCatalogCapability[]

Require every capability.

min_contextinteger

Minimum context window; unknown windows do not match.

max_inputnumber nullable

Maximum cheapest input price per million tokens; unpriced models do not match.

pricing'all' | 'custom' | 'default' | 'priced' | 'unpriced'
source'all' | 'discovered' | 'custom'
released_within_daysinteger

Release window ending today (UTC); zero disables it. Unknown and future releases do not match.

sort'name' | 'released' | 'input' | 'output' | 'context' | 'providers'
direction'asc' | 'desc'
include_facetsboolean

Include the filter choices drawn from the whole authorized catalog.

Response

Successful Response

countinteger required

Models matching all filters before paging.

default_pricingboolean required

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

defaults_as_ofstring date-time nullable required

When the accepted genai-prices snapshot was taken. Null while the bundled dataset serves.

metadata_availableboolean required

False when models.dev could not be read; descriptions are then absent.

Changes

  • fbee488d4d9fRevision changes
    • info

      added the optional property to the response with the status

  • 7e2c656c745dRevision changes
    • info

      added the new optional query request parameter capability

    • info

      added the new optional query request parameter direction

    • info

      added the new optional query request parameter include_facets

    • info

      added the new optional query request parameter input_modality

    • info

      added the new optional query request parameter max_input

    • info

      added the new optional query request parameter min_context

    • info

      added the new optional query request parameter output_modality

    • info

      added the new optional query request parameter pricing

    • info

      added the new optional query request parameter provider

    • info

      added the new optional query request parameter released_within_days

    • info

      added the new optional query request parameter sort

    • info

      added the new optional query request parameter source

    • info

      added the new optional query request parameter vendor

    • info

      added the optional property to the response with the status