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

# Usage and Models

> Retrieve usage, product limits, and discover models through the Agents API and generic model-search APIs.

## Usage Endpoints

| Method | Endpoint | Auth | Purpose |
| - | - | - | - |
| `GET` | `/api/agents/v1/usage/summary` | Bearer token | High-level usage, limits, and wallet |
| `GET` | `/api/agents/v1/usage/products` | Bearer token | Product-wise plan limits/remaining |
| `GET` | `/api/agents/v1/usage/history` | Bearer token | Usage timeline (`from`, `to`, `limit`) |

Usage history query parameters:

* `from` (optional, date)
* `to` (optional, date)
* `limit` (optional, integer, max 200)

## Agent Model Discovery Endpoints

| Method | Endpoint | Auth | Purpose |
| - | - | - | - |
| `GET` | `/api/agents/v1/models` | Bearer token | Search/filter paginated model catalog |
| `GET` | `/api/agents/v1/models/filters` | Bearer token | Filter metadata (sorts/types/base models/features) |
| `GET` | `/api/agents/v1/models/tags` | Bearer token | Active model tags |
| `GET` | `/api/agents/v1/models/providers` | Bearer token | Providers list |
| `GET` | `/api/agents/v1/models/{modelId}` | Bearer token | Model details (includes `parameters` JSON Schema) |

The model detail endpoint returns endpoint configurations with a `parameters` object — a JSON Schema describing each endpoint's accepted parameters (types, constraints, defaults, enums). This provides a clean, machine-readable alternative to the raw UI `config` array.

Common model query parameters:

* `feature`
* `search`
* `model_type`
* `model_subcategory`
* `base_model`
* `provider`
* `sort` (`recommended`, `latest`, `most-used`, `asc`, `desc`, `sort-asc`, `sort-desc`)
* `per_page`
* `tags` (array or comma-separated)

### Example

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request GET 'https://modelslab.com/api/agents/v1/models?feature=imagen&search=flux&per_page=20' \
  --header 'Authorization: Bearer <agent_access_token>'
```

## Generic Model Discovery under Existing API Key Flow

These endpoints are available for existing API-key users as well:

| Method | Endpoint | Auth |
| - | - | - |
| `GET` | `/api/v6/model-search` | API key (`key`) |
| `GET` | `/api/v6/model-search/filters` | API key (`key`) |
| `GET` | `/api/v6/model-search/tags` | API key (`key`) |
| `GET` | `/api/v6/model-search/providers` | API key (`key`) |
| `GET` | `/api/v6/model-search/{modelId}` | API key (`key`) |

Example:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request GET 'https://modelslab.com/api/v6/model-search?key=<api_key>&search=flux'
```


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