---
title: "List Models"
method: GET
path: "/v1/models"
---

# List Models

`GET /v1/models`

## Query parameters

- `format` 'default' | 'openrouter' | 'huggingface' — Output format for public models endpoint.

## Headers

- `X-Amz-Cf-Id` string, nullable
- `CF-RAY` string, nullable

## Response `200`

Successful Response

- union
  - ModelMetadataList
    - `data` ModelMetadata[], required
      - `created` integer
      - `id` string, required
      - `object` 'model'
      - `owned_by` string
    - `object` 'list'
  - OpenRouterModelsResponse — OpenRouter-compatible list of models.
    - `data` OpenRouterModel[], required
      - `context_length` integer, required
      - `created` integer, required — Unix timestamp when model was created
      - `datacenters` DatacenterLocation[] — Datacenter locations
        - `country_code` string, required — ISO 3166 Alpha-2 country code
      - `description` string — Model description
      - `hugging_face_id` string — The corresponding HuggingFace Hub model ID, if available
      - `id` string, required — Model ID with provider prefix, e.g., 'cerebras/llama3.1-8b'
      - `input_modalities` string[] — Supported input modalities (text, image, file)
      - `max_output_length` integer, required — Maximum number of output tokens
      - `name` string, required
      - `openrouter` OpenRouterInfo — OpenRouter metadata.
        - `slug` string, required — OpenRouter slug for the model
      - `output_modalities` string[] — Supported output modalities (text, image, file)
      - `pricing` OpenRouterPricing, required — OpenRouter pricing format.
        - `completion` string, required — Cost per output token as string
        - `image` string — Cost per image as string
        - `input_cache_read` string — Cost per cached input token read as string
        - `input_cache_write` string — Cost per cached input token write as string
        - `prompt` string, required — Cost per input token as string
        - `request` string — Cost per request as string
      - `quantization` string — Model quantization (fp16 only for Cerebras)
      - `supported_features` string[] — List of supported features
      - `supported_sampling_parameters` string[] — List of supported sampling parameters
  - HuggingFaceModelsResponse — HuggingFace-compatible list of models.
    - `data` HuggingFaceModel[], required
      - `capabilities` HuggingFaceCapabilities — HuggingFace capabilities format.
        - `function_calling` boolean
        - `streaming` boolean
        - `structured_outputs` boolean
        - `vision` boolean
      - `context_length` integer, required — Supported context length in tokens
      - `created` integer, required
      - `hugging_face_id` string, nullable — The corresponding HuggingFace Hub model ID
      - `id` string, required
      - `object` 'model'
      - `owned_by` string, required
      - `pricing` HuggingFacePricing, required — HuggingFace pricing format - price in USD per million tokens.
        - `input` number, required — Price in USD per million input tokens
        - `output` number, required — Price in USD per million output tokens
    - `object` 'list'

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/cerebras/apis/cerebras-cloud-api.md) · [All operations](https://skmtc.net/cerebras/apis/cerebras-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cerebras/cerebras-cloud-api/versions/130749c46caf/schema)