openai 0.13.1 → 0.15.0

data/lib/openai.rb

@@ -320,8 +320,14 @@ require_relative "openai/models/graders/multi_grader"
 require_relative "openai/models/graders/string_check_grader"
 require_relative "openai/models/image"
 require_relative "openai/models/image_create_variation_params"
+require_relative "openai/models/image_edit_completed_event"
 require_relative "openai/models/image_edit_params"
+require_relative "openai/models/image_edit_partial_image_event"
+require_relative "openai/models/image_edit_stream_event"
+require_relative "openai/models/image_gen_completed_event"
 require_relative "openai/models/image_generate_params"
+require_relative "openai/models/image_gen_partial_image_event"
+require_relative "openai/models/image_gen_stream_event"
 require_relative "openai/models/image_model"
 require_relative "openai/models/images_response"
 require_relative "openai/models/metadata"
@@ -419,8 +425,6 @@ require_relative "openai/models/responses/response_output_text"
 require_relative "openai/models/responses/response_output_text_annotation_added_event"
 require_relative "openai/models/responses/response_prompt"
 require_relative "openai/models/responses/response_queued_event"
-require_relative "openai/models/responses/response_reasoning_delta_event"
-require_relative "openai/models/responses/response_reasoning_done_event"
 require_relative "openai/models/responses/response_reasoning_item"
 require_relative "openai/models/responses/response_reasoning_summary_delta_event"
 require_relative "openai/models/responses/response_reasoning_summary_done_event"

data/rbi/openai/models/audio/speech_create_params.rbi

@@ -216,15 +216,6 @@ module OpenAI
             )
           ECHO =
             T.let(:echo, OpenAI::Audio::SpeechCreateParams::Voice::TaggedSymbol)
-          FABLE =
-            T.let(
-              :fable,
-              OpenAI::Audio::SpeechCreateParams::Voice::TaggedSymbol
-            )
-          ONYX =
-            T.let(:onyx, OpenAI::Audio::SpeechCreateParams::Voice::TaggedSymbol)
-          NOVA =
-            T.let(:nova, OpenAI::Audio::SpeechCreateParams::Voice::TaggedSymbol)
           SAGE =
             T.let(:sage, OpenAI::Audio::SpeechCreateParams::Voice::TaggedSymbol)
           SHIMMER =

data/rbi/openai/models/chat/chat_completion.rbi

@@ -37,7 +37,7 @@ module OpenAI
         # - If set to 'auto', then the request will be processed with the service tier
         #   configured in the Project settings. Unless otherwise configured, the Project
         #   will use 'default'.
-        # - If set to 'default', then the requset will be processed with the standard
+        # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
         #   'priority', then the request will be processed with the corresponding service
@@ -103,7 +103,7 @@ module OpenAI
           # - If set to 'auto', then the request will be processed with the service tier
           #   configured in the Project settings. Unless otherwise configured, the Project
           #   will use 'default'.
-          # - If set to 'default', then the requset will be processed with the standard
+          # - If set to 'default', then the request will be processed with the standard
           #   pricing and performance for the selected model.
           # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
           #   'priority', then the request will be processed with the corresponding service
@@ -368,7 +368,7 @@ module OpenAI
         # - If set to 'auto', then the request will be processed with the service tier
         #   configured in the Project settings. Unless otherwise configured, the Project
         #   will use 'default'.
-        # - If set to 'default', then the requset will be processed with the standard
+        # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
         #   'priority', then the request will be processed with the corresponding service

data/rbi/openai/models/chat/chat_completion_audio_param.rbi

@@ -176,21 +176,6 @@ module OpenAI
               :echo,
               OpenAI::Chat::ChatCompletionAudioParam::Voice::TaggedSymbol
             )
-          FABLE =
-            T.let(
-              :fable,
-              OpenAI::Chat::ChatCompletionAudioParam::Voice::TaggedSymbol
-            )
-          ONYX =
-            T.let(
-              :onyx,
-              OpenAI::Chat::ChatCompletionAudioParam::Voice::TaggedSymbol
-            )
-          NOVA =
-            T.let(
-              :nova,
-              OpenAI::Chat::ChatCompletionAudioParam::Voice::TaggedSymbol
-            )
           SAGE =
             T.let(
               :sage,

data/rbi/openai/models/chat/chat_completion_chunk.rbi

@@ -39,7 +39,7 @@ module OpenAI
         # - If set to 'auto', then the request will be processed with the service tier
         #   configured in the Project settings. Unless otherwise configured, the Project
         #   will use 'default'.
-        # - If set to 'default', then the requset will be processed with the standard
+        # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
         #   'priority', then the request will be processed with the corresponding service
@@ -118,7 +118,7 @@ module OpenAI
           # - If set to 'auto', then the request will be processed with the service tier
           #   configured in the Project settings. Unless otherwise configured, the Project
           #   will use 'default'.
-          # - If set to 'default', then the requset will be processed with the standard
+          # - If set to 'default', then the request will be processed with the standard
           #   pricing and performance for the selected model.
           # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
           #   'priority', then the request will be processed with the corresponding service
@@ -788,7 +788,7 @@ module OpenAI
         # - If set to 'auto', then the request will be processed with the service tier
         #   configured in the Project settings. Unless otherwise configured, the Project
         #   will use 'default'.
-        # - If set to 'default', then the requset will be processed with the standard
+        # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
         #   'priority', then the request will be processed with the corresponding service

data/rbi/openai/models/chat/completion_create_params.rbi

@@ -275,7 +275,7 @@ module OpenAI
         # - If set to 'auto', then the request will be processed with the service tier
         #   configured in the Project settings. Unless otherwise configured, the Project
         #   will use 'default'.
-        # - If set to 'default', then the requset will be processed with the standard
+        # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
         #   'priority', then the request will be processed with the corresponding service
@@ -632,7 +632,7 @@ module OpenAI
           # - If set to 'auto', then the request will be processed with the service tier
           #   configured in the Project settings. Unless otherwise configured, the Project
           #   will use 'default'.
-          # - If set to 'default', then the requset will be processed with the standard
+          # - If set to 'default', then the request will be processed with the standard
           #   pricing and performance for the selected model.
           # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
           #   'priority', then the request will be processed with the corresponding service
@@ -1017,7 +1017,7 @@ module OpenAI
         # - If set to 'auto', then the request will be processed with the service tier
         #   configured in the Project settings. Unless otherwise configured, the Project
         #   will use 'default'.
-        # - If set to 'default', then the requset will be processed with the standard
+        # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
         #   'priority', then the request will be processed with the corresponding service

data/rbi/openai/models/function_definition.rbi

@@ -38,7 +38,7 @@ module OpenAI
       # set to true, the model will follow the exact schema defined in the `parameters`
       # field. Only a subset of JSON Schema is supported when `strict` is `true`. Learn
       # more about Structured Outputs in the
-      # [function calling guide](docs/guides/function-calling).
+      # [function calling guide](https://platform.openai.com/docs/guides/function-calling).
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :strict
 
@@ -69,7 +69,7 @@ module OpenAI
         # set to true, the model will follow the exact schema defined in the `parameters`
         # field. Only a subset of JSON Schema is supported when `strict` is `true`. Learn
         # more about Structured Outputs in the
-        # [function calling guide](docs/guides/function-calling).
+        # [function calling guide](https://platform.openai.com/docs/guides/function-calling).
         strict: nil
       )
       end

data/rbi/openai/models/image_edit_completed_event.rbi

@@ -0,0 +1,346 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    class ImageEditCompletedEvent < OpenAI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(OpenAI::ImageEditCompletedEvent, OpenAI::Internal::AnyHash)
+        end
+
+      # Base64-encoded final edited image data, suitable for rendering as an image.
+      sig { returns(String) }
+      attr_accessor :b64_json
+
+      # The background setting for the edited image.
+      sig { returns(OpenAI::ImageEditCompletedEvent::Background::TaggedSymbol) }
+      attr_accessor :background
+
+      # The Unix timestamp when the event was created.
+      sig { returns(Integer) }
+      attr_accessor :created_at
+
+      # The output format for the edited image.
+      sig do
+        returns(OpenAI::ImageEditCompletedEvent::OutputFormat::TaggedSymbol)
+      end
+      attr_accessor :output_format
+
+      # The quality setting for the edited image.
+      sig { returns(OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol) }
+      attr_accessor :quality
+
+      # The size of the edited image.
+      sig { returns(OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol) }
+      attr_accessor :size
+
+      # The type of the event. Always `image_edit.completed`.
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      # For `gpt-image-1` only, the token usage information for the image generation.
+      sig { returns(OpenAI::ImageEditCompletedEvent::Usage) }
+      attr_reader :usage
+
+      sig { params(usage: OpenAI::ImageEditCompletedEvent::Usage::OrHash).void }
+      attr_writer :usage
+
+      # Emitted when image editing has completed and the final image is available.
+      sig do
+        params(
+          b64_json: String,
+          background: OpenAI::ImageEditCompletedEvent::Background::OrSymbol,
+          created_at: Integer,
+          output_format:
+            OpenAI::ImageEditCompletedEvent::OutputFormat::OrSymbol,
+          quality: OpenAI::ImageEditCompletedEvent::Quality::OrSymbol,
+          size: OpenAI::ImageEditCompletedEvent::Size::OrSymbol,
+          usage: OpenAI::ImageEditCompletedEvent::Usage::OrHash,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Base64-encoded final edited image data, suitable for rendering as an image.
+        b64_json:,
+        # The background setting for the edited image.
+        background:,
+        # The Unix timestamp when the event was created.
+        created_at:,
+        # The output format for the edited image.
+        output_format:,
+        # The quality setting for the edited image.
+        quality:,
+        # The size of the edited image.
+        size:,
+        # For `gpt-image-1` only, the token usage information for the image generation.
+        usage:,
+        # The type of the event. Always `image_edit.completed`.
+        type: :"image_edit.completed"
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            b64_json: String,
+            background:
+              OpenAI::ImageEditCompletedEvent::Background::TaggedSymbol,
+            created_at: Integer,
+            output_format:
+              OpenAI::ImageEditCompletedEvent::OutputFormat::TaggedSymbol,
+            quality: OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol,
+            size: OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol,
+            type: Symbol,
+            usage: OpenAI::ImageEditCompletedEvent::Usage
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The background setting for the edited image.
+      module Background
+        extend OpenAI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, OpenAI::ImageEditCompletedEvent::Background)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRANSPARENT =
+          T.let(
+            :transparent,
+            OpenAI::ImageEditCompletedEvent::Background::TaggedSymbol
+          )
+        OPAQUE =
+          T.let(
+            :opaque,
+            OpenAI::ImageEditCompletedEvent::Background::TaggedSymbol
+          )
+        AUTO =
+          T.let(
+            :auto,
+            OpenAI::ImageEditCompletedEvent::Background::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[OpenAI::ImageEditCompletedEvent::Background::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The output format for the edited image.
+      module OutputFormat
+        extend OpenAI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, OpenAI::ImageEditCompletedEvent::OutputFormat)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PNG =
+          T.let(
+            :png,
+            OpenAI::ImageEditCompletedEvent::OutputFormat::TaggedSymbol
+          )
+        WEBP =
+          T.let(
+            :webp,
+            OpenAI::ImageEditCompletedEvent::OutputFormat::TaggedSymbol
+          )
+        JPEG =
+          T.let(
+            :jpeg,
+            OpenAI::ImageEditCompletedEvent::OutputFormat::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              OpenAI::ImageEditCompletedEvent::OutputFormat::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The quality setting for the edited image.
+      module Quality
+        extend OpenAI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, OpenAI::ImageEditCompletedEvent::Quality)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        LOW =
+          T.let(:low, OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol)
+        MEDIUM =
+          T.let(:medium, OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol)
+        HIGH =
+          T.let(:high, OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol)
+        AUTO =
+          T.let(:auto, OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The size of the edited image.
+      module Size
+        extend OpenAI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, OpenAI::ImageEditCompletedEvent::Size) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SIZE_1024X1024 =
+          T.let(
+            :"1024x1024",
+            OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol
+          )
+        SIZE_1024X1536 =
+          T.let(
+            :"1024x1536",
+            OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol
+          )
+        SIZE_1536X1024 =
+          T.let(
+            :"1536x1024",
+            OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol
+          )
+        AUTO = T.let(:auto, OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class Usage < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::ImageEditCompletedEvent::Usage,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # The number of tokens (images and text) in the input prompt.
+        sig { returns(Integer) }
+        attr_accessor :input_tokens
+
+        # The input tokens detailed information for the image generation.
+        sig do
+          returns(OpenAI::ImageEditCompletedEvent::Usage::InputTokensDetails)
+        end
+        attr_reader :input_tokens_details
+
+        sig do
+          params(
+            input_tokens_details:
+              OpenAI::ImageEditCompletedEvent::Usage::InputTokensDetails::OrHash
+          ).void
+        end
+        attr_writer :input_tokens_details
+
+        # The number of image tokens in the output image.
+        sig { returns(Integer) }
+        attr_accessor :output_tokens
+
+        # The total number of tokens (images and text) used for the image generation.
+        sig { returns(Integer) }
+        attr_accessor :total_tokens
+
+        # For `gpt-image-1` only, the token usage information for the image generation.
+        sig do
+          params(
+            input_tokens: Integer,
+            input_tokens_details:
+              OpenAI::ImageEditCompletedEvent::Usage::InputTokensDetails::OrHash,
+            output_tokens: Integer,
+            total_tokens: Integer
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The number of tokens (images and text) in the input prompt.
+          input_tokens:,
+          # The input tokens detailed information for the image generation.
+          input_tokens_details:,
+          # The number of image tokens in the output image.
+          output_tokens:,
+          # The total number of tokens (images and text) used for the image generation.
+          total_tokens:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              input_tokens: Integer,
+              input_tokens_details:
+                OpenAI::ImageEditCompletedEvent::Usage::InputTokensDetails,
+              output_tokens: Integer,
+              total_tokens: Integer
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class InputTokensDetails < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::ImageEditCompletedEvent::Usage::InputTokensDetails,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The number of image tokens in the input prompt.
+          sig { returns(Integer) }
+          attr_accessor :image_tokens
+
+          # The number of text tokens in the input prompt.
+          sig { returns(Integer) }
+          attr_accessor :text_tokens
+
+          # The input tokens detailed information for the image generation.
+          sig do
+            params(image_tokens: Integer, text_tokens: Integer).returns(
+              T.attached_class
+            )
+          end
+          def self.new(
+            # The number of image tokens in the input prompt.
+            image_tokens:,
+            # The number of text tokens in the input prompt.
+            text_tokens:
+          )
+          end
+
+          sig do
+            override.returns({ image_tokens: Integer, text_tokens: Integer })
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/image_edit_params.rbi

@@ -36,6 +36,14 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageEditParams::Background::OrSymbol)) }
       attr_accessor :background
 
+      # Control how much effort the model will exert to match the style and features,
+      # especially facial features, of input images. This parameter is only supported
+      # for `gpt-image-1`. Supports `high` and `low`. Defaults to `low`.
+      sig do
+        returns(T.nilable(OpenAI::ImageEditParams::InputFidelity::OrSymbol))
+      end
+      attr_accessor :input_fidelity
+
       # An additional image whose fully transparent areas (e.g. where alpha is zero)
       # indicate where `image` should be edited. If there are multiple images provided,
       # the mask will be applied on the first image. Must be a valid PNG file, less than
@@ -70,6 +78,15 @@ module OpenAI
       end
       attr_accessor :output_format
 
+      # The number of partial images to generate. This parameter is used for streaming
+      # responses that return partial images. Value must be between 0 and 3. When set to
+      # 0, the response will be a single image sent in one streaming event.
+      #
+      # Note that the final image may be sent before the full number of partial images
+      # are generated if the full image is generated more quickly.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :partial_images
+
       # The quality of the image that will be generated. `high`, `medium` and `low` are
       # only supported for `gpt-image-1`. `dall-e-2` only supports `standard` quality.
       # Defaults to `auto`.
@@ -105,12 +122,15 @@ module OpenAI
           image: OpenAI::ImageEditParams::Image::Variants,
           prompt: String,
           background: T.nilable(OpenAI::ImageEditParams::Background::OrSymbol),
+          input_fidelity:
+            T.nilable(OpenAI::ImageEditParams::InputFidelity::OrSymbol),
           mask: OpenAI::Internal::FileInput,
           model: T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol)),
           n: T.nilable(Integer),
           output_compression: T.nilable(Integer),
           output_format:
             T.nilable(OpenAI::ImageEditParams::OutputFormat::OrSymbol),
+          partial_images: T.nilable(Integer),
           quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
           response_format:
             T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
@@ -139,6 +159,10 @@ module OpenAI
         # If `transparent`, the output format needs to support transparency, so it should
         # be set to either `png` (default value) or `webp`.
         background: nil,
+        # Control how much effort the model will exert to match the style and features,
+        # especially facial features, of input images. This parameter is only supported
+        # for `gpt-image-1`. Supports `high` and `low`. Defaults to `low`.
+        input_fidelity: nil,
         # An additional image whose fully transparent areas (e.g. where alpha is zero)
         # indicate where `image` should be edited. If there are multiple images provided,
         # the mask will be applied on the first image. Must be a valid PNG file, less than
@@ -158,6 +182,13 @@ module OpenAI
         # supported for `gpt-image-1`. Must be one of `png`, `jpeg`, or `webp`. The
         # default value is `png`.
         output_format: nil,
+        # The number of partial images to generate. This parameter is used for streaming
+        # responses that return partial images. Value must be between 0 and 3. When set to
+        # 0, the response will be a single image sent in one streaming event.
+        #
+        # Note that the final image may be sent before the full number of partial images
+        # are generated if the full image is generated more quickly.
+        partial_images: nil,
         # The quality of the image that will be generated. `high`, `medium` and `low` are
         # only supported for `gpt-image-1`. `dall-e-2` only supports `standard` quality.
         # Defaults to `auto`.
@@ -186,12 +217,15 @@ module OpenAI
             prompt: String,
             background:
               T.nilable(OpenAI::ImageEditParams::Background::OrSymbol),
+            input_fidelity:
+              T.nilable(OpenAI::ImageEditParams::InputFidelity::OrSymbol),
             mask: OpenAI::Internal::FileInput,
             model: T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol)),
             n: T.nilable(Integer),
             output_compression: T.nilable(Integer),
             output_format:
               T.nilable(OpenAI::ImageEditParams::OutputFormat::OrSymbol),
+            partial_images: T.nilable(Integer),
             quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
             response_format:
               T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
@@ -258,6 +292,29 @@ module OpenAI
         end
       end
 
+      # Control how much effort the model will exert to match the style and features,
+      # especially facial features, of input images. This parameter is only supported
+      # for `gpt-image-1`. Supports `high` and `low`. Defaults to `low`.
+      module InputFidelity
+        extend OpenAI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, OpenAI::ImageEditParams::InputFidelity) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        HIGH =
+          T.let(:high, OpenAI::ImageEditParams::InputFidelity::TaggedSymbol)
+        LOW = T.let(:low, OpenAI::ImageEditParams::InputFidelity::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[OpenAI::ImageEditParams::InputFidelity::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
       # The model to use for image generation. Only `dall-e-2` and `gpt-image-1` are
       # supported. Defaults to `dall-e-2` unless a parameter specific to `gpt-image-1`
       # is used.