---
title: "Get Model"
method: GET
path: "/v1/models/{model}"
tags: ["Models"]
---

# Get Model

`GET /v1/models/{model}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Get a model by name and provide basic information.

## Path parameters

- `model` string, required: The name of the model to get.

## Response `200`

Successful Response

- Model
  - `object` 'model': Type of the object.
  - `id` string, required: The model identifier, which can be referenced in the API endpoints.
  - `type` 'automatic-speech-recognition' | 'image-to-text' | 'text-classification' | 'text-embeddings-inference' | 'text-generation', required
  - `aliases` string[]: Aliases of the model. It will be used to identify the model by users.
  - `created` integer, required: Time of creation, as Unix timestamp.
  - `owned_by` string, required: The organization that owns the model.
  - `max_context_length` integer, nullable: Maximum amount of tokens a context could contains. Makes sure it is the same for all models.
  - `costs` ModelCosts
    - `prompt_tokens` number: Cost of a million prompt tokens (decrease user budget)
    - `completion_tokens` number: Cost of a million completion tokens (decrease user budget)

## Other responses

- `401`: Invalid authentication scheme.<br>Invalid API key.
- `403`: Your account has expired. Please contact support to renew your account.
- `404`: Model {name} not found.
- `422`: Validation Error

## Changes

- **2026-09-29** `2f7a4a0aac8f`: 1 info
  - endpoint added
- **2026-09-29** `da70d9cd1957`: 1 breaking
  - api path removed without deprecation
- **2026-09-21** `5fdbd3614b8c`: 1 breaking, 5 warning, 2 info
  - the `type` response's property type changed from no type to `string` for status `200`
  - added the new `automatic-speech-recognition` enum value to the `type` response property for the response status `200`
  - added the new `image-to-text` enum value to the `type` response property for the response status `200`
  - added the new `text-classification` enum value to the `type` response property for the response status `200`
  - …4 more
- **2026-05-23** `d3e7e6dcdd41`: 1 info
  - added the non-success response with the status `403`
- **2026-04-30** `d5f1d3d5614e`: 2 info
  - added `#/components/schemas/api__domain__model__entities__ModelType` to the `type` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/ModelType` from the `type` response property `anyOf` list for the response status `200`

[Operation history](https://skmtc.dev/betagouv/apis/opengatellm/changes/v1/models/:model/get.md)

---

[API](https://skmtc.dev/betagouv/apis/opengatellm.md) - [All operations](https://skmtc.dev/betagouv/apis/opengatellm/llms.txt) - [OpenAPI document](https://skmtc.dev/betagouv/apis/opengatellm/revisions/2f7a4a0aac8f?raw)
