# `smallforce media models search`

Search media models by intent

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.7. Run `smallforce media models search --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce media models search [options] <query>

Search media models by intent

Arguments:
  query                What you want to create, e.g. 'text to video'

Options:
  --limit <n>          Number of models to return, 1 to 25
  --category <slug>    Filter by category, e.g. text-to-image
  --modality <out>     Filter by output modality: image, video, audio
  --api-key <key>      SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>  SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json               Print stable machine-readable JSON
  --text               Print human-readable text
  --format <format>    Output format: text or json
  -h, --help           display help for command
```

## Related reference

- [`smallforce media models`](/docs/cli/commands/media/models): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.