Models

List Models

ModelListPage Beta.Models.List(parameters, cancellationToken = default)

GET/v1/models

List available models.

Get a Model

BetaModelInfo Beta.Models.Retrieve(parameters, cancellationToken = default)

GET/v1/models/{model_id}

Get a specific model.

Models

class BetaCapabilitySupport { Supported; }

Indicates whether a capability is supported.

required bool Supported

Whether this capability is supported by the model.

class BetaCompactionCapability { Summarize; Supported; }

Compaction capability details: whether the model accepts the top-level compaction request parameter, with one entry per supported compaction.type value.

required BetaCapabilitySupport Summarize

Whether the summarize compaction type is supported.

required bool Supported

Whether this capability is supported by the model.

required bool Supported

Whether this capability is supported by the model.

class BetaContextManagementCapability { ClearThinking20251015; ClearToolUses20250919; Compact20260112; Supported; }

Context management capability details.

required BetaCapabilitySupport? ClearThinking20251015

Indicates whether a capability is supported.

required bool Supported

Whether this capability is supported by the model.

required BetaCapabilitySupport? ClearToolUses20250919

Indicates whether a capability is supported.

required bool Supported

Whether this capability is supported by the model.

required BetaCapabilitySupport? Compact20260112

Indicates whether a capability is supported.

required bool Supported

Whether this capability is supported by the model.

required bool Supported

Whether this capability is supported by the model.

class BetaEffortCapability { High; Low; Max; /* 3 more */ }

Effort (reasoning_effort) capability details.

required BetaCapabilitySupport High

Whether the model supports high effort level.

required bool Supported

Whether this capability is supported by the model.

required BetaCapabilitySupport Low

Whether the model supports low effort level.

required bool Supported

Whether this capability is supported by the model.

required BetaCapabilitySupport Max

Whether the model supports max effort level.

required bool Supported

Whether this capability is supported by the model.

required BetaCapabilitySupport Medium

Whether the model supports medium effort level.

required bool Supported

Whether this capability is supported by the model.

required bool Supported

Whether this capability is supported by the model.

required BetaCapabilitySupport? Xhigh

Indicates whether a capability is supported.

required bool Supported

Whether this capability is supported by the model.

class BetaModelCapabilities { Batch; Citations; CodeExecution; /* 7 more */ }

Model capability information.

class BetaModelInfo { Type = "model"; ID; AllowedFallbackModels; /* 5 more */ }

JsonElement Type = "model"

Object type.

For Models, this is always "model".

required string ID

Unique model identifier.

required IReadOnlyList<string>? AllowedFallbackModels

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.

required BetaModelCapabilities? Capabilities

Model capability information.

required DateTimeOffset CreatedAt

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

required string DisplayName

A human-readable name for the model.

required long? MaxInputTokens

Maximum input context window size in tokens for this model.

required long? MaxTokens

Maximum value for the max_tokens parameter when using this model.

class BetaThinkingCapability { Supported; Types; }

Thinking capability details.

required bool Supported

Whether this capability is supported by the model.

required BetaThinkingTypes Types

Supported thinking type configurations.

required BetaCapabilitySupport Adaptive

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

required bool Supported

Whether this capability is supported by the model.

required BetaCapabilitySupport Enabled

Whether the model supports thinking with type 'enabled'.

required bool Supported

Whether this capability is supported by the model.

class BetaThinkingTypes { Adaptive; Enabled; }

Supported thinking type configurations.

required BetaCapabilitySupport Adaptive

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

required bool Supported

Whether this capability is supported by the model.

required BetaCapabilitySupport Enabled

Whether the model supports thinking with type 'enabled'.

required bool Supported

Whether this capability is supported by the model.