---
title: "List base models"
method: GET
path: "/v2/workspaces/{workspace_id}/base-models"
tags: ["Base Models"]
---

# List base models

`GET /v2/workspaces/{workspace_id}/base-models`

List the base models enabled for this workspace, sourced from the model registry. Results come back in Layer's recommended order, which reflects synced quality and popularity signals and can therefore shift between requests. Reference sets are listed separately under /reference-sets.

## Path parameters

- `workspace_id` string, uuid, required — Id of the workspace that owns the resource.

## Query parameters

- `modality` 'text' | 'image' | 'audio' | 'video' | 'three_d' | 'playable'
- `search` string, nullable — Full-text search on name, aliases, and description
- `limit` integer — Maximum number of results to return.
- `cursor` string, nullable — Cursor from a previous response to fetch the next page.

## Response `200`

Successful Response

- ListBaseModelsOutput
  - `base_models` BaseModelSummary[], required
    - `base_model_id` string, required — Base model identifier, e.g. flux-dev — pass it as `base_model_id`.
    - `name` string, required — Display name.
    - `aliases` string[] — Community nicknames this model is also known by.
    - `modality` 'text' | 'image' | 'audio' | 'video' | 'three_d' | 'playable', required
    - `description` string, nullable — Short description.
    - `price_per_unit` number, nullable — CU cost per measurement unit.
    - `price_unit` string, nullable — Measurement unit, e.g. megapixel, second, generation.
    - `inference_timing` string, required — Typical generation time range, e.g. '5-15s'.
  - `pagination` PaginationOutput, required
    - `next_cursor` string, nullable — Cursor to use to get the next page
    - `has_more_results` boolean, required — If there are more results to page through
    - `total_count` integer, nullable — Total number of results matching the query

## Other responses

- `401` — Unauthenticated — missing or invalid Bearer token.
- `403` — Forbidden — insufficient permissions, or the access token lacks the scope the operation requires.
- `404` — Resource not found.
- `409` — The request with this `Idempotency-Key` is still running — retry after the number of seconds in `Retry-After`.
- `422` — Invalid input parameters, or an `Idempotency-Key` reused for a different request.
- `429` — Rate limited — retry after the number of seconds in `Retry-After`.
- `500` — Internal server error.

---

[API](https://skmtc.dev/layer/apis/layer-rest-api.md) · [All operations](https://skmtc.dev/layer/apis/layer-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/layer/layer-rest-api/revisions/fafc779f9ba2/schema)