Skip to main content

​
Usage Endpoints

MethodEndpointAuthPurpose
GET/api/agents/v1/usage/summaryBearer tokenHigh-level usage, limits, and wallet
GET/api/agents/v1/usage/productsBearer tokenProduct-wise plan limits/remaining
GET/api/agents/v1/usage/historyBearer tokenUsage timeline (from, to, limit)
Usage history query parameters:
  • from (optional, date)
  • to (optional, date)
  • limit (optional, integer, max 200)

​
Agent Model Discovery Endpoints

MethodEndpointAuthPurpose
GET/api/agents/v1/modelsBearer tokenSearch/filter paginated model catalog
GET/api/agents/v1/models/filtersBearer tokenFilter metadata (sorts/types/base models/features)
GET/api/agents/v1/models/tagsBearer tokenActive model tags
GET/api/agents/v1/models/providersBearer tokenProviders list
GET/api/agents/v1/models/{modelId}Bearer tokenModel 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:
MethodEndpointAuth
GET/api/v6/model-searchAPI key (key)
GET/api/v6/model-search/filtersAPI key (key)
GET/api/v6/model-search/tagsAPI key (key)
GET/api/v6/model-search/providersAPI 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'