Get a Model

beta.models.retrieve(model_id, **kwargs) -> BetaModelInfo { id, created_at, display_name, type }

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.

ParametersExpand Collapse

model_id: String

Model identifier or alias.

anthropic_beta: Array[AnthropicBeta]

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

Accepts one of the following:

String

:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 16 more

Accepts one of the following:

:"message-batches-2024-09-24"

:"prompt-caching-2024-07-31"

:"computer-use-2024-10-22"

:"computer-use-2025-01-24"

:"pdfs-2024-09-25"

:"token-counting-2024-11-01"

:"token-efficient-tools-2025-02-19"

:"output-128k-2025-02-19"

:"files-api-2025-04-14"

:"mcp-client-2025-04-04"

:"mcp-client-2025-11-20"

:"dev-full-thinking-2025-05-14"

:"interleaved-thinking-2025-05-14"

:"code-execution-2025-05-22"

:"extended-cache-ttl-2025-04-11"

:"context-1m-2025-08-07"

:"context-management-2025-06-27"

:"model-context-window-exceeded-2025-08-26"

:"skills-2025-10-02"

ReturnsExpand Collapse

class BetaModelInfo { id, created_at, display_name, type }

id: String

Unique model identifier.

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.

type: :model

Object type.

For Models, this is always "model".

Accepts one of the following:

:model

Get a Model

require "anthropic"

anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key")

beta_model_info = anthropic.beta.models.retrieve("model_id")

puts(beta_model_info)

Response 200

{
  "id": "claude-sonnet-4-20250514",
  "created_at": "2025-02-19T00:00:00Z",
  "display_name": "Claude Sonnet 4",
  "type": "model"
}

Returns Examples

Response 200

{
  "id": "claude-sonnet-4-20250514",
  "created_at": "2025-02-19T00:00:00Z",
  "display_name": "Claude Sonnet 4",
  "type": "model"
}

Get a Model

beta.models.retrieve(model_id, **kwargs) -> BetaModelInfo { id, created_at, display_name, type }

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.

ParametersExpand Collapse

model_id: String

Model identifier or alias.

anthropic_beta: Array[AnthropicBeta]

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

Accepts one of the following:

String

:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 16 more

Accepts one of the following:

:"message-batches-2024-09-24"

:"prompt-caching-2024-07-31"

:"computer-use-2024-10-22"

:"computer-use-2025-01-24"

:"pdfs-2024-09-25"

:"token-counting-2024-11-01"

:"token-efficient-tools-2025-02-19"

:"output-128k-2025-02-19"

:"files-api-2025-04-14"

:"mcp-client-2025-04-04"

:"mcp-client-2025-11-20"

:"dev-full-thinking-2025-05-14"

:"interleaved-thinking-2025-05-14"

:"code-execution-2025-05-22"

:"extended-cache-ttl-2025-04-11"

:"context-1m-2025-08-07"

:"context-management-2025-06-27"

:"model-context-window-exceeded-2025-08-26"

:"skills-2025-10-02"

ReturnsExpand Collapse

class BetaModelInfo { id, created_at, display_name, type }

id: String

Unique model identifier.

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.

type: :model

Object type.

For Models, this is always "model".

Accepts one of the following:

:model

Get a Model

require "anthropic"

anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key")

beta_model_info = anthropic.beta.models.retrieve("model_id")

puts(beta_model_info)

Response 200

{
  "id": "claude-sonnet-4-20250514",
  "created_at": "2025-02-19T00:00:00Z",
  "display_name": "Claude Sonnet 4",
  "type": "model"
}

Returns Examples

Response 200

{
  "id": "claude-sonnet-4-20250514",
  "created_at": "2025-02-19T00:00:00Z",
  "display_name": "Claude Sonnet 4",
  "type": "model"
}