---
title: "Get Model by Name"
method: GET
path: "/models/{model_name}"
tags: ["Models"]
---

# Get Model by Name

`GET /models/{model_name}`

Get detailed information about a specific model by its name, including pricing.

## Path parameters

- `model_name` string, required

## Headers

- `authorization` string, nullable
- `x_session_token` string, nullable

## Response `200`

Successful Response

- ModelRead — Schema for reading model information including pricing.
  - `name` string, required — Name of the model
  - `provider` string, required — Provider of the model (e.g., openai, anthropic)
  - `model_type` string, required — Type of model: 'llm', 'embedding', or 'image'
  - `context_limit` integer, required — Maximum context window size in tokens
  - `max_output_tokens` integer, nullable — Maximum number of output tokens
  - `supports_tools` boolean, nullable — Whether the model supports tool/function calling
  - `supports_vision` boolean, nullable — Whether the model accepts image input
  - `supports_audio_input` boolean, nullable — Whether the model accepts audio input
  - `supports_video_input` boolean, nullable — Whether the model accepts video input
  - `supports_image_output` boolean, nullable — Whether the model can generate images
  - `supports_audio_output` boolean, nullable — Whether the model can generate audio/speech
  - `supports_video_output` boolean, nullable — Whether the model can generate video
  - `supports_thinking` boolean, nullable — Whether the model is marked as reasoning/thinking capable
  - `thinking_controls` ThinkingControlsRead
    - `supported` boolean, required — Whether the model exposes configurable thinking controls
    - `allowed_fields` string[] — Public thinking fields accepted by this model
    - `defaults_only` boolean, required — Whether the model supports reasoning defaults only, without tunable controls
  - `supports_json_output` boolean, nullable — Whether the catalog marks this model as supporting JSON object / structured text responses (null if unknown)
  - `api_mode` string, nullable — API mode/routing hint (e.g., chat_completions, responses, completions)
  - `embedding_dimensions` integer, nullable — Embedding dimensions (for embedding models)
  - `input_cost_per_1m_tokens` number, nullable — Text input cost per 1M tokens (USD)
  - `cached_input_cost_per_1m_tokens` number, nullable — Cached text input cost per 1M tokens (USD)
  - `cache_write_input_cost_per_1m_tokens` number, nullable — Cache-write text input cost per 1M tokens (USD)
  - `image_input_cost_per_1m_tokens` number, nullable — Image input cost per 1M tokens (USD)
  - `output_cost_per_1m_tokens` number, nullable — Text output cost per 1M tokens (USD)
  - `image_output_cost_per_1m_tokens` number, nullable — Image output cost per 1M tokens (USD)
  - `cost_per_image` number, nullable — Flat cost per generated image (USD), for dall-e style models
  - `tier_change_token_threshold` integer, nullable — Token threshold after which tier-2 pricing applies
  - `input_cost_per_1m_tokens_tier2` number, nullable — Tier-2 input cost per 1 million tokens
  - `cached_input_cost_per_1m_tokens_tier2` number, nullable — Tier-2 cached input cost per 1 million tokens
  - `cache_write_input_cost_per_1m_tokens_tier2` number, nullable — Tier-2 cache-write input cost per 1 million tokens
  - `output_cost_per_1m_tokens_tier2` number, nullable — Tier-2 output cost per 1 million tokens
  - `last_updated` string, date-time, nullable — Last time the model was updated

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/backboard/apis/backboard-api.md) · [All operations](https://skmtc.dev/backboard/apis/backboard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/backboard/backboard-api/revisions/e732d11ca11a/schema)