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

# List models

`GET /v1/models`

## Request

- Base URL: `https://api.liquidcompute.co`
- URL: `https://api.liquidcompute.co/v1/models`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Lists the models at least one healthy GPU node is serving right now,
in OpenAI's model list format. The key may be sent as
`Authorization: Bearer` or `X-API-Key`, never both.

Requires the `inference` entitlement family; requests without it
return `404` `not_found`.

## Response `200`

The models being served.

- ModelList
  - `object` 'list', required
  - `data` Model[], required
    - `id` string, required
    - `object` 'model', required
    - `created` integer, required
    - `owned_by` string, required
    - `context_length` integer: The longest prompt plus completion the model accepts, in tokens.
    - `max_output_tokens` integer: The longest completion the model returns, in tokens.
    - `pricing` object: The model's current prices in USD per token, as decimal strings.
      - `prompt` string: USD per token, as a decimal string such as `0.00000015`.
      - `completion` string: USD per token, as a decimal string such as `0.00000015`.
      - `input_cache_read` string: USD per token, as a decimal string such as `0.00000015`.

## Other responses

- `401`: Missing or invalid API key, or both key headers sent.
- `404`: The key's organization lacks the `inference` entitlement.
- `429`: Your key's rate limit was exceeded (`rate_limited`), your key already has as many completions in progress as its tier allows (`concurrency_limited`), or every GPU node serving the model is at capacity (`capacity_exhausted`); retry after `Retry-After`.
- `502`: The model router could not be reached or answered outside its contract (`upstream_error`); retry shortly.
- `503`: No GPU node is serving the model right now (`no_healthy_node`), the model router is still loading its catalogue (`warming_up`, with `Retry-After`), or API-key validation is temporarily unavailable (`service_unavailable`).

---

[API](https://skmtc.dev/liquidcompute/apis/liquidcompute-api.md) - [All operations](https://skmtc.dev/liquidcompute/apis/liquidcompute-api/llms.txt) - [OpenAPI document](https://skmtc.dev/liquidcompute/apis/liquidcompute-api/revisions/f58bc0aabb07?raw)