Get a specific model with provider info and profile

GET

/v1/llm-models/{id}

• Production API

Parameters

Path Parameters

id

required

string

Model ID (prefixed, e.g., mod_…)

Responses

200

Model found

Wrapper that adds API and UI links to a serialized resource.

Uses self_url (not url) for the API link to avoid collision with resources that already have a url field (e.g. McpServer).

object

capabilities

required

Array<string>

created_at

required

string format: date-time

display_name

required

string

enabled

required

Whether this model is enabled (visible in UI model pickers)

boolean

healthy

required

Derived: model is configured and ready for use. Currently means the joined provider is active and has an API key set; over time this may also incorporate live reachability checks. Not persisted.

boolean

id

required

string

Example

model_01933b5a00007000800000000000001

is_favorite

required

boolean

model_id

required

string

profile

One of:

null

null

object

Readonly profile with model capabilities (not persisted to database)

object

attachment

required

Whether the model supports file/image attachments

boolean

cost

One of:

null

null

object

Cost per million tokens

object

cache_read

Cached read cost per million tokens (USD), if supported

number | null format: double

cost_tiers

Tiered pricing that applies above certain context thresholds. When present, the base cost fields apply up to the tier threshold, and each tier’s costs apply for tokens beyond that threshold.

Array<object>

A pricing tier that activates above a context token threshold. For example, OpenAI charges higher rates for prompts exceeding 200K tokens.

object

above_tokens

required

Context token threshold above which this tier applies

integer format: int32

cache_read

Cached read cost per million tokens (USD) for this tier, if supported

number | null format: double

input

required

Input cost per million tokens (USD) for this tier

number format: double

output

required

Output cost per million tokens (USD) for this tier

number format: double

input

required

Input cost per million tokens (USD)

number format: double

output

required

Output cost per million tokens (USD)

number format: double

description

Short human-readable description of the model’s strengths and intended use

string | null

family

required

Model family (e.g., “gpt-4o”, “claude-3-5-sonnet”)

string

knowledge

Knowledge cutoff date (YYYY-MM-DD format)

string | null

last_updated

Last updated date (YYYY-MM-DD format)

string | null

limits

One of:

null

null

object

Token limits

object

context

required

Maximum context window size in tokens

integer format: int32

input

Maximum input tokens (if different from context - output)

integer | null format: int32

max_media

Maximum images or PDF pages per request

integer | null format: int32

output

required

Maximum output tokens

integer format: int32

modalities

One of:

null

null

object

Supported modalities

object

input

required

Supported input modalities

Array<string>

Allowed values: text image audio video pdf

output

required

Supported output modalities

Array<string>

Allowed values: text image audio video pdf

name

required

Display name of the model

string

open_weights

required

Whether the model has open weights

boolean

reasoning

required

Whether the model has reasoning/chain-of-thought capabilities

boolean

reasoning_effort

One of:

null

null

object

Reasoning effort configuration (for reasoning models)

object

default

required

Default reasoning effort for this model

string

Allowed values: none minimal low medium high xhigh

values

required

Available reasoning effort values for this model

Array<object>

Named reasoning effort value for UI display

object

name

required

Display name (e.g., “Low”, “Medium”)

string

value

required

The API value (e.g., “low”, “medium”)

string

Allowed values: none minimal low medium high xhigh

release_date

Release date (YYYY-MM-DD format)

string | null

structured_output

required

Whether the model supports structured output (JSON mode)

boolean

supports_phases

Whether the model supports native execution phases (“commentary” / “final_answer”). When true, the driver sends the phase field on assistant messages in the wire format. Currently supported by GPT-5.4 and newer via OpenAI Responses API.

boolean

temperature

required

Whether temperature control is supported

boolean

tool_call

required

Whether the model supports tool/function calling

boolean

tool_search

Whether the model supports tool_search (deferred tool loading). When true, the driver can use namespaces and defer_loading to reduce token usage for large tool sets. Currently supported by GPT-5.4 and newer.

boolean

provider_id

required

string

Example

provider_01933b5a00007000800000000000001

provider_name

required

string

provider_type

required

LLM provider type

string

Allowed values: openai azure_openai openai_completions anthropic gemini llmsim

source

required

How the model was added to the system

string

Allowed values: manual discovered predefined

updated_at

required

string format: date-time

self_url

required

Full API endpoint URL for this resource.

string

ui_link

required

Alias for view_url, used by command and MCP outputs.

string

view_url

required

Full UI URL for viewing this resource.

string

400

Invalid model ID

404

Model not found