Docs — API Reference/docs/api-reference/models
Models
Read-only endpoints over the model catalog. Bare aliases (y0-fast) track the current release; dated snapshots (y0-fast-2026-05) are frozen forever — pin a snapshot when you need determinism.
[ 01 ]get — /v1/models
GET
/v1/modelsList every model your key can invoke, including dated snapshots.
| param | type | req | description |
|---|---|---|---|
| family | string | optional | Filter by family slug, e.g. "text" or "agents". Query parameter. |
| status | string | optional | Filter: "available", "preview", or "research". Query parameter. |
[ response ]200 ok
{
"object": "list",
"data": [
{ "id": "y0-fast", "family": "text", "status": "available", "alias_of": "y0-fast-2026-05" },
{ "id": "y0-fast-2026-05", "family": "text", "status": "available", "snapshot": true },
{ "id": "y0-deep", "family": "reasoning", "status": "available", "alias_of": "y0-deep-2026-04" },
{ "id": "y0-vision", "family": "vision", "status": "preview" }
]
}[ 02 ]get — /v1/models/:id
GET
/v1/models/:idRetrieve one model with its limits and current benchmark scores.
| param | type | req | description |
|---|---|---|---|
| id | string | required | Model id or alias, e.g. y0-fast. Path parameter. |
[ response ]200 ok
{
"id": "y0-fast-2026-05",
"object": "model",
"family": "text",
"status": "available",
"context_window": 128000,
"max_steps_ceiling": 16,
"benchmarks": { "LongDoc-Faithful": 0.912, "SchemaExact": 0.968 },
"deprecation": null
}More resources