Usage and Models - ModelsLab

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

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:

curl --request GET 'https://modelslab.com/api/v6/model-search?key=<api_key>&search=flux'