Models List API
Retrieves a list of all available AI image and video models.
Get model by id
Section titled “Get model by id”Retrieves a single model by its id. Returns a single model object.
GET /v2/models/:modelId
https://api.imagerouter.io/v2/models/google%2Fgemini-2.5-flash
Path parameters
Section titled “Path parameters”| Parameter | Type | Description |
|---|---|---|
modelId | string | The ID of the model. |
Get All Models
Section titled “Get All Models”GET /v2/models
https://api.imagerouter.io/v2/models
Returns an array of model objects. Each object includes an id field identifying the model.
This endpoint supports filtering, sorting, limits, and field selection to help you find exactly the models and metadata you need.
Get all model names:
Section titled “Get all model names:”https://api.imagerouter.io/v2/models?fields=name
Get all model names and aliases:
Section titled “Get all model names and aliases:”https://api.imagerouter.io/v2/models?fields=name,aliases
Search, Filter, and Sort Models
Section titled “Search, Filter, and Sort Models”Examples:
Section titled “Examples:”Get free image models, but only show names, aliases, input and output types fields: https://api.imagerouter.io/v2/models?outputType=image&free=true&fields=aliases,inputs,output
Get all video models sorted by release date: https://api.imagerouter.io/v2/models?outputType=video&sort=date
Search by name and alias: https://api.imagerouter.io/v2/models?name=gemini
Get image models that accept input images (image editing models): https://api.imagerouter.io/v2/models?inputType=image&outputType=image
Get all video models with pricing data only: https://api.imagerouter.io/v2/models?outputType=video&fields=price,inputs
Query Parameters
Section titled “Query Parameters”| Parameter | Type | Description |
|---|---|---|
outputType | string | Filter by output type: image or video |
inputType | string | Filter by supported input: image, mask, quality, size, or seconds |
provider | string | Filter by provider name (partial, case-insensitive), e.g. google, openai |
free | string | true to show only free models, false to show only paid models |
name | string | Filter by model name or alias (partial, case-insensitive) |
sort | string | Sort by: name, provider, price, or date |
limit | number | Maximum number of models to return |
fields | string | Comma-separated list of fields to include in the response (see below) |
Available Fields
Section titled “Available Fields”When fields is omitted, all fields are returned. When specified, only the listed fields appear in each model object. The id field is always included.
| Field | Type | Description |
|---|---|---|
id | string | The model identifier, e.g. "black-forest-labs/FLUX-1.1-pro" |
output | string[] | Output type(s), e.g. ["image"] or ["video"] |
inputs | object | Supported input capabilities (see below) |
release_date | string | Release date in YYYY-MM-DD format (may be absent) |
aliases | string[] | Alternative names for this model (only present if aliases exist) |
price | object | Pricing info with min, average, and max fields (in USD) |
examples | object[] | Example outputs (only present on some models) |
inputs object fields:
| Field | Type | Description |
|---|---|---|
image | boolean | Whether the model accepts input image(s) |
mask | boolean | Whether the model accepts a mask for inpainting |
quality | boolean | Whether the model supports quality settings |
size | string[] | Supported sizes, e.g. ["1024x1024", "auto"] or ["custom"] |
seconds | (number|string)[] | Supported durations for video models, e.g. [4, 6, 8] or ["auto"] |
Sorting Order
Section titled “Sorting Order”name: Alphabetical (A-Z).provider: Alphabetical (A-Z).price: Ascending (lowest price first).date: Descending (newest first).