Skip to main content
GET
List Models

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

task
string | null

Task category, e.g. embedding, detection, transcription

modality
string | null

Input or output modality, e.g. image, video, text

status
string | null

Run status: served, extractor, api, plugin or not_runnable

commercial_use
boolean | null

Only models whose license allows commercial use (true) or not

license
string | null

License id, e.g. apache-2.0

gpu
boolean | null

true: needs a GPU. false: runs without one

template
string | null

Only models a namespace template uses (template slug)

use_case
string | null

Use case tag

q
string | null

Words that must all appear in the model's text fields

sort
string
default:rank

rank, name, release_date, params, size, dims or templates

order
string | null

asc or desc; each sort has a default

Pattern: ^(asc|desc)$
view
string
default:full

full records or compact index lines

Pattern: ^(full|compact)$
limit
integer
default:100

Page size

Required range: 1 <= x <= 500
offset
integer
default:0

Records to skip

Required range: x >= 0

Response

Successful Response

A filtered, sorted page of the model catalog.

total
integer
required

Records that match the filters

count
integer
required

Records in this page

offset
integer
required

Index of the first record in this page

limit
integer
required

Page size requested

sort
string
required

Sort key applied

order
string
required

asc or desc

view
string
required

full (whole records) or compact (index lines)

facets
Facets · object

Counts per value over the matching records, for each filterable field: status, category, modalities_in, modalities_out, license, commercial_use, use_cases, gpu and templates

models
Models · object[]

Model records: identity, task, input and output schema, how the model is wired into extractors and retriever stages, how it runs (status, weights, scale to zero), cost, evaluation evidence, references (hf://, mixpeek://, github://, api://, url://), the templates that use it, usage, rank and flat facets

rank_formula
string | null

How rank_score is computed