6.0 KiB
List
$ ant models list
get /v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
Parameters
-
--after-id: optional stringQuery param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
-
--before-id: optional stringQuery param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
-
--limit: optional numberQuery param: Number of items to return per page.
Defaults to
20. Ranges from1to1000. -
--beta: optional array of AnthropicBetaHeader param: Optional header to specify the beta version(s) you want to use.
Returns
-
ListResponse_ModelInfo_: object { data, first_id, has_more, last_id }-
data: array of ModelInfo-
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".
-
-
first_id: stringFirst ID in the
datalist. Can be used as thebefore_idfor the previous page. -
has_more: booleanIndicates if there are more results in the requested page direction.
-
last_id: stringLast ID in the
datalist. Can be used as theafter_idfor the next page.
-
Example
ant models list \
--api-key my-anthropic-api-key