openai 0.98.0 → 0.100.0

data/rbi/openai/models/beta/beta_tool.rbi

@@ -976,9 +976,10 @@ module OpenAI
           sig { params(background: OpenAI::Beta::BetaTool::ImageGeneration::Background::OrSymbol).void }
           attr_writer :background
 
-          # Controls fidelity to the original input image(s). This parameter is supported
-          # for GPT image models that support input fidelity. `gpt-image-2` and
-          # `gpt-image-2-2026-04-21` ignore this parameter.
+          # Control how much effort the model will exert to match the style and features,
+          # especially facial features, of input images. Supports `high` and `low` on
+          # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+          # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
           sig { returns(T.nilable(OpenAI::Beta::BetaTool::ImageGeneration::InputFidelity::OrSymbol)) }
           attr_accessor :input_fidelity
 
@@ -1050,9 +1051,7 @@ module OpenAI
           # the maximum supported resolution is `3840x2160`. The requested size must also
           # satisfy the model's current pixel and edge limits. The standard sizes
           # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-          # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-          # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-          # `1024x1024`, `1792x1024`, or `1024x1792`.
+          # `auto` is supported for models that allow automatic sizing.
           sig { returns(T.nilable(T.any(String, OpenAI::Beta::BetaTool::ImageGeneration::Size::OrSymbol))) }
           attr_reader :size
 
@@ -1105,9 +1104,10 @@ module OpenAI
             # set the output format to `png` or `webp`.
             background: nil,
 
-            # Controls fidelity to the original input image(s). This parameter is supported
-            # for GPT image models that support input fidelity. `gpt-image-2` and
-            # `gpt-image-2-2026-04-21` ignore this parameter.
+            # Control how much effort the model will exert to match the style and features,
+            # especially facial features, of input images. Supports `high` and `low` on
+            # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+            # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
             input_fidelity: nil,
 
             # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -1150,9 +1150,7 @@ module OpenAI
             # the maximum supported resolution is `3840x2160`. The requested size must also
             # satisfy the model's current pixel and edge limits. The standard sizes
             # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-            # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-            # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-            # `1024x1024`, `1792x1024`, or `1024x1792`.
+            # `auto` is supported for models that allow automatic sizing.
             size: nil,
 
             # The type of the image generation tool. Always `image_generation`.
@@ -1222,9 +1220,10 @@ module OpenAI
             end
           end
 
-          # Controls fidelity to the original input image(s). This parameter is supported
-          # for GPT image models that support input fidelity. `gpt-image-2` and
-          # `gpt-image-2-2026-04-21` ignore this parameter.
+          # Control how much effort the model will exert to match the style and features,
+          # especially facial features, of input images. Supports `high` and `low` on
+          # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+          # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
           module InputFidelity
             extend OpenAI::Internal::Type::Enum
 
@@ -1407,9 +1406,7 @@ module OpenAI
           # the maximum supported resolution is `3840x2160`. The requested size must also
           # satisfy the model's current pixel and edge limits. The standard sizes
           # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-          # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-          # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-          # `1024x1024`, `1792x1024`, or `1024x1792`.
+          # `auto` is supported for models that allow automatic sizing.
           module Size
             extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/beta/environment_param.rbi

@@ -114,8 +114,8 @@ module OpenAI
           }
           attr_accessor :files
 
-          # Network access policy for the environment. Defaults to disabled for GA requests
-          # and enabled for beta requests.
+          # Network access policy for the environment. If omitted, the API version
+          # determines whether network access is enabled or disabled.
           sig { returns(T.nilable(OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network)) }
           attr_reader :network
 
@@ -216,8 +216,8 @@ module OpenAI
             # Files available before the agent starts. Defaults to an empty list.
             files: nil,
 
-            # Network access policy for the environment. Defaults to disabled for GA requests
-            # and enabled for beta requests.
+            # Network access policy for the environment. If omitted, the API version
+            # determines whether network access is enabled or disabled.
             network: nil,
 
             # Packages to install in the environment. Defaults to empty package lists.
@@ -350,8 +350,8 @@ module OpenAI
             sig { returns(T.nilable(T::Array[String])) }
             attr_accessor :blocked_domains
 
-            # Network access policy for the environment. Defaults to disabled for GA requests
-            # and enabled for beta requests.
+            # Network access policy for the environment. If omitted, the API version
+            # determines whether network access is enabled or disabled.
             sig do
               params(
 

data/rbi/openai/models/beta/session_turn_error.rbi

@@ -67,6 +67,24 @@ module OpenAI
           # The organization has reached a usage, plan, or billing limit.
           USAGE_LIMIT_EXCEEDED = T.let(:usage_limit_exceeded, OpenAI::Beta::SessionTurnError::Code::TaggedSymbol)
 
+          # The project has reached its enforced spend limit.
+          PROJECT_SPEND_LIMIT_EXCEEDED = T.let(
+            :project_spend_limit_exceeded,
+            OpenAI::Beta::SessionTurnError::Code::TaggedSymbol
+          )
+
+          # The organization has reached its enforced spend limit.
+          ORGANIZATION_SPEND_LIMIT_EXCEEDED = T.let(
+            :organization_spend_limit_exceeded,
+            OpenAI::Beta::SessionTurnError::Code::TaggedSymbol
+          )
+
+          # The organization has reached its OpenAI-assigned usage limit.
+          ORGANIZATION_USAGE_LIMIT_EXCEEDED = T.let(
+            :organization_usage_limit_exceeded,
+            OpenAI::Beta::SessionTurnError::Code::TaggedSymbol
+          )
+
           # The organization has no API credits remaining.
           CREDIT_BALANCE_EXHAUSTED = T.let(
             :credit_balance_exhausted,

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

@@ -24,7 +24,8 @@ module OpenAI
         # The voice the model uses to respond. Supported built-in voices are `alloy`,
         # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
         # `marin`, and `cedar`. You may also provide a custom voice object with an `id`,
-        # for example `{ "id": "voice_1234" }`.
+        # for example `{ "id": "voice_1234" }`. Custom voices must be created from audio
+        # samples. Voices created from text prompts are supported only in Live.
         sig {
           returns(
             T.any(
@@ -61,7 +62,8 @@ module OpenAI
           # The voice the model uses to respond. Supported built-in voices are `alloy`,
           # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
           # `marin`, and `cedar`. You may also provide a custom voice object with an `id`,
-          # for example `{ "id": "voice_1234" }`.
+          # for example `{ "id": "voice_1234" }`. Custom voices must be created from audio
+          # samples. Voices created from text prompts are supported only in Live.
 
           voice:
         )
@@ -105,7 +107,8 @@ module OpenAI
         # The voice the model uses to respond. Supported built-in voices are `alloy`,
         # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
         # `marin`, and `cedar`. You may also provide a custom voice object with an `id`,
-        # for example `{ "id": "voice_1234" }`.
+        # for example `{ "id": "voice_1234" }`. Custom voices must be created from audio
+        # samples. Voices created from text prompts are supported only in Live.
         module Voice
           extend OpenAI::Internal::Type::Union
 

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

@@ -228,26 +228,29 @@ module OpenAI
             )
           end
 
-          # A chat completion delta generated by streamed model responses.
+          # A chat completion delta generated by streamed model responses. Streamed audio
+          # can arrive in partial updates with an ID, base64 data, or transcript text. The
+          # final audio update contains only its expiry timestamp.
           sig { returns(OpenAI::Chat::ChatCompletionChunk::Choice::Delta) }
           attr_reader :delta
 
           sig { params(delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::OrHash).void }
           attr_writer :delta
 
+          # The index of the choice in the list of choices.
+          sig { returns(Integer) }
+          attr_accessor :index
+
           # The reason the model stopped generating tokens. This will be `stop` if the model
           # hit a natural stop point or a provided stop sequence, `length` if the maximum
           # number of tokens specified in the request was reached, `content_filter` if
           # content was omitted due to a flag from our content filters, `tool_calls` if the
           # model called a tool, or `function_call` (deprecated) if the model called a
-          # function.
+          # function. Omitted from the final audio update containing only
+          # `delta.audio.expires_at`.
           sig { returns(T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::FinishReason::TaggedSymbol)) }
           attr_accessor :finish_reason
 
-          # The index of the choice in the list of choices.
-          sig { returns(Integer) }
-          attr_accessor :index
-
           # Log probability information for the choice.
           sig { returns(T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs)) }
           attr_reader :logprobs
@@ -260,29 +263,32 @@ module OpenAI
 
               delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::OrHash,
 
-              finish_reason: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::FinishReason::OrSymbol),
-
               index: Integer,
 
+              finish_reason: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::FinishReason::OrSymbol),
+
               logprobs: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs::OrHash)
             )
               .returns(T.attached_class)
           end
           def self.new(
 
-            # A chat completion delta generated by streamed model responses.
+            # A chat completion delta generated by streamed model responses. Streamed audio
+            # can arrive in partial updates with an ID, base64 data, or transcript text. The
+            # final audio update contains only its expiry timestamp.
             delta:,
 
+            # The index of the choice in the list of choices.
+            index:,
+
             # The reason the model stopped generating tokens. This will be `stop` if the model
             # hit a natural stop point or a provided stop sequence, `length` if the maximum
             # number of tokens specified in the request was reached, `content_filter` if
             # content was omitted due to a flag from our content filters, `tool_calls` if the
             # model called a tool, or `function_call` (deprecated) if the model called a
-            # function.
-            finish_reason:,
-
-            # The index of the choice in the list of choices.
-            index:,
+            # function. Omitted from the final audio update containing only
+            # `delta.audio.expires_at`.
+            finish_reason: nil,
 
             # Log probability information for the choice.
 
@@ -294,8 +300,8 @@ module OpenAI
             override.returns(
               {
                 delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta,
-                finish_reason: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::FinishReason::TaggedSymbol),
                 index: Integer,
+                finish_reason: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::FinishReason::TaggedSymbol),
                 logprobs: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs)
               }
             )
@@ -311,6 +317,14 @@ module OpenAI
               )
             end
 
+            # A partial audio response. Audio chunks may carry an ID, base64 data, or
+            # transcript text; the final audio update contains only its expiry timestamp.
+            sig { returns(T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio)) }
+            attr_reader :audio
+
+            sig { params(audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio::OrHash).void }
+            attr_writer :audio
+
             # The contents of the chunk message.
             sig { returns(T.nilable(String)) }
             attr_accessor :content
@@ -342,10 +356,14 @@ module OpenAI
             }
             attr_writer :tool_calls
 
-            # A chat completion delta generated by streamed model responses.
+            # A chat completion delta generated by streamed model responses. Streamed audio
+            # can arrive in partial updates with an ID, base64 data, or transcript text. The
+            # final audio update contains only its expiry timestamp.
             sig do
               params(
 
+                audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio::OrHash,
+
                 content: T.nilable(String),
 
                 function_call: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::FunctionCall::OrHash,
@@ -360,6 +378,10 @@ module OpenAI
             end
             def self.new(
 
+              # A partial audio response. Audio chunks may carry an ID, base64 data, or
+              # transcript text; the final audio update contains only its expiry timestamp.
+              audio: nil,
+
               # The contents of the chunk message.
               content: nil,
 
@@ -380,6 +402,7 @@ module OpenAI
             sig do
               override.returns(
                 {
+                  audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio,
                   content: T.nilable(String),
                   function_call: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::FunctionCall,
                   refusal: T.nilable(String),
@@ -391,6 +414,88 @@ module OpenAI
             def to_hash
             end
 
+            class Audio < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # Unique identifier for this audio response.
+              sig { returns(T.nilable(String)) }
+              attr_reader :id
+
+              sig { params(id: String).void }
+              attr_writer :id
+
+              # Base64 encoded audio bytes generated by the model, in the format specified in
+              # the request.
+              sig { returns(T.nilable(String)) }
+              attr_reader :data
+
+              sig { params(data: String).void }
+              attr_writer :data
+
+              # The Unix timestamp (in seconds) for when this audio response will no longer be
+              # accessible on the server for use in multi-turn conversations.
+              sig { returns(T.nilable(Integer)) }
+              attr_reader :expires_at
+
+              sig { params(expires_at: Integer).void }
+              attr_writer :expires_at
+
+              # Transcript text from this audio chunk.
+              sig { returns(T.nilable(String)) }
+              attr_reader :transcript
+
+              sig { params(transcript: String).void }
+              attr_writer :transcript
+
+              # A partial audio response. Audio chunks may carry an ID, base64 data, or
+              # transcript text; the final audio update contains only its expiry timestamp.
+              sig do
+                params(
+
+                  id: String,
+
+                  data: String,
+
+                  expires_at: Integer,
+
+                  transcript: String
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # Unique identifier for this audio response.
+                id: nil,
+
+                # Base64 encoded audio bytes generated by the model, in the format specified in
+                # the request.
+                data: nil,
+
+                # The Unix timestamp (in seconds) for when this audio response will no longer be
+                # accessible on the server for use in multi-turn conversations.
+                expires_at: nil,
+
+                # Transcript text from this audio chunk.
+
+                transcript: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {id: String, data: String, expires_at: Integer, transcript: String}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
             class FunctionCall < OpenAI::Internal::Type::BaseModel
               OrHash = T.type_alias do
                 T.any(
@@ -633,7 +738,8 @@ module OpenAI
           # number of tokens specified in the request was reached, `content_filter` if
           # content was omitted due to a flag from our content filters, `tool_calls` if the
           # model called a tool, or `function_call` (deprecated) if the model called a
-          # function.
+          # function. Omitted from the final audio update containing only
+          # `delta.audio.expires_at`.
           module FinishReason
             extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/error_object.rbi

@@ -95,6 +95,11 @@ module OpenAI
         sig { params(error_type: T.any(String, OpenAI::ErrorObject::Misalignment::ErrorType::OrSymbol)).void }
         attr_writer :error_type
 
+        # An opaque target for explicitly continuing this review, or null when
+        # unavailable.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :review_target
+
         # An optional public continuation instruction.
         sig { returns(T.nilable(OpenAI::ErrorObject::Misalignment::Steer)) }
         attr_reader :steer
@@ -109,6 +114,8 @@ module OpenAI
 
             error_type: T.any(String, OpenAI::ErrorObject::Misalignment::ErrorType::OrSymbol),
 
+            review_target: T.nilable(String),
+
             steer: OpenAI::ErrorObject::Misalignment::Steer::OrHash
           )
             .returns(T.attached_class)
@@ -121,6 +128,10 @@ module OpenAI
           # An optional classification; clients must accept additional values.
           error_type: nil,
 
+          # An opaque target for explicitly continuing this review, or null when
+          # unavailable.
+          review_target: nil,
+
           # An optional public continuation instruction.
 
           steer: nil
@@ -132,6 +143,7 @@ module OpenAI
             {
               detailed_explanation: String,
               error_type: T.any(String, OpenAI::ErrorObject::Misalignment::ErrorType::OrSymbol),
+              review_target: T.nilable(String),
               steer: OpenAI::ErrorObject::Misalignment::Steer
             }
           )

data/rbi/openai/models/eval_create_params.rbi

@@ -1021,7 +1021,7 @@ module OpenAI
             # The name of the grader.
             name:,
 
-            # The range of the score. Defaults to `[0, 1]`.
+            # The service requires two numbers for the score range. Defaults to `[0, 1]`.
             range: nil,
 
             # The sampling parameters for the model.

data/rbi/openai/models/eval_create_response.rbi

@@ -413,7 +413,7 @@ module OpenAI
             # The name of the grader.
             name:,
 
-            # The range of the score. Defaults to `[0, 1]`.
+            # The service requires two numbers for the score range. Defaults to `[0, 1]`.
             range: nil,
 
             # The sampling parameters for the model.

data/rbi/openai/models/eval_list_response.rbi

@@ -413,7 +413,7 @@ module OpenAI
             # The name of the grader.
             name:,
 
-            # The range of the score. Defaults to `[0, 1]`.
+            # The service requires two numbers for the score range. Defaults to `[0, 1]`.
             range: nil,
 
             # The sampling parameters for the model.

data/rbi/openai/models/eval_retrieve_response.rbi

@@ -413,7 +413,7 @@ module OpenAI
             # The name of the grader.
             name:,
 
-            # The range of the score. Defaults to `[0, 1]`.
+            # The service requires two numbers for the score range. Defaults to `[0, 1]`.
             range: nil,
 
             # The sampling parameters for the model.

data/rbi/openai/models/eval_update_response.rbi

@@ -413,7 +413,7 @@ module OpenAI
             # The name of the grader.
             name:,
 
-            # The range of the score. Defaults to `[0, 1]`.
+            # The service requires two numbers for the score range. Defaults to `[0, 1]`.
             range: nil,
 
             # The sampling parameters for the model.

data/rbi/openai/models/fine_tuning/job_list_params.rbi

@@ -31,8 +31,13 @@ module OpenAI
         sig { params(limit: Integer).void }
         attr_writer :limit
 
-        # Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
-        # Alternatively, set `metadata=null` to indicate no metadata.
+        # Optional metadata filter. To filter, use the syntax `metadata[k]=v`. Omitting
+        # the parameter or passing an empty object applies no metadata filter. An empty
+        # value, such as `metadata[k]=`, filters for that key with an empty string value.
+        # To select jobs with null metadata, send the literal query string
+        # `metadata=null`. Nullable caller types do not specify how a client serializes
+        # null for a deep-object parameter. Use a raw query parameter if the client omits
+        # null. Do not combine the two query forms.
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_accessor :metadata
 
@@ -57,8 +62,13 @@ module OpenAI
           # Number of fine-tuning jobs to retrieve.
           limit: nil,
 
-          # Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
-          # Alternatively, set `metadata=null` to indicate no metadata.
+          # Optional metadata filter. To filter, use the syntax `metadata[k]=v`. Omitting
+          # the parameter or passing an empty object applies no metadata filter. An empty
+          # value, such as `metadata[k]=`, filters for that key with an empty string value.
+          # To select jobs with null metadata, send the literal query string
+          # `metadata=null`. Nullable caller types do not specify how a client serializes
+          # null for a deep-object parameter. Use a raw query parameter if the client omits
+          # null. Do not combine the two query forms.
           metadata: nil,
 
           request_options: {}

data/rbi/openai/models/graders/score_model_grader.rbi

@@ -33,7 +33,7 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
-        # The range of the score. Defaults to `[0, 1]`.
+        # The service requires two numbers for the score range. Defaults to `[0, 1]`.
         sig { returns(T.nilable(T::Array[Float])) }
         attr_reader :range
 
@@ -77,7 +77,7 @@ module OpenAI
           # The name of the grader.
           name:,
 
-          # The range of the score. Defaults to `[0, 1]`.
+          # The service requires two numbers for the score range. Defaults to `[0, 1]`.
           range: nil,
 
           # The sampling parameters for the model.

data/rbi/openai/models/image.rbi

@@ -12,25 +12,25 @@ module OpenAI
         )
       end
 
-      # The base64-encoded JSON of the generated image. Returned by default for the GPT
-      # image models, and only present if `response_format` is set to `b64_json` for
-      # `dall-e-2` and `dall-e-3`.
+      # The base64-encoded JSON of the generated image. Returned by default for GPT
+      # image models, or when `response_format` is set to `b64_json` for models that
+      # support that parameter.
       sig { returns(T.nilable(String)) }
       attr_reader :b64_json
 
       sig { params(b64_json: String).void }
       attr_writer :b64_json
 
-      # For `dall-e-3` only, the revised prompt that was used to generate the image.
+      # The revised prompt used to generate the image, for models that support prompt
+      # revision. Not returned by GPT image models.
       sig { returns(T.nilable(String)) }
       attr_reader :revised_prompt
 
       sig { params(revised_prompt: String).void }
       attr_writer :revised_prompt
 
-      # When using `dall-e-2` or `dall-e-3`, the URL of the generated image if
-      # `response_format` is set to `url` (default value). Unsupported for the GPT image
-      # models.
+      # The URL of the generated image when `response_format` is set to `url` for models
+      # that support that parameter. Unsupported for GPT image models.
       sig { returns(T.nilable(String)) }
       attr_reader :url
 
@@ -51,17 +51,17 @@ module OpenAI
       end
       def self.new(
 
-        # The base64-encoded JSON of the generated image. Returned by default for the GPT
-        # image models, and only present if `response_format` is set to `b64_json` for
-        # `dall-e-2` and `dall-e-3`.
+        # The base64-encoded JSON of the generated image. Returned by default for GPT
+        # image models, or when `response_format` is set to `b64_json` for models that
+        # support that parameter.
         b64_json: nil,
 
-        # For `dall-e-3` only, the revised prompt that was used to generate the image.
+        # The revised prompt used to generate the image, for models that support prompt
+        # revision. Not returned by GPT image models.
         revised_prompt: nil,
 
-        # When using `dall-e-2` or `dall-e-3`, the URL of the generated image if
-        # `response_format` is set to `url` (default value). Unsupported for the GPT image
-        # models.
+        # The URL of the generated image when `response_format` is set to `url` for models
+        # that support that parameter. Unsupported for GPT image models.
 
         url: nil
       )

data/rbi/openai/models/image_create_variation_params.rbi

@@ -24,8 +24,8 @@ module OpenAI
       sig { returns(OpenAI::Internal::FileInput) }
       attr_accessor :image
 
-      # The model to use for image generation. Only `dall-e-2` is supported at this
-      # time.
+      # The legacy model used by the retired image variations endpoint. This endpoint no
+      # longer accepts requests.
       sig { returns(T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol))) }
       attr_accessor :model
 
@@ -82,8 +82,8 @@ module OpenAI
         # content type.
         image:,
 
-        # The model to use for image generation. Only `dall-e-2` is supported at this
-        # time.
+        # The legacy model used by the retired image variations endpoint. This endpoint no
+        # longer accepts requests.
         model: nil,
 
         # The number of images to generate. Must be between 1 and 10.
@@ -123,8 +123,8 @@ module OpenAI
       def to_hash
       end
 
-      # The model to use for image generation. Only `dall-e-2` is supported at this
-      # time.
+      # The legacy model used by the retired image variations endpoint. This endpoint no
+      # longer accepts requests.
       module Model
         extend OpenAI::Internal::Type::Union