---
title: "List Models"
method: GET
path: "/api/v1/models"
tags: ["Models"]
---

# List Models

`GET /api/v1/models`

## Request

- Base URL: `https://argus.axilio.ai`
- URL: `https://argus.axilio.ai/api/v1/models`
- Auth: none declared
- TypeScript: <https://skmtc.dev/axilioai/apis/argus-2/docs/api/v1/models/get.ts> (a function with typed inputs; its response is checked against the schema)

List every model Argus supports, with pricing.

Two families: the curated VLMs served by the locate methods (per-token
pricing; pass their id as `model`) and the Axilio model line behind
screenshots:detect (per-page pricing; selected via `ocr_engine` /
`inference_type` — lite is the free engine, pro is premium).

Public: no API key required (it's a catalog of model names and public
prices, nothing sensitive), so a client can discover supported models
before it holds credentials.

## Response `200`

Successful Response

- SupportedModelsResponse: Response for GET /models. Lists every model Argus supports, each with its final post-markup pricing: the curated VLMs for the element-locator task (per-token pricing; pass their id as `model` to POST /screenshots:locate or POST /elements:locate) and the Axilio model line behind POST /screenshots:detect (per-page pricing; selected via the `ocr_engine` and `inference_type` request fields — lite = the free engine, pro = premium). Lets a client compare cost and validate `find(model=...)` up front instead of round-tripping to /locate and getting a 400. The VLM set is curated: `/locate` enforces it — an unsupported model is rejected, so this is the authoritative allowlist, not just advisory. The Axilio ids are not /locate targets. Shaped like a standard /v1/models response ({object: "list", data: [...]}).
  - `data` ModelInfo[], required: Supported models, sorted by id.
    - `context_window` integer, required: Maximum context window, in tokens.
    - `id` string, required: Model identifier, e.g. 'anthropic/claude-sonnet-4.5' or 'axilio/argus-ocr-pro-1'. VLM ids are passed as `model` to the locate methods; Axilio ids identify the engine behind POST /screenshots:detect calls (selected via `ocr_engine` / `inference_type`) and are what usage rows are labeled with.
    - `name` string, required: Human-readable model name.
    - `object` 'model'
    - `owned_by` string, required: Model provider, e.g. 'anthropic' or 'axilio'.
    - `pricing` ModelPricing, required: The customer's billed rates, in integer microdollars (1,000,000 = $1.00). VLMs price per token (input/output per million tokens); the Axilio model line prices per page, where one screenshot is one page, so per_page_microdollars reads as the price of one call. A rate is 0 when that unit is free for the model.
      - `input_microdollars_per_million_tokens` integer, required: Price per million input tokens, in microdollars (1,000,000 = $1.00), after markup.
      - `output_microdollars_per_million_tokens` integer, required: Price per million output tokens, in microdollars (1,000,000 = $1.00), after markup.
      - `per_page_microdollars` integer, nullable: Price per page (one screenshot = one page), in microdollars (1,000,000 = $1.00), after markup, for the per-page-billed Axilio models. Absent for per-token models.
    - `type` 'vlm' | 'detect' | 'ocr' | 'vision', required: Model type: 'vlm' for the vision-language models served by the locate methods (POST /screenshots:locate, POST /elements:locate); 'detect', 'ocr', and 'vision' for the Axilio model line behind POST /screenshots:detect.
  - `object` 'list'

## Changes

- **2026-10-24** `62a8af730680`: 2 breaking, 5 warning, 3 info
  - removed the required property `data/items/pricing/input` from the response with the `200` status
  - removed the required property `data/items/pricing/output` from the response with the `200` status
  - removed the optional property `data/items/pricing/per_page` from the response with the `200` status
  - added the new `detect` enum value to the `data/items/type` response property for the response status `200`
  - …6 more
- **2026-10-17** `2e42e4860799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axilioai/apis/argus-2/changes/api/v1/models/get.md)

---

[API](https://skmtc.dev/axilioai/apis/argus-2.md) - [All operations](https://skmtc.dev/axilioai/apis/argus-2/llms.txt) - [OpenAPI document](https://skmtc.dev/axilioai/apis/argus-2/revisions/62a8af730680?raw)