anthropic 0.4.1 → 1.0.0

data/lib/anthropic/request_options.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Anthropic
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  # or override those provided at the client level.
+  #
+  # When making a request, you can pass an actual {RequestOptions} instance, or
+  # simply pass a Hash with symbol keys matching the attributes on this class.
+  class RequestOptions < Anthropic::Internal::Type::BaseModel
+    # @api private
+    #
+    # @param opts [Anthropic::RequestOptions, Hash{Symbol=>Object}]
+    #
+    # @raise [ArgumentError]
+    def self.validate!(opts)
+      case opts
+      in Anthropic::RequestOptions | Hash
+        opts.to_h.each_key do |k|
+          unless fields.include?(k)
+            raise ArgumentError.new("Request `opts` keys must be one of #{fields.keys}, got #{k.inspect}")
+          end
+        end
+      else
+        raise ArgumentError.new("Request `opts` must be a Hash or RequestOptions, got #{opts.inspect}")
+      end
+    end
+
+    # @!attribute idempotency_key
+    #   Idempotency key to send with request and all associated retries. Will only be
+    #   sent for write requests.
+    #
+    #   @return [String, nil]
+    optional :idempotency_key, String
+
+    # @!attribute extra_query
+    #   Extra query params to send with the request. These are `.merge`’d into any
+    #   `query` given at the client level.
+    #
+    #   @return [Hash{String=>Array<String>, String, nil}, nil]
+    optional :extra_query, Anthropic::Internal::Type::HashOf[Anthropic::Internal::Type::ArrayOf[String]]
+
+    # @!attribute extra_headers
+    #   Extra headers to send with the request. These are `.merged`’d into any
+    #   `extra_headers` given at the client level.
+    #
+    #   @return [Hash{String=>String, nil}, nil]
+    optional :extra_headers, Anthropic::Internal::Type::HashOf[String, nil?: true]
+
+    # @!attribute extra_body
+    #   Extra data to send with the request. These are deep merged into any data
+    #   generated as part of the normal request.
+    #
+    #   @return [Object, nil]
+    optional :extra_body, Anthropic::Internal::Type::HashOf[Anthropic::Internal::Type::Unknown]
+
+    # @!attribute max_retries
+    #   Maximum number of retries to attempt after a failed initial request.
+    #
+    #   @return [Integer, nil]
+    optional :max_retries, Integer
+
+    # @!attribute timeout
+    #   Request timeout in seconds.
+    #
+    #   @return [Float, nil]
+    optional :timeout, Float
+
+    # @!method initialize(values = {})
+    #   Returns a new instance of RequestOptions.
+    #
+    #   @param values [Hash{Symbol=>Object}]
+
+    define_sorbet_constant!(:OrHash) do
+      T.type_alias { T.any(Anthropic::RequestOptions, Anthropic::Internal::AnyHash) }
+    end
+  end
+end

data/lib/anthropic/resources/beta/messages/batches.rb

@@ -0,0 +1,218 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Messages
+        class Batches
+          # Some parameter documentations has been truncated, see
+          # {Anthropic::Models::Beta::Messages::BatchCreateParams} for more details.
+          #
+          # Send a batch of Message creation requests.
+          #
+          # The Message Batches API can be used to process multiple Messages API requests at
+          # once. Once a Message Batch is created, it begins processing immediately. Batches
+          # can take up to 24 hours to complete.
+          #
+          # Learn more about the Message Batches API in our
+          # [user guide](/en/docs/build-with-claude/batch-processing)
+          #
+          # @overload create(requests:, betas: nil, request_options: {})
+          #
+          # @param requests [Array<Anthropic::Beta::Messages::BatchCreateParams::Request>] Body param: List of requests for prompt completion. Each is an individual reques
+          #
+          # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Beta::Messages::BetaMessageBatch]
+          #
+          # @see Anthropic::Models::Beta::Messages::BatchCreateParams
+          def create(params)
+            parsed, options = Anthropic::Beta::Messages::BatchCreateParams.dump_request(params)
+            header_params = {betas: "anthropic-beta"}
+            @client.request(
+              method: :post,
+              path: "v1/messages/batches?beta=true",
+              headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+              body: parsed.except(*header_params.keys),
+              model: Anthropic::Beta::Messages::BetaMessageBatch,
+              options: {extra_headers: {"anthropic-beta" => "message-batches-2024-09-24"}, **options}
+            )
+          end
+
+          # This endpoint is idempotent and can be used to poll for Message Batch
+          # completion. To access the results of a Message Batch, make a request to the
+          # `results_url` field in the response.
+          #
+          # Learn more about the Message Batches API in our
+          # [user guide](/en/docs/build-with-claude/batch-processing)
+          #
+          # @overload retrieve(message_batch_id, betas: nil, request_options: {})
+          #
+          # @param message_batch_id [String] ID of the Message Batch.
+          #
+          # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Beta::Messages::BetaMessageBatch]
+          #
+          # @see Anthropic::Models::Beta::Messages::BatchRetrieveParams
+          def retrieve(message_batch_id, params = {})
+            parsed, options = Anthropic::Beta::Messages::BatchRetrieveParams.dump_request(params)
+            @client.request(
+              method: :get,
+              path: ["v1/messages/batches/%1$s?beta=true", message_batch_id],
+              headers: parsed.transform_keys(betas: "anthropic-beta"),
+              model: Anthropic::Beta::Messages::BetaMessageBatch,
+              options: {extra_headers: {"anthropic-beta" => "message-batches-2024-09-24"}, **options}
+            )
+          end
+
+          # Some parameter documentations has been truncated, see
+          # {Anthropic::Models::Beta::Messages::BatchListParams} for more details.
+          #
+          # List all Message Batches within a Workspace. Most recently created batches are
+          # returned first.
+          #
+          # Learn more about the Message Batches API in our
+          # [user guide](/en/docs/build-with-claude/batch-processing)
+          #
+          # @overload list(after_id: nil, before_id: nil, limit: nil, betas: nil, request_options: {})
+          #
+          # @param after_id [String] Query param: ID of the object to use as a cursor for pagination. When provided,
+          #
+          # @param before_id [String] Query param: ID of the object to use as a cursor for pagination. When provided,
+          #
+          # @param limit [Integer] Query param: Number of items to return per page.
+          #
+          # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Internal::Page<Anthropic::Beta::Messages::BetaMessageBatch>]
+          #
+          # @see Anthropic::Models::Beta::Messages::BatchListParams
+          def list(params = {})
+            parsed, options = Anthropic::Beta::Messages::BatchListParams.dump_request(params)
+            query_params = [:after_id, :before_id, :limit]
+            @client.request(
+              method: :get,
+              path: "v1/messages/batches?beta=true",
+              query: parsed.slice(*query_params),
+              headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+              page: Anthropic::Internal::Page,
+              model: Anthropic::Beta::Messages::BetaMessageBatch,
+              options: {extra_headers: {"anthropic-beta" => "message-batches-2024-09-24"}, **options}
+            )
+          end
+
+          # Delete a Message Batch.
+          #
+          # Message Batches can only be deleted once they've finished processing. If you'd
+          # like to delete an in-progress batch, you must first cancel it.
+          #
+          # Learn more about the Message Batches API in our
+          # [user guide](/en/docs/build-with-claude/batch-processing)
+          #
+          # @overload delete(message_batch_id, betas: nil, request_options: {})
+          #
+          # @param message_batch_id [String] ID of the Message Batch.
+          #
+          # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Beta::Messages::BetaDeletedMessageBatch]
+          #
+          # @see Anthropic::Models::Beta::Messages::BatchDeleteParams
+          def delete(message_batch_id, params = {})
+            parsed, options = Anthropic::Beta::Messages::BatchDeleteParams.dump_request(params)
+            @client.request(
+              method: :delete,
+              path: ["v1/messages/batches/%1$s?beta=true", message_batch_id],
+              headers: parsed.transform_keys(betas: "anthropic-beta"),
+              model: Anthropic::Beta::Messages::BetaDeletedMessageBatch,
+              options: {extra_headers: {"anthropic-beta" => "message-batches-2024-09-24"}, **options}
+            )
+          end
+
+          # Batches may be canceled any time before processing ends. Once cancellation is
+          # initiated, the batch enters a `canceling` state, at which time the system may
+          # complete any in-progress, non-interruptible requests before finalizing
+          # cancellation.
+          #
+          # The number of canceled requests is specified in `request_counts`. To determine
+          # which requests were canceled, check the individual results within the batch.
+          # Note that cancellation may not result in any canceled requests if they were
+          # non-interruptible.
+          #
+          # Learn more about the Message Batches API in our
+          # [user guide](/en/docs/build-with-claude/batch-processing)
+          #
+          # @overload cancel(message_batch_id, betas: nil, request_options: {})
+          #
+          # @param message_batch_id [String] ID of the Message Batch.
+          #
+          # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Beta::Messages::BetaMessageBatch]
+          #
+          # @see Anthropic::Models::Beta::Messages::BatchCancelParams
+          def cancel(message_batch_id, params = {})
+            parsed, options = Anthropic::Beta::Messages::BatchCancelParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["v1/messages/batches/%1$s/cancel?beta=true", message_batch_id],
+              headers: parsed.transform_keys(betas: "anthropic-beta"),
+              model: Anthropic::Beta::Messages::BetaMessageBatch,
+              options: {extra_headers: {"anthropic-beta" => "message-batches-2024-09-24"}, **options}
+            )
+          end
+
+          # Streams the results of a Message Batch as a `.jsonl` file.
+          #
+          # Each line in the file is a JSON object containing the result of a single request
+          # in the Message Batch. Results are not guaranteed to be in the same order as
+          # requests. Use the `custom_id` field to match results to requests.
+          #
+          # Learn more about the Message Batches API in our
+          # [user guide](/en/docs/build-with-claude/batch-processing)
+          #
+          # @overload results_streaming(message_batch_id, betas: nil, request_options: {})
+          #
+          # @param message_batch_id [String] ID of the Message Batch.
+          #
+          # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Internal::JsonLStream<Anthropic::Beta::Messages::BetaMessageBatchIndividualResponse>]
+          #
+          # @see Anthropic::Models::Beta::Messages::BatchResultsParams
+          def results_streaming(message_batch_id, params = {})
+            parsed, options = Anthropic::Beta::Messages::BatchResultsParams.dump_request(params)
+            @client.request(
+              method: :get,
+              path: ["v1/messages/batches/%1$s/results?beta=true", message_batch_id],
+              headers: {"accept" => "application/x-jsonl", **parsed}.transform_keys(betas: "anthropic-beta"),
+              stream: Anthropic::Internal::JsonLStream,
+              model: Anthropic::Beta::Messages::BetaMessageBatchIndividualResponse,
+              options: {extra_headers: {"anthropic-beta" => "message-batches-2024-09-24"}, **options}
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Anthropic::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/resources/beta/messages.rb

@@ -0,0 +1,200 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Messages
+        # @return [Anthropic::Resources::Beta::Messages::Batches]
+        attr_reader :batches
+
+        # See {Anthropic::Resources::Beta::Messages#stream_raw} for streaming counterpart.
+        #
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::MessageCreateParams} for more details.
+        #
+        # Send a structured list of input messages with text and/or image content, and the
+        # model will generate the next message in the conversation.
+        #
+        # The Messages API can be used for either single queries or stateless multi-turn
+        # conversations.
+        #
+        # Learn more about the Messages API in our [user guide](/en/docs/initial-setup)
+        #
+        # @overload create(max_tokens:, messages:, model:, metadata: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, betas: nil, request_options: {})
+        #
+        # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
+        #
+        # @param messages [Array<Anthropic::Beta::BetaMessageParam>] Body param: Input messages.
+        #
+        # @param model [Symbol, String, Anthropic::Model] Body param: The model that will complete your prompt.\n\nSee [models](https://do
+        #
+        # @param metadata [Anthropic::Beta::BetaMetadata] Body param: An object describing metadata about the request.
+        #
+        # @param stop_sequences [Array<String>] Body param: Custom text sequences that will cause the model to stop generating.
+        #
+        # @param system_ [String, Array<Anthropic::Beta::BetaTextBlockParam>] Body param: System prompt.
+        #
+        # @param temperature [Float] Body param: Amount of randomness injected into the response.
+        #
+        # @param thinking [Anthropic::Beta::BetaThinkingConfigEnabled, Anthropic::Beta::BetaThinkingConfigDisabled] Body param: Configuration for enabling Claude's extended thinking.
+        #
+        # @param tool_choice [Anthropic::Beta::BetaToolChoiceAuto, Anthropic::Beta::BetaToolChoiceAny, Anthropic::Beta::BetaToolChoiceTool, Anthropic::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
+        #
+        # @param tools [Array<Anthropic::Beta::BetaTool, Anthropic::Beta::BetaToolComputerUse20241022, Anthropic::Beta::BetaToolBash20241022, Anthropic::Beta::BetaToolTextEditor20241022, Anthropic::Beta::BetaToolComputerUse20250124, Anthropic::Beta::BetaToolBash20250124, Anthropic::Beta::BetaToolTextEditor20250124, Anthropic::Beta::BetaWebSearchTool20250305>] Body param: Definitions of tools that the model may use.
+        #
+        # @param top_k [Integer] Body param: Only sample from the top K options for each subsequent token.
+        #
+        # @param top_p [Float] Body param: Use nucleus sampling.
+        #
+        # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Anthropic::Beta::BetaMessage]
+        #
+        # @see Anthropic::Models::Beta::MessageCreateParams
+        def create(params)
+          parsed, options = Anthropic::Beta::MessageCreateParams.dump_request(params)
+          if parsed[:stream]
+            message = "Please use `#stream_raw` for the streaming use case."
+            raise ArgumentError.new(message)
+          end
+          header_params = {betas: "anthropic-beta"}
+          @client.request(
+            method: :post,
+            path: "v1/messages?beta=true",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Anthropic::Beta::BetaMessage,
+            options: {timeout: 600, **options}
+          )
+        end
+
+        def stream
+          raise NotImplementedError.new("higher level helpers are coming soon!")
+        end
+
+        # See {Anthropic::Resources::Beta::Messages#create} for non-streaming counterpart.
+        #
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::MessageCreateParams} for more details.
+        #
+        # Send a structured list of input messages with text and/or image content, and the
+        # model will generate the next message in the conversation.
+        #
+        # The Messages API can be used for either single queries or stateless multi-turn
+        # conversations.
+        #
+        # Learn more about the Messages API in our [user guide](/en/docs/initial-setup)
+        #
+        # @overload stream_raw(max_tokens:, messages:, model:, metadata: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, betas: nil, request_options: {})
+        #
+        # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
+        #
+        # @param messages [Array<Anthropic::Beta::BetaMessageParam>] Body param: Input messages.
+        #
+        # @param model [Symbol, String, Anthropic::Model] Body param: The model that will complete your prompt.\n\nSee [models](https://do
+        #
+        # @param metadata [Anthropic::Beta::BetaMetadata] Body param: An object describing metadata about the request.
+        #
+        # @param stop_sequences [Array<String>] Body param: Custom text sequences that will cause the model to stop generating.
+        #
+        # @param system_ [String, Array<Anthropic::Beta::BetaTextBlockParam>] Body param: System prompt.
+        #
+        # @param temperature [Float] Body param: Amount of randomness injected into the response.
+        #
+        # @param thinking [Anthropic::Beta::BetaThinkingConfigEnabled, Anthropic::Beta::BetaThinkingConfigDisabled] Body param: Configuration for enabling Claude's extended thinking.
+        #
+        # @param tool_choice [Anthropic::Beta::BetaToolChoiceAuto, Anthropic::Beta::BetaToolChoiceAny, Anthropic::Beta::BetaToolChoiceTool, Anthropic::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
+        #
+        # @param tools [Array<Anthropic::Beta::BetaTool, Anthropic::Beta::BetaToolComputerUse20241022, Anthropic::Beta::BetaToolBash20241022, Anthropic::Beta::BetaToolTextEditor20241022, Anthropic::Beta::BetaToolComputerUse20250124, Anthropic::Beta::BetaToolBash20250124, Anthropic::Beta::BetaToolTextEditor20250124, Anthropic::Beta::BetaWebSearchTool20250305>] Body param: Definitions of tools that the model may use.
+        #
+        # @param top_k [Integer] Body param: Only sample from the top K options for each subsequent token.
+        #
+        # @param top_p [Float] Body param: Use nucleus sampling.
+        #
+        # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Anthropic::Internal::Stream<Anthropic::Beta::BetaRawMessageStartEvent, Anthropic::Beta::BetaRawMessageDeltaEvent, Anthropic::Beta::BetaRawMessageStopEvent, Anthropic::Beta::BetaRawContentBlockStartEvent, Anthropic::Beta::BetaRawContentBlockDeltaEvent, Anthropic::Beta::BetaRawContentBlockStopEvent>]
+        #
+        # @see Anthropic::Models::Beta::MessageCreateParams
+        def stream_raw(params)
+          parsed, options = Anthropic::Beta::MessageCreateParams.dump_request(params)
+          unless parsed.fetch(:stream, true)
+            message = "Please use `#create` for the non-streaming use case."
+            raise ArgumentError.new(message)
+          end
+          parsed.store(:stream, true)
+          header_params = {betas: "anthropic-beta"}
+          @client.request(
+            method: :post,
+            path: "v1/messages?beta=true",
+            headers: {
+              "accept" => "text/event-stream",
+              **parsed.slice(*header_params.keys)
+            }.transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            stream: Anthropic::Internal::Stream,
+            model: Anthropic::Beta::BetaRawMessageStreamEvent,
+            options: {timeout: 600, **options}
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::MessageCountTokensParams} for more details.
+        #
+        # Count the number of tokens in a Message.
+        #
+        # The Token Count API can be used to count the number of tokens in a Message,
+        # including tools, images, and documents, without creating it.
+        #
+        # Learn more about token counting in our
+        # [user guide](/en/docs/build-with-claude/token-counting)
+        #
+        # @overload count_tokens(messages:, model:, system_: nil, thinking: nil, tool_choice: nil, tools: nil, betas: nil, request_options: {})
+        #
+        # @param messages [Array<Anthropic::Beta::BetaMessageParam>] Body param: Input messages.
+        #
+        # @param model [Symbol, String, Anthropic::Model] Body param: The model that will complete your prompt.\n\nSee [models](https://do
+        #
+        # @param system_ [String, Array<Anthropic::Beta::BetaTextBlockParam>] Body param: System prompt.
+        #
+        # @param thinking [Anthropic::Beta::BetaThinkingConfigEnabled, Anthropic::Beta::BetaThinkingConfigDisabled] Body param: Configuration for enabling Claude's extended thinking.
+        #
+        # @param tool_choice [Anthropic::Beta::BetaToolChoiceAuto, Anthropic::Beta::BetaToolChoiceAny, Anthropic::Beta::BetaToolChoiceTool, Anthropic::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
+        #
+        # @param tools [Array<Anthropic::Beta::BetaTool, Anthropic::Beta::BetaToolComputerUse20241022, Anthropic::Beta::BetaToolBash20241022, Anthropic::Beta::BetaToolTextEditor20241022, Anthropic::Beta::BetaToolComputerUse20250124, Anthropic::Beta::BetaToolBash20250124, Anthropic::Beta::BetaToolTextEditor20250124, Anthropic::Beta::BetaWebSearchTool20250305>] Body param: Definitions of tools that the model may use.
+        #
+        # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Anthropic::Beta::BetaMessageTokensCount]
+        #
+        # @see Anthropic::Models::Beta::MessageCountTokensParams
+        def count_tokens(params)
+          parsed, options = Anthropic::Beta::MessageCountTokensParams.dump_request(params)
+          header_params = {betas: "anthropic-beta"}
+          @client.request(
+            method: :post,
+            path: "v1/messages/count_tokens?beta=true",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Anthropic::Beta::BetaMessageTokensCount,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Anthropic::Client]
+        def initialize(client:)
+          @client = client
+          @batches = Anthropic::Resources::Beta::Messages::Batches.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/resources/beta/models.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Models
+        # 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.
+        #
+        # @overload retrieve(model_id, betas: nil, request_options: {})
+        #
+        # @param model_id [String] Model identifier or alias.
+        #
+        # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Anthropic::Beta::BetaModelInfo]
+        #
+        # @see Anthropic::Models::Beta::ModelRetrieveParams
+        def retrieve(model_id, params = {})
+          parsed, options = Anthropic::Beta::ModelRetrieveParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["v1/models/%1$s?beta=true", model_id],
+            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            model: Anthropic::Beta::BetaModelInfo,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::ModelListParams} for more details.
+        #
+        # List available models.
+        #
+        # The Models API response can be used to determine which models are available for
+        # use in the API. More recently released models are listed first.
+        #
+        # @overload list(after_id: nil, before_id: nil, limit: nil, betas: nil, request_options: {})
+        #
+        # @param after_id [String] Query param: ID of the object to use as a cursor for pagination. When provided,
+        #
+        # @param before_id [String] Query param: ID of the object to use as a cursor for pagination. When provided,
+        #
+        # @param limit [Integer] Query param: Number of items to return per page.
+        #
+        # @param betas [Array<String, Symbol, Anthropic::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Anthropic::Internal::Page<Anthropic::Beta::BetaModelInfo>]
+        #
+        # @see Anthropic::Models::Beta::ModelListParams
+        def list(params = {})
+          parsed, options = Anthropic::Beta::ModelListParams.dump_request(params)
+          query_params = [:after_id, :before_id, :limit]
+          @client.request(
+            method: :get,
+            path: "v1/models?beta=true",
+            query: parsed.slice(*query_params),
+            headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+            page: Anthropic::Internal::Page,
+            model: Anthropic::Beta::BetaModelInfo,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Anthropic::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/resources/beta.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      # @return [Anthropic::Resources::Beta::Models]
+      attr_reader :models
+
+      # @return [Anthropic::Resources::Beta::Messages]
+      attr_reader :messages
+
+      # @api private
+      #
+      # @param client [Anthropic::Client]
+      def initialize(client:)
+        @client = client
+        @models = Anthropic::Resources::Beta::Models.new(client: client)
+        @messages = Anthropic::Resources::Beta::Messages.new(client: client)
+      end
+    end
+  end
+end