openai 0.103.0 → 0.104.0

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

@@ -875,6 +875,12 @@ module OpenAI
             nil?: true
           )
 
+          # @!attribute error
+          #   Details of a moderation failure, when available.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Error, nil]
+          optional :error, -> { OpenAI::Beta::BetaResponseOutputItem::ImageGenerationCall::Error }
+
           # @!attribute output_format
           #   The output format used for generation.
           #
@@ -914,7 +920,7 @@ module OpenAI
             nil?: true
           )
 
-          # @!method initialize(id:, result:, status:, action: nil, agent: nil, background: nil, output_format: nil, quality: nil, revised_prompt: nil, size: nil, type: :image_generation_call)
+          # @!method initialize(id:, result:, status:, action: nil, agent: nil, background: nil, error: nil, output_format: nil, quality: nil, revised_prompt: nil, size: nil, type: :image_generation_call)
           #   An image generation request made by the model.
           #
           #   @param id [String]
@@ -935,6 +941,9 @@ module OpenAI
           #   @param background [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Background, nil]
           #     The background setting used for generation.
           #
+          #   @param error [OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Error]
+          #     Details of a moderation failure, when available.
+          #
           #   @param output_format [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::OutputFormat, nil]
           #     The output format used for generation.
           #
@@ -1009,6 +1018,103 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
 
+          # @see OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall#error
+          class Error < OpenAI::Internal::Type::BaseModel
+            # @!attribute code
+            #   The error code.
+            #
+            #   @return [String, nil]
+            required :code, String, nil?: true
+
+            # @!attribute message
+            #   A description of the error.
+            #
+            #   @return [String]
+            required :message, String
+
+            # @!attribute param
+            #   The related request parameter.
+            #
+            #   @return [String, nil]
+            required :param, String, nil?: true
+
+            # @!attribute type
+            #   The error type.
+            #
+            #   @return [String]
+            required :type, String
+
+            # @!attribute moderation_details
+            #   Public details for a `moderation_blocked` error, when available.
+            #
+            #   @return [OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Error::ModerationDetails, nil]
+            optional(
+              :moderation_details,
+              -> { OpenAI::Beta::BetaResponseOutputItem::ImageGenerationCall::Error::ModerationDetails }
+            )
+
+            # @!method initialize(code:, message:, param:, type:, moderation_details: nil)
+            #   Details of a moderation failure, when available.
+            #
+            #   @param code [String, nil]
+            #     The error code.
+            #
+            #   @param message [String]
+            #     A description of the error.
+            #
+            #   @param param [String, nil]
+            #     The related request parameter.
+            #
+            #   @param type [String]
+            #     The error type.
+            #
+            #   @param moderation_details [OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Error::ModerationDetails]
+            #     Public details for a `moderation_blocked` error, when available.
+
+            # @see OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Error#moderation_details
+            class ModerationDetails < OpenAI::Internal::Type::BaseModel
+              # @!attribute categories
+              #   Public moderation categories. New category values may be added over time.
+              #
+              #   @return [Array<String>]
+              required :categories, OpenAI::Internal::Type::ArrayOf[String]
+
+              # @!attribute moderation_stage
+              #   The stage where moderation blocked the image generation call.
+              #
+              #   @return [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Error::ModerationDetails::ModerationStage]
+              required(
+                :moderation_stage,
+                enum: -> {
+                  OpenAI::Beta::BetaResponseOutputItem::ImageGenerationCall::Error::ModerationDetails::ModerationStage
+                }
+              )
+
+              # @!method initialize(categories:, moderation_stage:)
+              #   Public details for a `moderation_blocked` error, when available.
+              #
+              #   @param categories [Array<String>]
+              #     Public moderation categories. New category values may be added over time.
+              #
+              #   @param moderation_stage [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Error::ModerationDetails::ModerationStage]
+              #     The stage where moderation blocked the image generation call.
+
+              # The stage where moderation blocked the image generation call.
+              #
+              # @see OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Error::ModerationDetails#moderation_stage
+              module ModerationStage
+                extend OpenAI::Internal::Type::Enum
+
+                INPUT = :input
+                OUTPUT = :output
+                UNKNOWN = :unknown
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+
           # The output format used for generation.
           #
           # @see OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall#output_format

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

@@ -299,7 +299,7 @@ module OpenAI
           # @!attribute safety_identifier
           #   A stable identifier used to help detect users of your application that may be
           #   violating OpenAI's usage policies. The IDs should be a string that uniquely
-          #   identifies each user, with a maximum length of 64 characters. We recommend
+          #   identifies each user, with a maximum length of 128 characters. We recommend
           #   hashing their username or email address, in order to avoid sending us any
           #   identifying information.
           #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -634,7 +634,7 @@ module OpenAI
           #   @param safety_identifier [String, nil]
           #     A stable identifier used to help detect users of your application that may be
           #     violating OpenAI's usage policies. The IDs should be a string that uniquely
-          #     identifies each user, with a maximum length of 64 characters. We recommend
+          #     identifies each user, with a maximum length of 128 characters. We recommend
           #     hashing their username or email address, in order to avoid sending us any
           #     identifying information.
           #     [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -1321,6 +1321,9 @@ module OpenAI
             GPT_5_5_2026_04_23 = :"gpt-5.5-2026-04-23"
             GPT_5_4 = :"gpt-5.4"
             GPT_5_4_MINI = :"gpt-5.4-mini"
+            # @deprecated Announced shutdown date: 2027-04-01. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_5_4_NANO = :"gpt-5.4-nano"
             GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
             GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
@@ -1336,6 +1339,9 @@ module OpenAI
             GPT_5_2_CHAT_LATEST = :"gpt-5.2-chat-latest"
             GPT_5_2_PRO = :"gpt-5.2-pro"
             GPT_5_2_PRO_2025_12_11 = :"gpt-5.2-pro-2025-12-11"
+            # @deprecated Announced shutdown date: 2027-04-01. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_5_1 = :"gpt-5.1"
             GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
             # @deprecated Announced shutdown date: 2026-07-23. See
@@ -1382,7 +1388,13 @@ module OpenAI
             # https://developers.openai.com/api/docs/deprecations for details and recommended
             # replacements.
             GPT_4_1_NANO = :"gpt-4.1-nano"
+            # @deprecated Announced shutdown date: 2027-01-14. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_4_1_2025_04_14 = :"gpt-4.1-2025-04-14"
+            # @deprecated Announced shutdown date: 2027-01-14. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_4_1_MINI_2025_04_14 = :"gpt-4.1-mini-2025-04-14"
             # @deprecated Announced shutdown date: 2026-10-23. See
             # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1437,7 +1449,13 @@ module OpenAI
             # replacements.
             O1_MINI_2024_09_12 = :"o1-mini-2024-09-12"
             GPT_4O = :"gpt-4o"
+            # @deprecated Announced shutdown date: 2027-01-14. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_4O_2024_11_20 = :"gpt-4o-2024-11-20"
+            # @deprecated Announced shutdown date: 2027-01-14. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_4O_2024_08_06 = :"gpt-4o-2024-08-06"
             # @deprecated Announced shutdown date: 2026-10-23. See
             # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1500,6 +1518,9 @@ module OpenAI
             # replacements.
             CODEX_MINI_LATEST = :"codex-mini-latest"
             GPT_4O_MINI = :"gpt-4o-mini"
+            # @deprecated Announced shutdown date: 2027-01-14. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_4O_MINI_2024_07_18 = :"gpt-4o-mini-2024-07-18"
             # @deprecated Announced shutdown date: 2026-10-23. See
             # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -420,6 +420,9 @@ module OpenAI
           GPT_5_5_2026_04_23 = :"gpt-5.5-2026-04-23"
           GPT_5_4 = :"gpt-5.4"
           GPT_5_4_MINI = :"gpt-5.4-mini"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_4_NANO = :"gpt-5.4-nano"
           GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
           GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
@@ -435,6 +438,9 @@ module OpenAI
           GPT_5_2_CHAT_LATEST = :"gpt-5.2-chat-latest"
           GPT_5_2_PRO = :"gpt-5.2-pro"
           GPT_5_2_PRO_2025_12_11 = :"gpt-5.2-pro-2025-12-11"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_1 = :"gpt-5.1"
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           # @deprecated Announced shutdown date: 2026-07-23. See
@@ -481,7 +487,13 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_4_1_NANO = :"gpt-4.1-nano"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1_2025_04_14 = :"gpt-4.1-2025-04-14"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1_MINI_2025_04_14 = :"gpt-4.1-mini-2025-04-14"
           # @deprecated Announced shutdown date: 2026-10-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -536,7 +548,13 @@ module OpenAI
           # replacements.
           O1_MINI_2024_09_12 = :"o1-mini-2024-09-12"
           GPT_4O = :"gpt-4o"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_2024_11_20 = :"gpt-4o-2024-11-20"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_2024_08_06 = :"gpt-4o-2024-08-06"
           # @deprecated Announced shutdown date: 2026-10-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -599,6 +617,9 @@ module OpenAI
           # replacements.
           CODEX_MINI_LATEST = :"codex-mini-latest"
           GPT_4O_MINI = :"gpt-4o-mini"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_MINI_2024_07_18 = :"gpt-4o-mini-2024-07-18"
           # @deprecated Announced shutdown date: 2026-10-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -227,7 +227,7 @@ module OpenAI
         # @!attribute safety_identifier
         #   A stable identifier used to help detect users of your application that may be
         #   violating OpenAI's usage policies. The IDs should be a string that uniquely
-        #   identifies each user, with a maximum length of 64 characters. We recommend
+        #   identifies each user, with a maximum length of 128 characters. We recommend
         #   hashing their username or email address, in order to avoid sending us any
         #   identifying information.
         #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -524,7 +524,7 @@ module OpenAI
         #   @param safety_identifier [String, nil]
         #     A stable identifier used to help detect users of your application that may be
         #     violating OpenAI's usage policies. The IDs should be a string that uniquely
-        #     identifies each user, with a maximum length of 64 characters. We recommend
+        #     identifies each user, with a maximum length of 128 characters. We recommend
         #     hashing their username or email address, in order to avoid sending us any
         #     identifying information.
         #     [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -1005,6 +1005,9 @@ module OpenAI
           GPT_5_5_2026_04_23 = :"gpt-5.5-2026-04-23"
           GPT_5_4 = :"gpt-5.4"
           GPT_5_4_MINI = :"gpt-5.4-mini"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_4_NANO = :"gpt-5.4-nano"
           GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
           GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
@@ -1020,6 +1023,9 @@ module OpenAI
           GPT_5_2_CHAT_LATEST = :"gpt-5.2-chat-latest"
           GPT_5_2_PRO = :"gpt-5.2-pro"
           GPT_5_2_PRO_2025_12_11 = :"gpt-5.2-pro-2025-12-11"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_1 = :"gpt-5.1"
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           # @deprecated Announced shutdown date: 2026-07-23. See
@@ -1066,7 +1072,13 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_4_1_NANO = :"gpt-4.1-nano"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1_2025_04_14 = :"gpt-4.1-2025-04-14"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1_MINI_2025_04_14 = :"gpt-4.1-mini-2025-04-14"
           # @deprecated Announced shutdown date: 2026-10-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1121,7 +1133,13 @@ module OpenAI
           # replacements.
           O1_MINI_2024_09_12 = :"o1-mini-2024-09-12"
           GPT_4O = :"gpt-4o"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_2024_11_20 = :"gpt-4o-2024-11-20"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_2024_08_06 = :"gpt-4o-2024-08-06"
           # @deprecated Announced shutdown date: 2026-10-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1184,6 +1202,9 @@ module OpenAI
           # replacements.
           CODEX_MINI_LATEST = :"codex-mini-latest"
           GPT_4O_MINI = :"gpt-4o-mini"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_MINI_2024_07_18 = :"gpt-4o-mini-2024-07-18"
           # @deprecated Announced shutdown date: 2026-10-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -49,6 +49,9 @@ module OpenAI
           # The organization has reached its OpenAI-assigned usage limit.
           ORGANIZATION_USAGE_LIMIT_EXCEEDED = :organization_usage_limit_exceeded
 
+          # Billing is not active for the account.
+          BILLING_NOT_ACTIVE = :billing_not_active
+
           # The organization has no API credits remaining.
           CREDIT_BALANCE_EXHAUSTED = :credit_balance_exhausted
 

data/lib/openai/models/chat/chat_completion_audio_param.rb

@@ -16,7 +16,7 @@ module OpenAI
         #   `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" }`. Custom voices must be created from audio
-        #   samples.
+        #   samples. Voices created from text prompts are supported only in Live.
         #
         #   @return [String, Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice::ID, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice]
         required :voice, union: -> { OpenAI::Chat::ChatCompletionAudioParam::Voice }
@@ -35,7 +35,7 @@ module OpenAI
         #     `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" }`. Custom voices must be created from audio
-        #     samples.
+        #     samples. Voices created from text prompts are supported only in Live.
 
         # Specifies the output audio format. Must be one of `wav`, `mp3`, `flac`, `opus`,
         # or `pcm16`.
@@ -59,7 +59,7 @@ module OpenAI
         # `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" }`. Custom voices must be created from audio
-        # samples.
+        # samples. Voices created from text prompts are supported only in Live.
         #
         # @see OpenAI::Models::Chat::ChatCompletionAudioParam#voice
         module Voice

data/lib/openai/models/chat/chat_completion_message.rb

@@ -10,14 +10,6 @@ module OpenAI
         #   @return [String, nil]
         required :content, String, nil?: true
 
-        response_only do
-          # @!attribute parsed
-          #   The parsed contents of the message, if JSON schema is specified.
-          #
-          #   @return [Object, nil]
-          optional :parsed, OpenAI::StructuredOutput::ParsedJson
-        end
-
         # @!attribute refusal
         #   The refusal message generated by the model.
         #

data/lib/openai/models/chat/chat_completion_message_function_tool_call.rb

@@ -45,14 +45,6 @@ module OpenAI
           #   @return [String]
           required :arguments, String
 
-          response_only do
-            # @!attribute parsed
-            #   The parsed contents of the arguments.
-            #
-            #   @return [Object, nil]
-            required :parsed, OpenAI::StructuredOutput::ParsedJson
-          end
-
           # @!attribute name
           #   The name of the function to call.
           #

data/lib/openai/models/chat/completion_create_params.rb

@@ -276,7 +276,7 @@ module OpenAI
         # @!attribute safety_identifier
         #   A stable identifier used to help detect users of your application that may be
         #   violating OpenAI's usage policies. The IDs should be a string that uniquely
-        #   identifies each user, with a maximum length of 64 characters. We recommend
+        #   identifies each user, with a maximum length of 128 characters. We recommend
         #   hashing their username or email address, in order to avoid sending us any
         #   identifying information.
         #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -378,15 +378,12 @@ module OpenAI
         #   or
         #   [function tools](https://developers.openai.com/api/docs/guides/function-calling).
         #
-        #   @return [Array<OpenAI::Models::Chat::ChatCompletionTool, OpenAI::StructuredOutput::JsonSchemaConverter>, nil]
+        #   @return [Array<OpenAI::Models::Chat::ChatCompletionFunctionTool, OpenAI::Models::Chat::ChatCompletionCustomTool, OpenAI::StructuredOutput::JsonSchemaConverter>, nil]
         optional(
           :tools,
           -> {
             OpenAI::Internal::Type::ArrayOf[
-              union: OpenAI::UnionOf[
-                OpenAI::Chat::ChatCompletionTool,
-                OpenAI::StructuredOutput::JsonSchemaConverter
-              ]
+              OpenAI::UnionOf[OpenAI::Chat::ChatCompletionTool, OpenAI::StructuredOutput::JsonSchemaConverter]
             ]
           }
         )
@@ -618,7 +615,7 @@ module OpenAI
         #   @param safety_identifier [String, nil]
         #     A stable identifier used to help detect users of your application that may be
         #     violating OpenAI's usage policies. The IDs should be a string that uniquely
-        #     identifies each user, with a maximum length of 64 characters. We recommend
+        #     identifies each user, with a maximum length of 128 characters. We recommend
         #     hashing their username or email address, in order to avoid sending us any
         #     identifying information.
         #     [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -688,7 +685,7 @@ module OpenAI
         #     `none` is the default when no tools are present. `auto` is the default if tools
         #     are present.
         #
-        #   @param tools [Array<OpenAI::StructuredOutput::JsonSchemaConverter, OpenAI::Models::Chat::ChatCompletionFunctionTool, OpenAI::Models::Chat::ChatCompletionCustomTool>]
+        #   @param tools [Array<OpenAI::Models::Chat::ChatCompletionFunctionTool, OpenAI::Models::Chat::ChatCompletionCustomTool, OpenAI::StructuredOutput::JsonSchemaConverter>]
         #     A list of tools the model may call. You can provide either
         #     [custom tools](https://developers.openai.com/api/docs/guides/function-calling#custom-tools)
         #     or
@@ -1083,10 +1080,6 @@ module OpenAI
           # Learn more about [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs).
           variant :json_schema, -> { OpenAI::ResponseFormatJSONSchema }
 
-          # An {OpenAI::BaseModel} can be provided and implicitly converted into {OpenAI::Models::ResponseFormatJSONSchema}.
-          # See examples for more details.
-          #
-          # Learn more about [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs).
           variant -> { OpenAI::StructuredOutput::JsonSchemaConverter }
 
           # JSON object response format. An older method of generating JSON responses.

data/lib/openai/models/chat_model.rb

@@ -16,6 +16,9 @@ module OpenAI
       GPT_5_5_2026_04_23 = :"gpt-5.5-2026-04-23"
       GPT_5_4 = :"gpt-5.4"
       GPT_5_4_MINI = :"gpt-5.4-mini"
+      # @deprecated Announced shutdown date: 2027-04-01. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_5_4_NANO = :"gpt-5.4-nano"
       GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
       GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
@@ -31,6 +34,9 @@ module OpenAI
       GPT_5_2_CHAT_LATEST = :"gpt-5.2-chat-latest"
       GPT_5_2_PRO = :"gpt-5.2-pro"
       GPT_5_2_PRO_2025_12_11 = :"gpt-5.2-pro-2025-12-11"
+      # @deprecated Announced shutdown date: 2027-04-01. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_5_1 = :"gpt-5.1"
       GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
       # @deprecated Announced shutdown date: 2026-07-23. See
@@ -77,7 +83,13 @@ module OpenAI
       # https://developers.openai.com/api/docs/deprecations for details and recommended
       # replacements.
       GPT_4_1_NANO = :"gpt-4.1-nano"
+      # @deprecated Announced shutdown date: 2027-01-14. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4_1_2025_04_14 = :"gpt-4.1-2025-04-14"
+      # @deprecated Announced shutdown date: 2027-01-14. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4_1_MINI_2025_04_14 = :"gpt-4.1-mini-2025-04-14"
       # @deprecated Announced shutdown date: 2026-10-23. See
       # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -132,7 +144,13 @@ module OpenAI
       # replacements.
       O1_MINI_2024_09_12 = :"o1-mini-2024-09-12"
       GPT_4O = :"gpt-4o"
+      # @deprecated Announced shutdown date: 2027-01-14. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4O_2024_11_20 = :"gpt-4o-2024-11-20"
+      # @deprecated Announced shutdown date: 2027-01-14. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4O_2024_08_06 = :"gpt-4o-2024-08-06"
       # @deprecated Announced shutdown date: 2026-10-23. See
       # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -195,6 +213,9 @@ module OpenAI
       # replacements.
       CODEX_MINI_LATEST = :"codex-mini-latest"
       GPT_4O_MINI = :"gpt-4o-mini"
+      # @deprecated Announced shutdown date: 2027-01-14. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4O_MINI_2024_07_18 = :"gpt-4o-mini-2024-07-18"
       # @deprecated Announced shutdown date: 2026-10-23. See
       # https://developers.openai.com/api/docs/deprecations for details and recommended

data/lib/openai/models/conversations/conversation_item.rb

@@ -146,6 +146,12 @@ module OpenAI
             nil?: true
           )
 
+          # @!attribute error
+          #   Details of a moderation failure, when available.
+          #
+          #   @return [OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Error, nil]
+          optional :error, -> { OpenAI::Conversations::ConversationItem::ImageGenerationCall::Error }
+
           # @!attribute output_format
           #   The output format used for generation.
           #
@@ -183,7 +189,7 @@ module OpenAI
             nil?: true
           )
 
-          # @!method initialize(id:, result:, status:, action: nil, background: nil, output_format: nil, quality: nil, revised_prompt: nil, size: nil, type: :image_generation_call)
+          # @!method initialize(id:, result:, status:, action: nil, background: nil, error: nil, output_format: nil, quality: nil, revised_prompt: nil, size: nil, type: :image_generation_call)
           #   An image generation request made by the model.
           #
           #   @param id [String]
@@ -201,6 +207,9 @@ module OpenAI
           #   @param background [Symbol, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Background, nil]
           #     The background setting used for generation.
           #
+          #   @param error [OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Error]
+          #     Details of a moderation failure, when available.
+          #
           #   @param output_format [Symbol, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::OutputFormat, nil]
           #     The output format used for generation.
           #
@@ -260,6 +269,103 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
 
+          # @see OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall#error
+          class Error < OpenAI::Internal::Type::BaseModel
+            # @!attribute code
+            #   The error code.
+            #
+            #   @return [String, nil]
+            required :code, String, nil?: true
+
+            # @!attribute message
+            #   A description of the error.
+            #
+            #   @return [String]
+            required :message, String
+
+            # @!attribute param
+            #   The related request parameter.
+            #
+            #   @return [String, nil]
+            required :param, String, nil?: true
+
+            # @!attribute type
+            #   The error type.
+            #
+            #   @return [String]
+            required :type, String
+
+            # @!attribute moderation_details
+            #   Public details for a `moderation_blocked` error, when available.
+            #
+            #   @return [OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Error::ModerationDetails, nil]
+            optional(
+              :moderation_details,
+              -> { OpenAI::Conversations::ConversationItem::ImageGenerationCall::Error::ModerationDetails }
+            )
+
+            # @!method initialize(code:, message:, param:, type:, moderation_details: nil)
+            #   Details of a moderation failure, when available.
+            #
+            #   @param code [String, nil]
+            #     The error code.
+            #
+            #   @param message [String]
+            #     A description of the error.
+            #
+            #   @param param [String, nil]
+            #     The related request parameter.
+            #
+            #   @param type [String]
+            #     The error type.
+            #
+            #   @param moderation_details [OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Error::ModerationDetails]
+            #     Public details for a `moderation_blocked` error, when available.
+
+            # @see OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Error#moderation_details
+            class ModerationDetails < OpenAI::Internal::Type::BaseModel
+              # @!attribute categories
+              #   Public moderation categories. New category values may be added over time.
+              #
+              #   @return [Array<String>]
+              required :categories, OpenAI::Internal::Type::ArrayOf[String]
+
+              # @!attribute moderation_stage
+              #   The stage where moderation blocked the image generation call.
+              #
+              #   @return [Symbol, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Error::ModerationDetails::ModerationStage]
+              required(
+                :moderation_stage,
+                enum: -> {
+                  OpenAI::Conversations::ConversationItem::ImageGenerationCall::Error::ModerationDetails::ModerationStage
+                }
+              )
+
+              # @!method initialize(categories:, moderation_stage:)
+              #   Public details for a `moderation_blocked` error, when available.
+              #
+              #   @param categories [Array<String>]
+              #     Public moderation categories. New category values may be added over time.
+              #
+              #   @param moderation_stage [Symbol, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Error::ModerationDetails::ModerationStage]
+              #     The stage where moderation blocked the image generation call.
+
+              # The stage where moderation blocked the image generation call.
+              #
+              # @see OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Error::ModerationDetails#moderation_stage
+              module ModerationStage
+                extend OpenAI::Internal::Type::Enum
+
+                INPUT = :input
+                OUTPUT = :output
+                UNKNOWN = :unknown
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+
           # The output format used for generation.
           #
           # @see OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall#output_format