# Models

## What you can run

```bash
layer base-models list
layer base-models list --modality video
layer base-models list --featured        # only the recommended ones
```

The catalogue is read from your workspace rather than shipped with the package, so a model added, hidden, or deprecated for your team shows up without a CLI upgrade. It is cached per deployment for a day; `--refresh` on a generate command ignores the cache.

## What a model accepts

```bash
layer base-models show bfl-flux-2-pro
```

Prints the model’s parameters — names, types, defaults, and allowed values — read from the same inference schema the app renders its form from. These are the keys `--param` takes:

```bash
layer generate image --base-model bfl-flux-2-pro --param transparency=true -p "..."
```

A key that model does not declare fails before the request is sent, so a typo costs nothing.

For per-model reference pages with the full request body and code samples, see the [Models](/docs/models) section.

## Machine-readable output

```bash
layer --json base-models list | jq -r '.base_models[].base_model_id'
```

`--json` puts the catalogue on stdout and nothing else — see [scripting](/docs/cli/scripting).