openai 0.102.0 → 0.104.0

data/lib/openai/models/beta/agents/session_list_params.rb

@@ -23,14 +23,13 @@ module OpenAI
           optional :agent_id, String
 
           # @!attribute limit
-          #   The maximum number of resources to return.
+          #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
           #
           #   @return [Integer, nil]
-          optional :limit, Integer, nil?: true
+          optional :limit, Integer
 
           # @!attribute order
-          #   Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          #   `desc` for descending order. Defaults to `desc`.
+          #   The order in which resources are returned. Defaults to `desc`.
           #
           #   @return [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order, nil]
           optional :order, enum: -> { OpenAI::Beta::Agents::SessionListParams::Order }
@@ -43,17 +42,15 @@ module OpenAI
           #     Only return sessions whose root agent has this ID. Omit to return sessions for
           #     all agents.
           #
-          #   @param limit [Integer, nil]
-          #     The maximum number of resources to return.
+          #   @param limit [Integer]
+          #     The maximum number of resources to return, between 1 and 100. Defaults to 20.
           #
           #   @param order [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order]
-          #     Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          #     `desc` for descending order. Defaults to `desc`.
+          #     The order in which resources are returned. Defaults to `desc`.
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-          # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          # `desc` for descending order. Defaults to `desc`.
+          # The order in which resources are returned. Defaults to `desc`.
           module Order
             extend OpenAI::Internal::Type::Enum
 

data/lib/openai/models/beta/agents/session_update_params.rb

@@ -28,7 +28,20 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
-          # @!method initialize(session_id:, agent: nil, metadata: nil, request_options: {})
+          # @!attribute spend_control
+          #   Omit to retain the limit; null or a null limit removes it without resetting
+          #   spend.
+          #
+          #   @return [OpenAI::Models::Beta::Agents::SessionUpdateParams::SpendControl, nil]
+          optional(
+            :spend_control,
+            -> {
+              OpenAI::Beta::Agents::SessionUpdateParams::SpendControl
+            },
+            nil?: true
+          )
+
+          # @!method initialize(session_id:, agent: nil, metadata: nil, spend_control: nil, request_options: {})
           #   @param session_id [String]
           #
           #   @param agent [OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent]
@@ -39,6 +52,10 @@ module OpenAI
           #     Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #     characters.
           #
+          #   @param spend_control [OpenAI::Models::Beta::Agents::SessionUpdateParams::SpendControl, nil]
+          #     Omit to retain the limit; null or a null limit removes it without resetting
+          #     spend.
+          #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
           class Agent < OpenAI::Internal::Type::BaseModel
@@ -138,6 +155,21 @@ module OpenAI
               #   @return [Array<Symbol>]
             end
           end
+
+          class SpendControl < OpenAI::Internal::Type::BaseModel
+            # @!attribute limit
+            #   Positive USD cents, or null to remove the limit.
+            #
+            #   @return [Integer, nil]
+            required :limit, Integer, nil?: true
+
+            # @!method initialize(limit:)
+            #   Omit to retain the limit; null or a null limit removes it without resetting
+            #   spend.
+            #
+            #   @param limit [Integer, nil]
+            #     Positive USD cents, or null to remove the limit.
+          end
         end
       end
     end

data/lib/openai/models/beta/agents/sessions/artifact_list_params.rb

@@ -16,10 +16,10 @@ module OpenAI
             required :session_id, String
 
             # @!attribute after
-            #   Return artifacts after this immutable artifact ID.
+            #   Return resources after this resource ID in the selected order.
             #
             #   @return [String, nil]
-            optional :after, String, nil?: true
+            optional :after, String
 
             # @!attribute environment_id
             #   Restrict the listing to artifacts produced by this environment.
@@ -28,13 +28,13 @@ module OpenAI
             optional :environment_id, String, nil?: true
 
             # @!attribute limit
-            #   The maximum number of artifacts to return, between 1 and 100.
+            #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
             #
             #   @return [Integer, nil]
-            optional :limit, Integer, nil?: true
+            optional :limit, Integer
 
             # @!attribute order
-            #   Sort by creation time and ID. Defaults to descending.
+            #   The order in which resources are returned. Defaults to `desc`.
             #
             #   @return [Symbol, OpenAI::Models::Beta::Agents::Sessions::ArtifactListParams::Order, nil]
             optional :order, enum: -> { OpenAI::Beta::Agents::Sessions::ArtifactListParams::Order }
@@ -42,21 +42,21 @@ module OpenAI
             # @!method initialize(session_id:, after: nil, environment_id: nil, limit: nil, order: nil, request_options: {})
             #   @param session_id [String]
             #
-            #   @param after [String, nil]
-            #     Return artifacts after this immutable artifact ID.
+            #   @param after [String]
+            #     Return resources after this resource ID in the selected order.
             #
             #   @param environment_id [String, nil]
             #     Restrict the listing to artifacts produced by this environment.
             #
-            #   @param limit [Integer, nil]
-            #     The maximum number of artifacts to return, between 1 and 100.
+            #   @param limit [Integer]
+            #     The maximum number of resources to return, between 1 and 100. Defaults to 20.
             #
             #   @param order [Symbol, OpenAI::Models::Beta::Agents::Sessions::ArtifactListParams::Order]
-            #     Sort by creation time and ID. Defaults to descending.
+            #     The order in which resources are returned. Defaults to `desc`.
             #
             #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-            # Sort by creation time and ID. Defaults to descending.
+            # The order in which resources are returned. Defaults to `desc`.
             module Order
               extend OpenAI::Internal::Type::Enum
 

data/lib/openai/models/beta/agents/vault_list_params.rb

@@ -16,15 +16,22 @@ module OpenAI
           optional :after, String
 
           # @!attribute limit
-          #   The maximum number of resources to return. Defaults to 20. Values are clamped
-          #   between 1 and 100.
+          #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
           #
           #   @return [Integer, nil]
-          optional :limit, Integer, nil?: true
+          optional :limit, Integer
+
+          # @!attribute metadata
+          #   Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+          #   match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+          #   characters. Filtering is eventually consistent; metadata changes may take time
+          #   to appear.
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :metadata, OpenAI::Internal::Type::HashOf[String]
 
           # @!attribute order
-          #   Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          #   `desc` for descending order. Defaults to `desc`.
+          #   The order in which resources are returned. Defaults to `desc`.
           #
           #   @return [Symbol, OpenAI::Models::Beta::Agents::VaultListParams::Order, nil]
           optional :order, enum: -> { OpenAI::Beta::Agents::VaultListParams::Order }
@@ -36,17 +43,21 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Beta::Agents::VaultStatus, Array<Symbol, OpenAI::Models::Beta::Agents::VaultStatus>, nil]
           optional :status, union: -> { OpenAI::Beta::Agents::VaultStatusFilter }
 
-          # @!method initialize(after: nil, limit: nil, order: nil, status: nil, request_options: {})
+          # @!method initialize(after: nil, limit: nil, metadata: nil, order: nil, status: nil, request_options: {})
           #   @param after [String]
           #     Return resources after this resource ID in the selected order.
           #
-          #   @param limit [Integer, nil]
-          #     The maximum number of resources to return. Defaults to 20. Values are clamped
-          #     between 1 and 100.
+          #   @param limit [Integer]
+          #     The maximum number of resources to return, between 1 and 100. Defaults to 20.
+          #
+          #   @param metadata [Hash{Symbol=>String}]
+          #     Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+          #     match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+          #     characters. Filtering is eventually consistent; metadata changes may take time
+          #     to appear.
           #
           #   @param order [Symbol, OpenAI::Models::Beta::Agents::VaultListParams::Order]
-          #     Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          #     `desc` for descending order. Defaults to `desc`.
+          #     The order in which resources are returned. Defaults to `desc`.
           #
           #   @param status [Symbol, OpenAI::Models::Beta::Agents::VaultStatus, Array<Symbol, OpenAI::Models::Beta::Agents::VaultStatus>]
           #     Filter by one status or a list, such as `status=active` or
@@ -54,8 +65,7 @@ module OpenAI
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-          # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          # `desc` for descending order. Defaults to `desc`.
+          # The order in which resources are returned. Defaults to `desc`.
           module Order
             extend OpenAI::Internal::Type::Enum
 

data/lib/openai/models/beta/agents/vault_status_filter.rb

@@ -17,9 +17,7 @@ module OpenAI
           #   @return [Array(Symbol, OpenAI::Models::Beta::Agents::VaultStatus, Array<Symbol, OpenAI::Models::Beta::Agents::VaultStatus>)]
 
           # @type [OpenAI::Internal::Type::Converter]
-          VaultStatusArray = OpenAI::Internal::Type::ArrayOf[
-            enum: -> { OpenAI::Models::Beta::Agents::VaultStatus }
-          ]
+          VaultStatusArray = OpenAI::Internal::Type::ArrayOf[enum: -> { OpenAI::Models::Beta::Agents::VaultStatus }]
         end
       end
     end

data/lib/openai/models/beta/agents/vault_update_params.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # @see OpenAI::Resources::Beta::Agents::Vaults#update
+        class VaultUpdateParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute vault_id
+          #
+          #   @return [String]
+          required :vault_id, String
+
+          # @!attribute metadata
+          #   Replaces all metadata. Omit to leave unchanged, or pass {} to clear it. Up to 16
+          #   string key-value pairs, with keys up to 64 and values up to 512 characters.
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :metadata, OpenAI::Internal::Type::HashOf[String]
+
+          # @!attribute name
+          #   A replacement name. Omit to leave unchanged, or pass null to clear it. The name
+          #   is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after trimming.
+          #
+          #   @return [String, nil]
+          optional :name, String, nil?: true
+
+          # @!method initialize(vault_id:, metadata: nil, name: nil, request_options: {})
+          #   @param vault_id [String]
+          #
+          #   @param metadata [Hash{Symbol=>String}]
+          #     Replaces all metadata. Omit to leave unchanged, or pass {} to clear it. Up to 16
+          #     string key-value pairs, with keys up to 64 and values up to 512 characters.
+          #
+          #   @param name [String, nil]
+          #     A replacement name. Omit to leave unchanged, or pass null to clear it. The name
+          #     is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after trimming.
+          #
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vaults/credential_list_params.rb

@@ -22,15 +22,22 @@ module OpenAI
             optional :after, String
 
             # @!attribute limit
-            #   The maximum number of resources to return. Defaults to 20. Values are clamped
-            #   between 1 and 100.
+            #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
             #
             #   @return [Integer, nil]
-            optional :limit, Integer, nil?: true
+            optional :limit, Integer
+
+            # @!attribute metadata
+            #   Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+            #   match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+            #   characters. Filtering is eventually consistent; metadata changes may take time
+            #   to appear.
+            #
+            #   @return [Hash{Symbol=>String}, nil]
+            optional :metadata, OpenAI::Internal::Type::HashOf[String]
 
             # @!attribute order
-            #   Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            #   `desc` for descending order. Defaults to `desc`.
+            #   The order in which resources are returned. Defaults to `desc`.
             #
             #   @return [Symbol, OpenAI::Models::Beta::Agents::Vaults::CredentialListParams::Order, nil]
             optional :order, enum: -> { OpenAI::Beta::Agents::Vaults::CredentialListParams::Order }
@@ -42,19 +49,23 @@ module OpenAI
             #   @return [Symbol, OpenAI::Models::Beta::Agents::VaultStatus, Array<Symbol, OpenAI::Models::Beta::Agents::VaultStatus>, nil]
             optional :status, union: -> { OpenAI::Beta::Agents::VaultStatusFilter }
 
-            # @!method initialize(vault_id:, after: nil, limit: nil, order: nil, status: nil, request_options: {})
+            # @!method initialize(vault_id:, after: nil, limit: nil, metadata: nil, order: nil, status: nil, request_options: {})
             #   @param vault_id [String]
             #
             #   @param after [String]
             #     Return resources after this resource ID in the selected order.
             #
-            #   @param limit [Integer, nil]
-            #     The maximum number of resources to return. Defaults to 20. Values are clamped
-            #     between 1 and 100.
+            #   @param limit [Integer]
+            #     The maximum number of resources to return, between 1 and 100. Defaults to 20.
+            #
+            #   @param metadata [Hash{Symbol=>String}]
+            #     Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+            #     match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+            #     characters. Filtering is eventually consistent; metadata changes may take time
+            #     to appear.
             #
             #   @param order [Symbol, OpenAI::Models::Beta::Agents::Vaults::CredentialListParams::Order]
-            #     Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            #     `desc` for descending order. Defaults to `desc`.
+            #     The order in which resources are returned. Defaults to `desc`.
             #
             #   @param status [Symbol, OpenAI::Models::Beta::Agents::VaultStatus, Array<Symbol, OpenAI::Models::Beta::Agents::VaultStatus>]
             #     Filter by one status or a list, such as `status=active` or
@@ -62,8 +73,7 @@ module OpenAI
             #
             #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            # `desc` for descending order. Defaults to `desc`.
+            # The order in which resources are returned. Defaults to `desc`.
             module Order
               extend OpenAI::Internal::Type::Enum
 

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

@@ -263,7 +263,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).
@@ -522,7 +522,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).
@@ -934,6 +934,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"
@@ -949,6 +952,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
@@ -995,7 +1001,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
@@ -1050,7 +1062,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
@@ -1113,6 +1131,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/beta_response_error.rb

@@ -21,7 +21,19 @@ module OpenAI
         #   @return [OpenAI::Models::Beta::BetaResponseError::Misalignment, nil]
         optional :misalignment, -> { OpenAI::Beta::BetaResponseError::Misalignment }
 
-        # @!method initialize(code:, message:, misalignment: nil)
+        # @!attribute param
+        #   The request parameter associated with the error, or null if none was recorded.
+        #
+        #   @return [String, nil]
+        optional :param, String, nil?: true
+
+        # @!attribute type
+        #   The original error type, or null if it was not recorded.
+        #
+        #   @return [String, nil]
+        optional :type, String, nil?: true
+
+        # @!method initialize(code:, message:, misalignment: nil, param: nil, type: nil)
         #   An error object returned when the model fails to generate a Response.
         #
         #   @param code [Symbol, OpenAI::Models::Beta::BetaResponseError::Code]
@@ -31,6 +43,12 @@ module OpenAI
         #     A human-readable description of the error.
         #
         #   @param misalignment [OpenAI::Models::Beta::BetaResponseError::Misalignment]
+        #
+        #   @param param [String, nil]
+        #     The request parameter associated with the error, or null if none was recorded.
+        #
+        #   @param type [String, nil]
+        #     The original error type, or null if it was not recorded.
 
         # The error code for the response.
         #

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

@@ -1322,6 +1322,12 @@ module OpenAI
             nil?: true
           )
 
+          # @!attribute error
+          #   Details of a moderation failure, when available.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::Error, nil]
+          optional :error, -> { OpenAI::Beta::BetaResponseInputItem::ImageGenerationCall::Error }
+
           # @!attribute output_format
           #   The output format used for generation.
           #
@@ -1361,7 +1367,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]
@@ -1382,6 +1388,9 @@ module OpenAI
           #   @param background [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::Background, nil]
           #     The background setting used for generation.
           #
+          #   @param error [OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::Error]
+          #     Details of a moderation failure, when available.
+          #
           #   @param output_format [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::OutputFormat, nil]
           #     The output format used for generation.
           #
@@ -1456,6 +1465,103 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
 
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::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::BetaResponseInputItem::ImageGenerationCall::Error::ModerationDetails, nil]
+            optional(
+              :moderation_details,
+              -> { OpenAI::Beta::BetaResponseInputItem::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::BetaResponseInputItem::ImageGenerationCall::Error::ModerationDetails]
+            #     Public details for a `moderation_blocked` error, when available.
+
+            # @see OpenAI::Models::Beta::BetaResponseInputItem::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::BetaResponseInputItem::ImageGenerationCall::Error::ModerationDetails::ModerationStage]
+              required(
+                :moderation_stage,
+                enum: -> {
+                  OpenAI::Beta::BetaResponseInputItem::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::BetaResponseInputItem::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::BetaResponseInputItem::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::BetaResponseInputItem::ImageGenerationCall#output_format