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 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'