> ## Documentation Index
> Fetch the complete documentation index at: https://www.carrothub.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# carrothub list

> List available model endpoints with optional filtering

Browse the model catalog. With no flags, every registered endpoint is printed,
grouped by provider.

## Synopsis

```bash theme={null}
carrothub list [options]
```

## Options

| Option | Description |
| - | - |
| `--provider <name>` | Filter by provider (e.g. `alibaba`, `google`, `klingai`, `midjourney`, `minimax`, `openai`, `bytedance`) |
| `--output-type <type>` | Filter by output type (`image`, `video`, `audio`, `text`) |
| `--tag <tag>` | Filter by tag, e.g. `SOTA` |
| `--site <site>` | Filter to models available on a given site |
| `--providers` | List provider names only — skip the model listing |
| `--json` | Output as JSON |

Unknown values for `--provider`, `--output-type`, or `--site` produce a yellow
warning but the command still runs (the result is just an empty match).

## Examples

```bash theme={null}
# Everything
carrothub list

# All Google models
carrothub list --provider google

# Every video endpoint
carrothub list --output-type video

# Only SOTA-tagged endpoints
carrothub list --tag SOTA

# Just the provider names
carrothub list --providers

# Machine-readable
carrothub list --json | jq '.models[] | .model_id + "/" + .action'
```

## Text output

Endpoints are grouped by provider and printed with their description, output
type, and tags. Each entry shows the canonical `provider/model/action` identifier
you can pass to [`params`](https://www.carrothub.ai/docs/cli/commands/params) and [`run`](https://www.carrothub.ai/docs/cli/commands/run).

```
[ALIBABA]
----------------------------------------

  alibaba/wan2.6-t2v/generation [SOTA]
    Wan2.6 Text-to-Video: ...
    Output: video

  alibaba/wan2.6-i2v/generation [SOTA]
    Wan2.6 Image-to-Video: ...
    Output: video
```

The footer shows the total endpoint count after filtering.

## JSON output

```json theme={null}
{
  "models": [
    {
      "model_id": "alibaba/wan2.6-t2v",
      "action": "generation",
      "provider": "alibaba",
      "model_name": "wan2.6-t2v",
      "description": "Wan2.6 Text-to-Video: ...",
      "input_types": ["text"],
      "output_type": "video",
      "api_path": "/vendors/alibaba/v1/wan2.6-t2v/generation",
      "available_on": ["carrothub", "mulerun"],
      "result_key": "videos",
      "tags": ["SOTA"]
    }
  ],
  "site": null
}
```

The `site` field reflects the `--site` filter you passed (or `null` when
unfiltered).

## See also

* [`carrothub params`](https://www.carrothub.ai/docs/cli/commands/params) — inspect the inputs a model accepts
* [Model cheatsheet](https://www.carrothub.ai/docs/cli/models.md) — curated overview of which model to pick


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.