anthropic 0.4.1 → 1.1.0

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::Models::Beta::Messages::BatchCreateParams::Request>] Body param: List of requests for prompt completion. Each is an individual reques
+          #
+          # @param betas [Array<String, Symbol, Anthropic::Models::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::Models::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::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Models::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::Models::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::Models::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::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Models::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::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Models::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::Models::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::Models::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,227 @@
+# 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:, container: nil, mcp_servers: nil, metadata: nil, service_tier: 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::Models::Beta::BetaMessageParam>] Body param: Input messages.
+        #
+        # @param model [Symbol, String, Anthropic::Models::Model] Body param: The model that will complete your prompt.\n\nSee [models](https://do
+        #
+        # @param container [String, nil] Body param: Container identifier for reuse across requests.
+        #
+        # @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] Body param: MCP servers to be utilized in this request
+        #
+        # @param metadata [Anthropic::Models::Beta::BetaMetadata] Body param: An object describing metadata about the request.
+        #
+        # @param service_tier [Symbol, Anthropic::Models::Beta::MessageCreateParams::ServiceTier] Body param: Determines whether to use priority capacity (if available) or standa
+        #
+        # @param stop_sequences [Array<String>] Body param: Custom text sequences that will cause the model to stop generating.
+        #
+        # @param system_ [String, Array<Anthropic::Models::Beta::BetaTextBlockParam>] Body param: System prompt.
+        #
+        # @param temperature [Float] Body param: Amount of randomness injected into the response.
+        #
+        # @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled] Body param: Configuration for enabling Claude's extended thinking.
+        #
+        # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
+        #
+        # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaCodeExecutionTool20250522>] 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::Models::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::Models::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
+
+          if options.empty? && @client.timeout == Anthropic::Client::DEFAULT_TIMEOUT_IN_SECONDS
+            model = parsed[:model].to_sym
+            max_tokens = parsed[:max_tokens].to_i
+            timeout = @client.calculate_nonstreaming_timeout(
+              max_tokens,
+              Anthropic::Client::MODEL_NONSTREAMING_TOKENS[model]
+            )
+            options = {timeout: timeout}
+          else
+            options = {timeout: 600, **options}
+          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: 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:, container: nil, mcp_servers: nil, metadata: nil, service_tier: 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::Models::Beta::BetaMessageParam>] Body param: Input messages.
+        #
+        # @param model [Symbol, String, Anthropic::Models::Model] Body param: The model that will complete your prompt.\n\nSee [models](https://do
+        #
+        # @param container [String, nil] Body param: Container identifier for reuse across requests.
+        #
+        # @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] Body param: MCP servers to be utilized in this request
+        #
+        # @param metadata [Anthropic::Models::Beta::BetaMetadata] Body param: An object describing metadata about the request.
+        #
+        # @param service_tier [Symbol, Anthropic::Models::Beta::MessageCreateParams::ServiceTier] Body param: Determines whether to use priority capacity (if available) or standa
+        #
+        # @param stop_sequences [Array<String>] Body param: Custom text sequences that will cause the model to stop generating.
+        #
+        # @param system_ [String, Array<Anthropic::Models::Beta::BetaTextBlockParam>] Body param: System prompt.
+        #
+        # @param temperature [Float] Body param: Amount of randomness injected into the response.
+        #
+        # @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled] Body param: Configuration for enabling Claude's extended thinking.
+        #
+        # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
+        #
+        # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaCodeExecutionTool20250522>] 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::Models::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::Models::Beta::BetaRawMessageStartEvent, Anthropic::Models::Beta::BetaRawMessageDeltaEvent, Anthropic::Models::Beta::BetaRawMessageStopEvent, Anthropic::Models::Beta::BetaRawContentBlockStartEvent, Anthropic::Models::Beta::BetaRawContentBlockDeltaEvent, Anthropic::Models::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:, mcp_servers: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, betas: nil, request_options: {})
+        #
+        # @param messages [Array<Anthropic::Models::Beta::BetaMessageParam>] Body param: Input messages.
+        #
+        # @param model [Symbol, String, Anthropic::Models::Model] Body param: The model that will complete your prompt.\n\nSee [models](https://do
+        #
+        # @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] Body param: MCP servers to be utilized in this request
+        #
+        # @param system_ [String, Array<Anthropic::Models::Beta::BetaTextBlockParam>] Body param: System prompt.
+        #
+        # @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled] Body param: Configuration for enabling Claude's extended thinking.
+        #
+        # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
+        #
+        # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaCodeExecutionTool20250522>] Body param: Definitions of tools that the model may use.
+        #
+        # @param betas [Array<String, Symbol, Anthropic::Models::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::Models::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::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Anthropic::Models::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::Models::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::Models::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,26 @@
+# 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
+
+      # @return [Anthropic::Resources::Beta::Files]
+      attr_reader :files
+
+      # @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)
+        @files = Anthropic::Resources::Beta::Files.new(client: client)
+      end
+    end
+  end
+end