Skip to main content
GET
/
v2
/
models
List models with filters
curl --request GET \
  --url https://ai.liara.ir/v2/models
{
  "models": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "cutoff_date": "2023-12-25",
      "context_length": 123,
      "architecture": {
        "modality": "<string>",
        "input_modalities": [
          "<string>"
        ],
        "output_modalities": [
          "<string>"
        ],
        "tokenizer": "<string>",
        "instruct_type": "<string>"
      },
      "pricing": {
        "cost": "<string>",
        "prompt": "<string>",
        "completion": "<string>",
        "request": "<string>",
        "image": "<string>",
        "web_search": "<string>",
        "internal_reasoning": "<string>",
        "input_cache_read": "<string>",
        "input_cache_read_image": "<string>",
        "image_generation": "<string>",
        "image_type": "<string>",
        "image_details": {}
      },
      "top_provider": {
        "context_length": 123,
        "max_completion_tokens": 123,
        "is_moderated": true
      },
      "supported_parameters": [
        "<string>"
      ],
      "features": {
        "structured_outputs": true,
        "function_calling": true,
        "tuning": true,
        "streaming": true
      },
      "speed": 123,
      "endpoints": [
        {
          "title": "<string>",
          "route": "<string>"
        }
      ],
      "reasoning": true,
      "tags": [],
      "created": 123,
      "provider": "<string>"
    }
  ],
  "page": 123,
  "limit": 123,
  "total": 123
}

Query Parameters

Search models by name (regex match)

Maximum string length: 100
sort
enum<string>
default:newest

Sort order

Available options:
newest,
price_input_low,
price_input_high,
context_length
input_modalities

Filter by input modalities

output_modalities

Filter by output modalities

context_length_min
integer

Minimum context length

context_length_max
integer

Maximum context length

input_price_min
number

Minimum input price (per token, USD)

input_price_max
number

Maximum input price (per token, USD)

providers

Filter by provider prefix (e.g. anthropic, openai)

supported_params

Filter by supported parameters

page
integer
default:1

Page number (1-based)

Required range: x >= 1

Response

200 - application/json

Filtered and paginated model list

models
object[]
page
integer

Current page number

limit
integer

Page size (always 20)

total
integer

Total number of matching models