Models List API

Retrieves a list of all available image and video models.

Get All Models

curl "https://api.imagerouter.io/v1/models"

const url = 'https://api.imagerouter.io/v1/models'
const response = await fetch(url)
const data = await response.json()
console.log(data)

import requests
url = "https://api.imagerouter.io/v1/models"
response = requests.get(url)
print(response.json())

Open in browser: https://api.imagerouter.io/v1/models

This endpoint supports filtering, sorting, and pagination to help you find the models you need.

Sort & Filter models

Query Parameters

Parameter	Type	Description
`type`	string	Filter models by type. Can be `image` or `video`.
`provider`	string	Filter models by provider. (e.g., `google`, `openai`). Supports partial matching.
`free`	boolean	Filter for free models. Use `true` to get only free models and `false` for paid models.
`name`	string	Filter models by name (ID). Supports partial matching.
`sort`	string	Sort the results. Options: `name`, `provider`, `price`, `date`.
`limit`	integer	Limit the number of models returned.

Sorting Order

name: Alphabetical (A-Z).
provider: Alphabetical (A-Z).
price: Ascending (lowest price first).
date: Descending (newest first).

Examples

Get all image models from Google

curl "https://api.imagerouter.io/v1/models?type=image&provider=google"

const url = 'https://api.imagerouter.io/v1/models?type=image&provider=google'
const response = await fetch(url)
const data = await response.json()
console.log(data)

import requests

url = "https://api.imagerouter.io/v1/models"
params = {
  "type": "image",
  "provider": "google"
}

response = requests.get(url, params=params)
print(response.json())

Get 10 latest Video models

curl "https://api.imagerouter.io/v1/models?type=video&limit=10&sort=date"

const url = 'https://api.imagerouter.io/v1/models?type=video&limit=10&sort=date'
const response = await fetch(url)
const data = await response.json()
console.log(data)

import requests

url = "https://api.imagerouter.io/v1/models"
params = {
  "type": "video",
  "limit": 10,
  "sort": "date"
}

response = requests.get(url, params=params)
print(response.json())

Get all free models

curl "https://api.imagerouter.io/v1/models?free=true"

const url = 'https://api.imagerouter.io/v1/models?free=true'
const response = await fetch(url)
const data = await response.json()
console.log(data)

import requests

url = "https://api.imagerouter.io/v1/models"
params = {
  "free": True
}

response = requests.get(url, params=params)
print(response.json())

Get all models, sorted by release date

curl "https://api.imagerouter.io/v1/models?sort=date"

const url = 'https://api.imagerouter.io/v1/models?sort=date'
const response = await fetch(url)
const data = await response.json()
console.log(data)

import requests

url = "https://api.imagerouter.io/v1/models"
params = {
  "sort": "date"
}

response = requests.get(url, params=params)
print(response.json())

Get a specific model

Retrieves a single model by its ID.

GET /v1/models/:modelId

Path Parameters

Parameter	Type	Description
`modelId`	string	The ID of the model.

Example

Get the google%2Fgemini-2.5-flash model

curl "https://api.imagerouter.io/v1/models/google%2Fgemini-2.5-flash"

const url = 'https://api.imagerouter.io/v1/models/google%2Fgemini-2.5-flash'
const response = await fetch(url)
const data = await response.json()
console.log(data)

import requests

url = "https://api.imagerouter.io/v1/models/google%2Fgemini-2.5-flash"

response = requests.get(url)
print(response.json())

If the model is not found, you will receive a 404 error:

{
    "error": {
        "message": "The model 'model-that-does-not-exist' does not exist.",
        "type": "invalid_request_error",
        "param": "model",
        "code": "model_not_found"
    }
}