Models

List Models

models.list(**kwargs) -> Page<ModelInfo>

GET/v1/models

Get a Model

models.retrieve(model_id, **kwargs) -> ModelInfo

GET/v1/models/{model_id}

Models

class CapabilitySupport { supported }

Indicates whether a capability is supported.

supported: bool

Whether this capability is supported by the model.

class ContextManagementCapability { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }

Context management capability details.

clear_thinking_20251015: CapabilitySupport { supported }

Indicates whether a capability is supported.

supported: bool

Whether this capability is supported by the model.

clear_tool_uses_20250919: CapabilitySupport { supported }

Indicates whether a capability is supported.

supported: bool

Whether this capability is supported by the model.

compact_20260112: CapabilitySupport { supported }

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 EffortCapability { high, low, max, 3 more }

Effort (reasoning_effort) capability details.

class ModelCapabilities { batch, citations, code_execution, 6 more }

Model capability information.

class ModelInfo { id, capabilities, created_at, 4 more }

id: String

Unique model identifier.

capabilities: ModelCapabilities { batch, citations, code_execution, 6 more }

Model capability information.

created_at: Time

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

A human-readable name for the model.

max_input_tokens: Integer

Maximum input context window size in tokens for this model.

max_tokens: Integer

Maximum value for the max_tokens parameter when using this model.

type: :model

Object type.

For Models, this is always "model".

class ThinkingCapability { supported, types }

Thinking capability details.

supported: bool

Whether this capability is supported by the model.

types: ThinkingTypes { adaptive, enabled }

Supported thinking type configurations.

adaptive: CapabilitySupport { supported }

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

supported: bool

Whether this capability is supported by the model.

enabled: CapabilitySupport { supported }

Whether the model supports thinking with type 'enabled'.

supported: bool

Whether this capability is supported by the model.

class ThinkingTypes { adaptive, enabled }

Supported thinking type configurations.

adaptive: CapabilitySupport { supported }

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

supported: bool

Whether this capability is supported by the model.

enabled: CapabilitySupport { supported }

Whether the model supports thinking with type 'enabled'.

supported: bool

Whether this capability is supported by the model.