Retrieve Model - Anthropic Models API

Trust: ★★★☆☆ (0.90) · 0 validations · developer_reference

Published: 2026-05-10 · Source: crawler_authoritative

Tình huống

Guide for retrieving specific model information by ID or alias using the Anthropic Models API CLI and REST endpoint.

Insight

The Models API provides two interfaces for retrieving model information: CLI command $ ant models retrieve and REST endpoint GET /v1/models/{model_id}. The response contains comprehensive model metadata including the unique identifier, human-readable display name, release timestamp, token limits, and detailed capability flags. Capabilities are nested objects with supported: boolean properties indicating whether each feature is available. Supported capabilities include: batch (Batch API support), citations (citation generation), code_execution (code execution tools), image_input (image content blocks), pdf_input (PDF content blocks), structured_outputs (JSON mode/strict tool schemas), and thinking (with sub-types adaptive and enabled). Context management strategies include clear_thinking_20251015, clear_tool_uses_20250919, and compact_20260112. Effort levels indicate support for reasoning_effort with values: low, medium, high, max, and xhigh. The model object type is always ‘model’ and created_at is returned as an RFC 3339 datetime string.

Hành động

Use $ ant models retrieve --model-id <string> to get model details via CLI. Required parameter: —model-id accepts a model identifier string or alias. Optional parameter: —beta accepts an array of AnthropicBeta values to specify beta version(s). For REST API: send GET request to /v1/models/{model_id} with model_id path parameter. Response returns model_info object containing: id (string), capabilities (nested object with 10+ capability flags), created_at (RFC 3339 datetime), display_name (string), max_input_tokens (number), max_tokens (number), and type (‘model’).

Kết quả

Returns a model_info object containing the model’s unique identifier, capability information showing which features are supported, release date in RFC 3339 format, human-readable display name, maximum input token limit, maximum output token limit, and object type designation.


Nội dung gốc (Original)

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: string

    Model identifier or alias.

  • --beta: optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

Returns

  • model_info: object { id, capabilities, created_at, 4 more }

    • id: string

      Unique model identifier.

    • capabilities: object { batch, citations, code_execution, 6 more }

      Model capability information.

      • batch: object { supported }

        Whether the model supports the Batch API.

        • supported: boolean

          Whether this capability is supported by the model.

      • citations: object { supported }

        Whether the model supports citation generation.

        • supported: boolean

          Whether this capability is supported by the model.

      • code_execution: object { supported }

        Whether the model supports code execution tools.

        • supported: boolean

          Whether 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: boolean

            Whether this capability is supported by the model.

        • clear_tool_uses_20250919: object { supported }

          Indicates whether a capability is supported.

          • supported: boolean

            Whether this capability is supported by the model.

        • compact_20260112: object { supported }

          Indicates whether a capability is supported.

          • supported: boolean

            Whether this capability is supported by the model.

        • supported: boolean

          Whether 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: boolean

            Whether this capability is supported by the model.

        • low: object { supported }

          Whether the model supports low effort level.

          • supported: boolean

            Whether this capability is supported by the model.

        • max: object { supported }

          Whether the model supports max effort level.

          • supported: boolean

            Whether this capability is supported by the model.

        • medium: object { supported }

          Whether the model supports medium effort level.

          • supported: boolean

            Whether this capability is supported by the model.

        • supported: boolean

          Whether this capability is supported by the model.

        • xhigh: object { supported }

          Indicates whether a capability is supported.

          • supported: boolean

            Whether this capability is supported by the model.

      • image_input: object { supported }

        Whether the model accepts image content blocks.

        • supported: boolean

          Whether this capability is supported by the model.

      • pdf_input: object { supported }

        Whether the model accepts PDF content blocks.

        • supported: boolean

          Whether this capability is supported by the model.

      • structured_outputs: object { supported }

        Whether the model supports structured output / JSON mode / strict tool schemas.

        • supported: boolean

          Whether this capability is supported by the model.

      • thinking: object { supported, types }

        Thinking capability and supported type configurations.

        • supported: boolean

          Whether 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: boolean

              Whether this capability is supported by the model.

          • enabled: object { supported }

            Whether the model supports thinking with type ‘enabled’.

            • supported: boolean

              Whether this capability is supported by the model.

    • created_at: string

      RFC 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: string

      A human-readable name for the model.

    • max_input_tokens: number

      Maximum input context window size in tokens for this model.

    • max_tokens: number

      Maximum value for the max_tokens parameter 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

Liên kết

Xem thêm: