Claude Platform Docs

Models

List Models
beta.models.list(ModelListParams**kwargs) -> SyncPage[BetaModelInfo]
GET/v1/models
Get a Model
beta.models.retrieve(strmodel_id, ModelRetrieveParams**kwargs) -> BetaModelInfo
GET/v1/models/{model_id}
Models
class BetaCapabilitySupport:

Indicates whether a capability is supported.

supported: bool

Whether this capability is supported by the model.

class BetaContextManagementCapability:

Context management capability details.

clear_thinking_20251015: Optional[BetaCapabilitySupport]

Indicates whether a capability is supported.

supported: bool

Whether this capability is supported by the model.

clear_tool_uses_20250919: Optional[BetaCapabilitySupport]

Indicates whether a capability is supported.

supported: bool

Whether this capability is supported by the model.

compact_20260112: Optional[BetaCapabilitySupport]

Indicates whether a capability is supported.

supported: bool

Whether this capability is supported by the model.

supported: bool

Whether this capability is supported by the model.

class BetaEffortCapability:

Effort (reasoning_effort) capability details.

Whether the model supports high effort level.

supported: bool

Whether this capability is supported by the model.

Whether the model supports low effort level.

supported: bool

Whether this capability is supported by the model.

Whether the model supports max effort level.

supported: bool

Whether this capability is supported by the model.

Whether the model supports medium effort level.

supported: bool

Whether this capability is supported by the model.

supported: bool

Whether this capability is supported by the model.

xhigh: Optional[BetaCapabilitySupport]

Indicates whether a capability is supported.

supported: bool

Whether this capability is supported by the model.

class BetaModelCapabilities:

Model capability information.

class BetaModelInfo:
id: str

Unique model identifier.

allowed_fallback_models: Optional[List[str]]

Model IDs this model accepts as fallbacks[i].model on the Messages API. An empty list means the fallbacks parameter is not supported for this model as primary.

capabilities: Optional[BetaModelCapabilities]

Model capability information.

created_at: datetime

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.

formatdate-time
display_name: str

A human-readable name for the model.

max_input_tokens: Optional[int]

Maximum input context window size in tokens for this model.

max_tokens: Optional[int]

Maximum value for the max_tokens parameter when using this model.

type: Literal["model"]

Object type.

For Models, this is always "model".

defaultmodel
class BetaThinkingCapability:

Thinking capability details.

supported: bool

Whether this capability is supported by the model.

Supported thinking type configurations.

Whether the model supports thinking with type 'adaptive' (auto).

supported: bool

Whether this capability is supported by the model.

Whether the model supports thinking with type 'enabled'.

supported: bool

Whether this capability is supported by the model.

class BetaThinkingTypes:

Supported thinking type configurations.

Whether the model supports thinking with type 'adaptive' (auto).

supported: bool

Whether this capability is supported by the model.

Whether the model supports thinking with type 'enabled'.

supported: bool

Whether this capability is supported by the model.