5.0 KiB
Retrieve
$ ant models retrieve
get /v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
Parameters
-
--model-id: stringModel identifier or alias.
-
--beta: optional array of AnthropicBetaOptional header to specify the beta version(s) you want to use.
Returns
-
model_info: object { id, capabilities, created_at, 4 more }-
id: stringUnique model identifier.
-
capabilities: object { batch, citations, code_execution, 6 more }Model capability information.
-
batch: object { supported }Whether the model supports the Batch API.
-
supported: booleanWhether this capability is supported by the model.
-
-
citations: object { supported }Whether the model supports citation generation.
-
supported: booleanWhether this capability is supported by the model.
-
-
code_execution: object { supported }Whether the model supports code execution tools.
-
supported: booleanWhether this capability is supported by the model.
-
-
context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }Context management support and available strategies.
-
clear_thinking_20251015: object { supported }Indicates whether a capability is supported.
-
supported: booleanWhether this capability is supported by the model.
-
-
clear_tool_uses_20250919: object { supported }Indicates whether a capability is supported.
-
supported: booleanWhether this capability is supported by the model.
-
-
compact_20260112: object { supported }Indicates whether a capability is supported.
-
supported: booleanWhether this capability is supported by the model.
-
-
supported: booleanWhether this capability is supported by the model.
-
-
effort: object { high, low, max, 3 more }Effort (reasoning_effort) support and available levels.
-
high: object { supported }Whether the model supports high effort level.
-
supported: booleanWhether this capability is supported by the model.
-
-
low: object { supported }Whether the model supports low effort level.
-
supported: booleanWhether this capability is supported by the model.
-
-
max: object { supported }Whether the model supports max effort level.
-
supported: booleanWhether this capability is supported by the model.
-
-
medium: object { supported }Whether the model supports medium effort level.
-
supported: booleanWhether this capability is supported by the model.
-
-
supported: booleanWhether this capability is supported by the model.
-
xhigh: object { supported }Indicates whether a capability is supported.
-
supported: booleanWhether this capability is supported by the model.
-
-
-
image_input: object { supported }Whether the model accepts image content blocks.
-
supported: booleanWhether this capability is supported by the model.
-
-
pdf_input: object { supported }Whether the model accepts PDF content blocks.
-
supported: booleanWhether this capability is supported by the model.
-
-
structured_outputs: object { supported }Whether the model supports structured output / JSON mode / strict tool schemas.
-
supported: booleanWhether this capability is supported by the model.
-
-
thinking: object { supported, types }Thinking capability and supported type configurations.
-
supported: booleanWhether this capability is supported by the model.
-
types: object { adaptive, enabled }Supported thinking type configurations.
-
adaptive: object { supported }Whether the model supports thinking with type 'adaptive' (auto).
-
supported: booleanWhether this capability is supported by the model.
-
-
enabled: object { supported }Whether the model supports thinking with type 'enabled'.
-
supported: booleanWhether this capability is supported by the model.
-
-
-
-
-
created_at: stringRFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
-
display_name: stringA human-readable name for the model.
-
max_input_tokens: numberMaximum input context window size in tokens for this model.
-
max_tokens: numberMaximum value for the
max_tokensparameter when using this model. -
type: "model"Object type.
For Models, this is always
"model".
-
Example
ant models retrieve \
--api-key my-anthropic-api-key \
--model-id model_id