openai 0.70.0 → 0.71.0

data/lib/openai/models/admin/organization/usage_moderations_response.rb

@@ -113,8 +113,9 @@ module OpenAI
 
               class OrganizationUsageCompletionsResult < OpenAI::Internal::Type::BaseModel
                 # @!attribute input_tokens
-                #   The aggregated number of text input tokens used, including cached tokens. For
-                #   customers subscribe to scale tier, this includes scale tier tokens.
+                #   The aggregated number of input tokens used, including cached and cache-write
+                #   tokens. This includes text, audio, and image tokens. For customers subscribed to
+                #   Scale Tier, this includes Scale Tier tokens.
                 #
                 #   @return [Integer]
                 required :input_tokens, Integer
@@ -131,8 +132,9 @@ module OpenAI
                 required :object, const: :"organization.usage.completions.result"
 
                 # @!attribute output_tokens
-                #   The aggregated number of text output tokens used. For customers subscribe to
-                #   scale tier, this includes scale tier tokens.
+                #   The aggregated number of output tokens used across text, audio, and image
+                #   outputs. For customers subscribed to Scale Tier, this includes Scale Tier
+                #   tokens.
                 #
                 #   @return [Integer]
                 required :output_tokens, Integer
@@ -152,19 +154,62 @@ module OpenAI
                 optional :batch, OpenAI::Internal::Type::Boolean, nil?: true
 
                 # @!attribute input_audio_tokens
-                #   The aggregated number of audio input tokens used, including cached tokens.
+                #   The aggregated number of uncached audio input tokens used.
                 #
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_tokens
+                #   The aggregated number of input tokens written to the cache.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_tokens, Integer
+
+                # @!attribute input_cached_audio_tokens
+                #   The aggregated number of cached audio input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_cached_audio_tokens, Integer
+
+                # @!attribute input_cached_image_tokens
+                #   The aggregated number of cached image input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_cached_image_tokens, Integer
+
+                # @!attribute input_cached_text_tokens
+                #   The aggregated number of cached text input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_cached_text_tokens, Integer
+
                 # @!attribute input_cached_tokens
-                #   The aggregated number of text input tokens that has been cached from previous
-                #   requests. For customers subscribe to scale tier, this includes scale tier
-                #   tokens.
+                #   The aggregated number of cached input tokens used across text, audio, and image
+                #   inputs. For customers subscribed to Scale Tier, this includes Scale Tier tokens.
                 #
                 #   @return [Integer, nil]
                 optional :input_cached_tokens, Integer
 
+                # @!attribute input_image_tokens
+                #   The aggregated number of uncached image input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_image_tokens, Integer
+
+                # @!attribute input_text_tokens
+                #   The aggregated number of uncached text input tokens used, excluding cache-write
+                #   tokens.
+                #
+                #   @return [Integer, nil]
+                optional :input_text_tokens, Integer
+
+                # @!attribute input_uncached_tokens
+                #   The aggregated number of uncached input tokens used across text, audio, and
+                #   image inputs, excluding cache-write tokens.
+                #
+                #   @return [Integer, nil]
+                optional :input_uncached_tokens, Integer
+
                 # @!attribute model
                 #   When `group_by=model`, this field provides the model name of the grouped usage
                 #   result.
@@ -178,6 +223,18 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :output_audio_tokens, Integer
 
+                # @!attribute output_image_tokens
+                #   The aggregated number of image output tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :output_image_tokens, Integer
+
+                # @!attribute output_text_tokens
+                #   The aggregated number of text output tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :output_text_tokens, Integer
+
                 # @!attribute project_id
                 #   When `group_by=project_id`, this field provides the project ID of the grouped
                 #   usage result.
@@ -199,31 +256,49 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cached_tokens: nil, model: nil, output_audio_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageModerationsResponse::Data::Result::OrganizationUsageCompletionsResult}
                 #   for more details.
                 #
                 #   The aggregated completions usage details of the specific time bucket.
                 #
-                #   @param input_tokens [Integer] The aggregated number of text input tokens used, including cached tokens. For cu
+                #   @param input_tokens [Integer] The aggregated number of input tokens used, including cached and cache-write tok
                 #
                 #   @param num_model_requests [Integer] The count of requests made to the model.
                 #
-                #   @param output_tokens [Integer] The aggregated number of text output tokens used. For customers subscribe to sca
+                #   @param output_tokens [Integer] The aggregated number of output tokens used across text, audio, and image output
                 #
                 #   @param api_key_id [String, nil] When `group_by=api_key_id`, this field provides the API key ID of the grouped us
                 #
                 #   @param batch [Boolean, nil] When `group_by=batch`, this field tells whether the grouped usage result is batc
                 #
-                #   @param input_audio_tokens [Integer] The aggregated number of audio input tokens used, including cached tokens.
+                #   @param input_audio_tokens [Integer] The aggregated number of uncached audio input tokens used.
                 #
-                #   @param input_cached_tokens [Integer] The aggregated number of text input tokens that has been cached from previous re
+                #   @param input_cache_write_tokens [Integer] The aggregated number of input tokens written to the cache.
+                #
+                #   @param input_cached_audio_tokens [Integer] The aggregated number of cached audio input tokens used.
+                #
+                #   @param input_cached_image_tokens [Integer] The aggregated number of cached image input tokens used.
+                #
+                #   @param input_cached_text_tokens [Integer] The aggregated number of cached text input tokens used.
+                #
+                #   @param input_cached_tokens [Integer] The aggregated number of cached input tokens used across text, audio, and image
+                #
+                #   @param input_image_tokens [Integer] The aggregated number of uncached image input tokens used.
+                #
+                #   @param input_text_tokens [Integer] The aggregated number of uncached text input tokens used, excluding cache-write
+                #
+                #   @param input_uncached_tokens [Integer] The aggregated number of uncached input tokens used across text, audio, and imag
                 #
                 #   @param model [String, nil] When `group_by=model`, this field provides the model name of the grouped usage r
                 #
                 #   @param output_audio_tokens [Integer] The aggregated number of audio output tokens used.
                 #
+                #   @param output_image_tokens [Integer] The aggregated number of image output tokens used.
+                #
+                #   @param output_text_tokens [Integer] The aggregated number of text output tokens used.
+                #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped us
                 #
                 #   @param service_tier [String, nil] When `group_by=service_tier`, this field provides the service tier of the groupe

data/lib/openai/models/admin/organization/usage_vector_stores_response.rb

@@ -113,8 +113,9 @@ module OpenAI
 
               class OrganizationUsageCompletionsResult < OpenAI::Internal::Type::BaseModel
                 # @!attribute input_tokens
-                #   The aggregated number of text input tokens used, including cached tokens. For
-                #   customers subscribe to scale tier, this includes scale tier tokens.
+                #   The aggregated number of input tokens used, including cached and cache-write
+                #   tokens. This includes text, audio, and image tokens. For customers subscribed to
+                #   Scale Tier, this includes Scale Tier tokens.
                 #
                 #   @return [Integer]
                 required :input_tokens, Integer
@@ -131,8 +132,9 @@ module OpenAI
                 required :object, const: :"organization.usage.completions.result"
 
                 # @!attribute output_tokens
-                #   The aggregated number of text output tokens used. For customers subscribe to
-                #   scale tier, this includes scale tier tokens.
+                #   The aggregated number of output tokens used across text, audio, and image
+                #   outputs. For customers subscribed to Scale Tier, this includes Scale Tier
+                #   tokens.
                 #
                 #   @return [Integer]
                 required :output_tokens, Integer
@@ -152,19 +154,62 @@ module OpenAI
                 optional :batch, OpenAI::Internal::Type::Boolean, nil?: true
 
                 # @!attribute input_audio_tokens
-                #   The aggregated number of audio input tokens used, including cached tokens.
+                #   The aggregated number of uncached audio input tokens used.
                 #
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_tokens
+                #   The aggregated number of input tokens written to the cache.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_tokens, Integer
+
+                # @!attribute input_cached_audio_tokens
+                #   The aggregated number of cached audio input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_cached_audio_tokens, Integer
+
+                # @!attribute input_cached_image_tokens
+                #   The aggregated number of cached image input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_cached_image_tokens, Integer
+
+                # @!attribute input_cached_text_tokens
+                #   The aggregated number of cached text input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_cached_text_tokens, Integer
+
                 # @!attribute input_cached_tokens
-                #   The aggregated number of text input tokens that has been cached from previous
-                #   requests. For customers subscribe to scale tier, this includes scale tier
-                #   tokens.
+                #   The aggregated number of cached input tokens used across text, audio, and image
+                #   inputs. For customers subscribed to Scale Tier, this includes Scale Tier tokens.
                 #
                 #   @return [Integer, nil]
                 optional :input_cached_tokens, Integer
 
+                # @!attribute input_image_tokens
+                #   The aggregated number of uncached image input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_image_tokens, Integer
+
+                # @!attribute input_text_tokens
+                #   The aggregated number of uncached text input tokens used, excluding cache-write
+                #   tokens.
+                #
+                #   @return [Integer, nil]
+                optional :input_text_tokens, Integer
+
+                # @!attribute input_uncached_tokens
+                #   The aggregated number of uncached input tokens used across text, audio, and
+                #   image inputs, excluding cache-write tokens.
+                #
+                #   @return [Integer, nil]
+                optional :input_uncached_tokens, Integer
+
                 # @!attribute model
                 #   When `group_by=model`, this field provides the model name of the grouped usage
                 #   result.
@@ -178,6 +223,18 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :output_audio_tokens, Integer
 
+                # @!attribute output_image_tokens
+                #   The aggregated number of image output tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :output_image_tokens, Integer
+
+                # @!attribute output_text_tokens
+                #   The aggregated number of text output tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :output_text_tokens, Integer
+
                 # @!attribute project_id
                 #   When `group_by=project_id`, this field provides the project ID of the grouped
                 #   usage result.
@@ -199,31 +256,49 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cached_tokens: nil, model: nil, output_audio_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageVectorStoresResponse::Data::Result::OrganizationUsageCompletionsResult}
                 #   for more details.
                 #
                 #   The aggregated completions usage details of the specific time bucket.
                 #
-                #   @param input_tokens [Integer] The aggregated number of text input tokens used, including cached tokens. For cu
+                #   @param input_tokens [Integer] The aggregated number of input tokens used, including cached and cache-write tok
                 #
                 #   @param num_model_requests [Integer] The count of requests made to the model.
                 #
-                #   @param output_tokens [Integer] The aggregated number of text output tokens used. For customers subscribe to sca
+                #   @param output_tokens [Integer] The aggregated number of output tokens used across text, audio, and image output
                 #
                 #   @param api_key_id [String, nil] When `group_by=api_key_id`, this field provides the API key ID of the grouped us
                 #
                 #   @param batch [Boolean, nil] When `group_by=batch`, this field tells whether the grouped usage result is batc
                 #
-                #   @param input_audio_tokens [Integer] The aggregated number of audio input tokens used, including cached tokens.
+                #   @param input_audio_tokens [Integer] The aggregated number of uncached audio input tokens used.
                 #
-                #   @param input_cached_tokens [Integer] The aggregated number of text input tokens that has been cached from previous re
+                #   @param input_cache_write_tokens [Integer] The aggregated number of input tokens written to the cache.
+                #
+                #   @param input_cached_audio_tokens [Integer] The aggregated number of cached audio input tokens used.
+                #
+                #   @param input_cached_image_tokens [Integer] The aggregated number of cached image input tokens used.
+                #
+                #   @param input_cached_text_tokens [Integer] The aggregated number of cached text input tokens used.
+                #
+                #   @param input_cached_tokens [Integer] The aggregated number of cached input tokens used across text, audio, and image
+                #
+                #   @param input_image_tokens [Integer] The aggregated number of uncached image input tokens used.
+                #
+                #   @param input_text_tokens [Integer] The aggregated number of uncached text input tokens used, excluding cache-write
+                #
+                #   @param input_uncached_tokens [Integer] The aggregated number of uncached input tokens used across text, audio, and imag
                 #
                 #   @param model [String, nil] When `group_by=model`, this field provides the model name of the grouped usage r
                 #
                 #   @param output_audio_tokens [Integer] The aggregated number of audio output tokens used.
                 #
+                #   @param output_image_tokens [Integer] The aggregated number of image output tokens used.
+                #
+                #   @param output_text_tokens [Integer] The aggregated number of text output tokens used.
+                #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped us
                 #
                 #   @param service_tier [String, nil] When `group_by=service_tier`, this field provides the service tier of the groupe

data/lib/openai/models/admin/organization/usage_web_search_calls_response.rb

@@ -113,8 +113,9 @@ module OpenAI
 
               class OrganizationUsageCompletionsResult < OpenAI::Internal::Type::BaseModel
                 # @!attribute input_tokens
-                #   The aggregated number of text input tokens used, including cached tokens. For
-                #   customers subscribe to scale tier, this includes scale tier tokens.
+                #   The aggregated number of input tokens used, including cached and cache-write
+                #   tokens. This includes text, audio, and image tokens. For customers subscribed to
+                #   Scale Tier, this includes Scale Tier tokens.
                 #
                 #   @return [Integer]
                 required :input_tokens, Integer
@@ -131,8 +132,9 @@ module OpenAI
                 required :object, const: :"organization.usage.completions.result"
 
                 # @!attribute output_tokens
-                #   The aggregated number of text output tokens used. For customers subscribe to
-                #   scale tier, this includes scale tier tokens.
+                #   The aggregated number of output tokens used across text, audio, and image
+                #   outputs. For customers subscribed to Scale Tier, this includes Scale Tier
+                #   tokens.
                 #
                 #   @return [Integer]
                 required :output_tokens, Integer
@@ -152,19 +154,62 @@ module OpenAI
                 optional :batch, OpenAI::Internal::Type::Boolean, nil?: true
 
                 # @!attribute input_audio_tokens
-                #   The aggregated number of audio input tokens used, including cached tokens.
+                #   The aggregated number of uncached audio input tokens used.
                 #
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_tokens
+                #   The aggregated number of input tokens written to the cache.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_tokens, Integer
+
+                # @!attribute input_cached_audio_tokens
+                #   The aggregated number of cached audio input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_cached_audio_tokens, Integer
+
+                # @!attribute input_cached_image_tokens
+                #   The aggregated number of cached image input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_cached_image_tokens, Integer
+
+                # @!attribute input_cached_text_tokens
+                #   The aggregated number of cached text input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_cached_text_tokens, Integer
+
                 # @!attribute input_cached_tokens
-                #   The aggregated number of text input tokens that has been cached from previous
-                #   requests. For customers subscribe to scale tier, this includes scale tier
-                #   tokens.
+                #   The aggregated number of cached input tokens used across text, audio, and image
+                #   inputs. For customers subscribed to Scale Tier, this includes Scale Tier tokens.
                 #
                 #   @return [Integer, nil]
                 optional :input_cached_tokens, Integer
 
+                # @!attribute input_image_tokens
+                #   The aggregated number of uncached image input tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :input_image_tokens, Integer
+
+                # @!attribute input_text_tokens
+                #   The aggregated number of uncached text input tokens used, excluding cache-write
+                #   tokens.
+                #
+                #   @return [Integer, nil]
+                optional :input_text_tokens, Integer
+
+                # @!attribute input_uncached_tokens
+                #   The aggregated number of uncached input tokens used across text, audio, and
+                #   image inputs, excluding cache-write tokens.
+                #
+                #   @return [Integer, nil]
+                optional :input_uncached_tokens, Integer
+
                 # @!attribute model
                 #   When `group_by=model`, this field provides the model name of the grouped usage
                 #   result.
@@ -178,6 +223,18 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :output_audio_tokens, Integer
 
+                # @!attribute output_image_tokens
+                #   The aggregated number of image output tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :output_image_tokens, Integer
+
+                # @!attribute output_text_tokens
+                #   The aggregated number of text output tokens used.
+                #
+                #   @return [Integer, nil]
+                optional :output_text_tokens, Integer
+
                 # @!attribute project_id
                 #   When `group_by=project_id`, this field provides the project ID of the grouped
                 #   usage result.
@@ -199,31 +256,49 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cached_tokens: nil, model: nil, output_audio_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageWebSearchCallsResponse::Data::Result::OrganizationUsageCompletionsResult}
                 #   for more details.
                 #
                 #   The aggregated completions usage details of the specific time bucket.
                 #
-                #   @param input_tokens [Integer] The aggregated number of text input tokens used, including cached tokens. For cu
+                #   @param input_tokens [Integer] The aggregated number of input tokens used, including cached and cache-write tok
                 #
                 #   @param num_model_requests [Integer] The count of requests made to the model.
                 #
-                #   @param output_tokens [Integer] The aggregated number of text output tokens used. For customers subscribe to sca
+                #   @param output_tokens [Integer] The aggregated number of output tokens used across text, audio, and image output
                 #
                 #   @param api_key_id [String, nil] When `group_by=api_key_id`, this field provides the API key ID of the grouped us
                 #
                 #   @param batch [Boolean, nil] When `group_by=batch`, this field tells whether the grouped usage result is batc
                 #
-                #   @param input_audio_tokens [Integer] The aggregated number of audio input tokens used, including cached tokens.
+                #   @param input_audio_tokens [Integer] The aggregated number of uncached audio input tokens used.
                 #
-                #   @param input_cached_tokens [Integer] The aggregated number of text input tokens that has been cached from previous re
+                #   @param input_cache_write_tokens [Integer] The aggregated number of input tokens written to the cache.
+                #
+                #   @param input_cached_audio_tokens [Integer] The aggregated number of cached audio input tokens used.
+                #
+                #   @param input_cached_image_tokens [Integer] The aggregated number of cached image input tokens used.
+                #
+                #   @param input_cached_text_tokens [Integer] The aggregated number of cached text input tokens used.
+                #
+                #   @param input_cached_tokens [Integer] The aggregated number of cached input tokens used across text, audio, and image
+                #
+                #   @param input_image_tokens [Integer] The aggregated number of uncached image input tokens used.
+                #
+                #   @param input_text_tokens [Integer] The aggregated number of uncached text input tokens used, excluding cache-write
+                #
+                #   @param input_uncached_tokens [Integer] The aggregated number of uncached input tokens used across text, audio, and imag
                 #
                 #   @param model [String, nil] When `group_by=model`, this field provides the model name of the grouped usage r
                 #
                 #   @param output_audio_tokens [Integer] The aggregated number of audio output tokens used.
                 #
+                #   @param output_image_tokens [Integer] The aggregated number of image output tokens used.
+                #
+                #   @param output_text_tokens [Integer] The aggregated number of text output tokens used.
+                #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped us
                 #
                 #   @param service_tier [String, nil] When `group_by=service_tier`, this field provides the service tier of the groupe

data/lib/openai/models/beta/beta_response_input_item.rb

@@ -805,30 +805,32 @@ module OpenAI
             # @!attribute annotations
             #   Citations associated with the text content.
             #
-            #   @return [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2>, nil]
+            #   @return [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation>, nil]
             optional :annotations,
-                     union: -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations }
+                     -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation] }
 
             # @!method initialize(text:, annotations: nil, type: :output_text)
             #   @param text [String] The text content.
             #
-            #   @param annotations [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2>] Citations associated with the text content.
+            #   @param annotations [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation>] Citations associated with the text content.
             #
             #   @param type [Symbol, :output_text] The content type. Always `output_text`.
 
-            # Citations associated with the text content.
-            #
-            # @see OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output#annotations
-            module Annotations
+            module Annotation
               extend OpenAI::Internal::Type::Union
 
-              variant -> { OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0Array }
+              discriminator :type
+
+              variant :file_citation,
+                      -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation }
 
-              variant -> { OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1Array }
+              variant :url_citation,
+                      -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation }
 
-              variant -> { OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2Array }
+              variant :container_file_citation,
+                      -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation }
 
-              class UnionMember0 < OpenAI::Internal::Type::BaseModel
+              class FileCitation < OpenAI::Internal::Type::BaseModel
                 # @!attribute file_id
                 #   The ID of the file.
                 #
@@ -863,7 +865,7 @@ module OpenAI
                 #   @param type [Symbol, :file_citation] The citation type. Always `file_citation`.
               end
 
-              class UnionMember1 < OpenAI::Internal::Type::BaseModel
+              class URLCitation < OpenAI::Internal::Type::BaseModel
                 # @!attribute end_index
                 #   The index of the last character of the citation in the message.
                 #
@@ -906,7 +908,7 @@ module OpenAI
                 #   @param type [Symbol, :url_citation] The citation type. Always `url_citation`.
               end
 
-              class UnionMember2 < OpenAI::Internal::Type::BaseModel
+              class ContainerFileCitation < OpenAI::Internal::Type::BaseModel
                 # @!attribute container_id
                 #   The ID of the container.
                 #
@@ -958,25 +960,7 @@ module OpenAI
               end
 
               # @!method self.variants
-              #   @return [Array(Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2>)]
-
-              # @type [OpenAI::Internal::Type::Converter]
-              UnionMember0Array =
-                OpenAI::Internal::Type::ArrayOf[-> {
-                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0
-                }]
-
-              # @type [OpenAI::Internal::Type::Converter]
-              UnionMember1Array =
-                OpenAI::Internal::Type::ArrayOf[-> {
-                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1
-                }]
-
-              # @type [OpenAI::Internal::Type::Converter]
-              UnionMember2Array =
-                OpenAI::Internal::Type::ArrayOf[-> {
-                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2
-                }]
+              #   @return [Array(OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation)]
             end
           end
 

data/lib/openai/provider.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module OpenAI
+  # Opaque configuration for an OpenAI-supported third-party provider.
+  #
+  # Provider instances are created by factories in OpenAI::Providers.
+  class Provider
+    # @api private
+    def initialize(definition) = @definition = definition
+
+    def inspect = "#<OpenAI::Provider>"
+
+    attr_reader(:definition)
+    private(:definition)
+
+    private_class_method :new, :allocate
+  end
+end