openai 0.103.0 → 0.105.0

data/lib/openai/models/decision.rb

@@ -5,24 +5,36 @@ module OpenAI
     # @see OpenAI::Resources::Decisions#create
     class Decision < OpenAI::Internal::Type::BaseModel
       # @!attribute answers
+      #   Answers in question order. Any question can return a refusal instead of an
+      #   answer; other questions can still receive answers. A refusal has
+      #   `type: "refusal"` and the question's `name`, or `null` if it was unnamed.
       #
       #   @return [Array<OpenAI::Models::Decision::Answer::Predicate, OpenAI::Models::Decision::Answer::Choice, OpenAI::Models::Decision::Answer::Score, OpenAI::Models::Decision::Answer::Refusal>]
       required :answers, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Decision::Answer] }
 
       # @!attribute model
+      #   The model used.
       #
       #   @return [String]
       required :model, String
 
       # @!attribute usage
+      #   Token usage for the request.
       #
       #   @return [OpenAI::Models::Decision::Usage]
       required :usage, -> { OpenAI::Decision::Usage }
 
       # @!method initialize(answers:, model:, usage:)
       #   @param answers [Array<OpenAI::Models::Decision::Answer::Predicate, OpenAI::Models::Decision::Answer::Choice, OpenAI::Models::Decision::Answer::Score, OpenAI::Models::Decision::Answer::Refusal>]
+      #     Answers in question order. Any question can return a refusal instead of an
+      #     answer; other questions can still receive answers. A refusal has
+      #     `type: "refusal"` and the question's `name`, or `null` if it was unnamed.
+      #
       #   @param model [String]
+      #     The model used.
+      #
       #   @param usage [OpenAI::Models::Decision::Usage]
+      #     Token usage for the request.
 
       # A completed question always includes its name, including null when unnamed.
       module Answer
@@ -36,7 +48,7 @@ module OpenAI
 
         variant :score, -> { OpenAI::Decision::Answer::Score }
 
-        # The host may decline one question without disclosing its refusal score.
+        # The model declined to answer this question. Other questions in the same request can still receive answers.
         variant :refusal, -> { OpenAI::Decision::Answer::Refusal }
 
         class Predicate < OpenAI::Internal::Type::BaseModel
@@ -234,7 +246,8 @@ module OpenAI
           required :type, const: :refusal
 
           # @!method initialize(name:, type: :refusal)
-          #   The host may decline one question without disclosing its refusal score.
+          #   The model declined to answer this question. Other questions in the same request
+          #   can still receive answers.
           #
           #   @param name [String, nil]
           #
@@ -274,6 +287,8 @@ module OpenAI
         required :total_tokens, Integer
 
         # @!method initialize(input_tokens:, input_tokens_details:, output_tokens:, output_tokens_details:, total_tokens:)
+        #   Token usage for the request.
+        #
         #   @param input_tokens [Integer]
         #   @param input_tokens_details [OpenAI::Models::Decision::Usage::InputTokensDetails]
         #   @param output_tokens [Integer]

data/lib/openai/models/decision_create_params.rb

@@ -8,20 +8,23 @@ module OpenAI
       include OpenAI::Internal::Type::RequestParameters
 
       # @!attribute input
-      #   Shared evidence, as a string or an array of user messages containing text and
-      #   inline images. Non-user roles, function calls, function-call outputs, files,
-      #   audio, and item references are not supported. At most 128 image parts are
-      #   allowed across all messages in one request.
+      #   The text or images to evaluate for every question. Provide a text string or user
+      #   messages containing text and images. Images can be base64 data URLs or publicly
+      #   accessible HTTP(S) URLs; at most 128 images are allowed across all messages in
+      #   one request. Files, audio, tools, and item references are not supported.
       #
       #   @return [String, Array<OpenAI::Models::DecisionInputMessage>]
       required :input, union: -> { OpenAI::DecisionCreateParams::Input }
 
       # @!attribute model
+      #   The model to use. Only `gpt-6-luna` is supported.
       #
       #   @return [String]
       required :model, String
 
       # @!attribute questions
+      #   Ask 1–200 questions about the input. Each question can be a predicate, choice,
+      #   or score. Answers come back in the same order.
       #
       #   @return [Array<OpenAI::Models::DecisionCreateParams::Question::Predicate, OpenAI::Models::DecisionCreateParams::Question::Choice, OpenAI::Models::DecisionCreateParams::Question::Score>]
       required :questions, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::DecisionCreateParams::Question] }
@@ -35,14 +38,17 @@ module OpenAI
 
       # @!method initialize(input:, model:, questions:, safety_identifier: nil, request_options: {})
       #   @param input [String, Array<OpenAI::Models::DecisionInputMessage>]
-      #     Shared evidence, as a string or an array of user messages containing text and
-      #     inline images. Non-user roles, function calls, function-call outputs, files,
-      #     audio, and item references are not supported. At most 128 image parts are
-      #     allowed across all messages in one request.
+      #     The text or images to evaluate for every question. Provide a text string or user
+      #     messages containing text and images. Images can be base64 data URLs or publicly
+      #     accessible HTTP(S) URLs; at most 128 images are allowed across all messages in
+      #     one request. Files, audio, tools, and item references are not supported.
       #
       #   @param model [String]
+      #     The model to use. Only `gpt-6-luna` is supported.
       #
       #   @param questions [Array<OpenAI::Models::DecisionCreateParams::Question::Predicate, OpenAI::Models::DecisionCreateParams::Question::Choice, OpenAI::Models::DecisionCreateParams::Question::Score>]
+      #     Ask 1–200 questions about the input. Each question can be a predicate, choice,
+      #     or score. Answers come back in the same order.
       #
       #   @param safety_identifier [String, nil]
       #     Opaque caller-provided end-user identifier, scoped by the verified org. Match
@@ -50,10 +56,10 @@ module OpenAI
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-      # Shared evidence, as a string or an array of user messages containing text and
-      # inline images. Non-user roles, function calls, function-call outputs, files,
-      # audio, and item references are not supported. At most 128 image parts are
-      # allowed across all messages in one request.
+      # The text or images to evaluate for every question. Provide a text string or user
+      # messages containing text and images. Images can be base64 data URLs or publicly
+      # accessible HTTP(S) URLs; at most 128 images are allowed across all messages in
+      # one request. Files, audio, tools, and item references are not supported.
       module Input
         extend OpenAI::Internal::Type::Union
 
@@ -74,10 +80,13 @@ module OpenAI
 
         discriminator :type
 
+        # Estimate how likely it is that a statement about the input is true.
         variant :predicate, -> { OpenAI::DecisionCreateParams::Question::Predicate }
 
+        # Choose from the supplied options based on the input.
         variant :choice, -> { OpenAI::DecisionCreateParams::Question::Choice }
 
+        # Rate the input against the supplied ordered levels.
         variant :score, -> { OpenAI::DecisionCreateParams::Question::Score }
 
         class Predicate < OpenAI::Internal::Type::BaseModel
@@ -98,6 +107,8 @@ module OpenAI
           optional :name, String
 
           # @!method initialize(instructions:, name: nil, type: :predicate)
+          #   Estimate how likely it is that a statement about the input is true.
+          #
           #   @param instructions [String]
           #
           #   @param name [String]
@@ -108,6 +119,7 @@ module OpenAI
 
         class Choice < OpenAI::Internal::Type::BaseModel
           # @!attribute choices
+          #   Provide between 2 and 255 choices. Each choice must be unique.
           #
           #   @return [Array<OpenAI::Models::DecisionCreateParams::Question::Choice::Choice>]
           required(
@@ -132,7 +144,10 @@ module OpenAI
           optional :name, String
 
           # @!method initialize(choices:, instructions:, name: nil, type: :choice)
+          #   Choose from the supplied options based on the input.
+          #
           #   @param choices [Array<OpenAI::Models::DecisionCreateParams::Question::Choice::Choice>]
+          #     Provide between 2 and 255 choices. Each choice must be unique.
           #
           #   @param instructions [String]
           #
@@ -200,6 +215,8 @@ module OpenAI
           optional :name, String
 
           # @!method initialize(instructions:, levels:, name: nil, type: :score)
+          #   Rate the input against the supplied ordered levels.
+          #
           #   @param instructions [String]
           #
           #   @param levels [Array<OpenAI::Models::DecisionCreateParams::Question::Score::Level>]

data/lib/openai/models/decision_input_image.rb

@@ -4,7 +4,7 @@ module OpenAI
   module Models
     class DecisionInputImage < OpenAI::Internal::Type::BaseModel
       # @!attribute image_url
-      #   A base64-encoded image in a data URL.
+      #   A base64-encoded image in a data URL or a publicly accessible HTTP(S) image URL.
       #
       #   @return [String]
       required :image_url, String
@@ -22,10 +22,11 @@ module OpenAI
       optional :detail, enum: -> { OpenAI::DecisionInputImage::Detail }, nil?: true
 
       # @!method initialize(image_url:, detail: nil, type: :input_image)
-      #   An inline image. External URLs and file IDs are not supported.
+      #   An image provided as a base64 data URL or a publicly accessible HTTP(S) URL.
+      #   File IDs are not supported.
       #
       #   @param image_url [String]
-      #     A base64-encoded image in a data URL.
+      #     A base64-encoded image in a data URL or a publicly accessible HTTP(S) image URL.
       #
       #   @param detail [Symbol, OpenAI::Models::DecisionInputImage::Detail, nil]
       #     The image detail level, using the selected model's image profile. Defaults to

data/lib/openai/models/decision_input_message.rb

@@ -4,7 +4,7 @@ module OpenAI
   module Models
     class DecisionInputMessage < OpenAI::Internal::Type::BaseModel
       # @!attribute content
-      #   Text evidence or an ordered list of text and inline image parts.
+      #   Text evidence or an ordered list of text and image parts.
       #
       #   @return [String, Array<OpenAI::Models::DecisionInputText, OpenAI::Models::DecisionInputImage>]
       required :content, union: -> { OpenAI::DecisionInputMessage::Content }
@@ -20,16 +20,16 @@ module OpenAI
       optional :type, enum: -> { OpenAI::DecisionInputMessage::Type }
 
       # @!method initialize(content:, type: nil, role: :user)
-      #   A user message containing text or inline images.
+      #   A user message containing text or images.
       #
       #   @param content [String, Array<OpenAI::Models::DecisionInputText, OpenAI::Models::DecisionInputImage>]
-      #     Text evidence or an ordered list of text and inline image parts.
+      #     Text evidence or an ordered list of text and image parts.
       #
       #   @param type [Symbol, OpenAI::Models::DecisionInputMessage::Type]
       #
       #   @param role [Symbol, :user]
 
-      # Text evidence or an ordered list of text and inline image parts.
+      # Text evidence or an ordered list of text and image parts.
       #
       # @see OpenAI::Models::DecisionInputMessage#content
       module Content

data/lib/openai/models/decision_input_part.rb

@@ -2,7 +2,8 @@
 
 module OpenAI
   module Models
-    # An inline image. External URLs and file IDs are not supported.
+    # An image provided as a base64 data URL or a publicly accessible HTTP(S) URL.
+    # File IDs are not supported.
     module DecisionInputPart
       extend OpenAI::Internal::Type::Union
 
@@ -10,7 +11,7 @@ module OpenAI
 
       variant :input_text, -> { OpenAI::DecisionInputText }
 
-      # An inline image. External URLs and file IDs are not supported.
+      # An image provided as a base64 data URL or a publicly accessible HTTP(S) URL. File IDs are not supported.
       variant :input_image, -> { OpenAI::DecisionInputImage }
 
       # @!method self.variants

data/lib/openai/models/image_edit_completed_event.rb

@@ -52,7 +52,15 @@ module OpenAI
       #   @return [OpenAI::Models::ImageEditCompletedEvent::Usage]
       required :usage, -> { OpenAI::ImageEditCompletedEvent::Usage }
 
-      # @!method initialize(b64_json:, background:, created_at:, output_format:, quality:, size:, usage:, type: :"image_edit.completed")
+      # @!attribute safety_identifier
+      #   The effective safety identifier used for safety monitoring and abuse detection.
+      #   This is the non-empty `safety_identifier` from the request, or the deprecated
+      #   `user` value when `safety_identifier` is omitted, null, or empty.
+      #
+      #   @return [String, nil]
+      optional :safety_identifier, String, nil?: true
+
+      # @!method initialize(b64_json:, background:, created_at:, output_format:, quality:, size:, usage:, safety_identifier: nil, type: :"image_edit.completed")
       #   Emitted when image editing has completed and the final image is available.
       #
       #   @param b64_json [String]
@@ -77,6 +85,11 @@ module OpenAI
       #     For the GPT image models only, the token usage information for the image
       #     generation.
       #
+      #   @param safety_identifier [String, nil]
+      #     The effective safety identifier used for safety monitoring and abuse detection.
+      #     This is the non-empty `safety_identifier` from the request, or the deprecated
+      #     `user` value when `safety_identifier` is omitted, null, or empty.
+      #
       #   @param type [Symbol, :"image_edit.completed"]
       #     The type of the event. Always `image_edit.completed`.
 
@@ -139,7 +152,6 @@ module OpenAI
 
         variant const: -> { OpenAI::Models::ImageEditCompletedEvent::Size::AUTO }
 
-        # Keep known dimensions as symbols when reading existing API responses.
         variant String
 
         # @!method self.variants
@@ -158,7 +170,7 @@ module OpenAI
 
         # @!endgroup
 
-        # Preserve the enum helper available before custom dimensions were supported.
+        # Preserve the enum helper available before arbitrary strings were supported.
         #
         # @return [Array<Symbol>]
         def self.values = [SIZE_1024X1024, SIZE_1024X1536, SIZE_1536X1024, AUTO]

data/lib/openai/models/image_edit_params.rb

@@ -130,6 +130,17 @@ module OpenAI
       #   @return [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil]
       optional :response_format, enum: -> { OpenAI::ImageEditParams::ResponseFormat }, nil?: true
 
+      # @!attribute safety_identifier
+      #   A stable identifier for an end user in your organization, used for safety
+      #   monitoring and abuse detection. Hash a username or email address to avoid
+      #   sending identifying information. A non-empty value takes precedence over the
+      #   deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+      #   when available.
+      #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+      #
+      #   @return [String, nil]
+      optional :safety_identifier, String, nil?: true
+
       # @!attribute size
       #   The size of the generated images. Defaults to `auto`. For `gpt-image-2`,
       #   `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
@@ -147,14 +158,17 @@ module OpenAI
       optional :size, union: -> { OpenAI::ImageEditParams::Size }, nil?: true
 
       # @!attribute user
-      #   A unique identifier representing your end-user, which can help OpenAI to monitor
-      #   and detect abuse.
+      #   @deprecated
+      #
+      #   Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+      #   backward compatibility and is used when `safety_identifier` is omitted, null, or
+      #   empty.
       #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       #
       #   @return [String, nil]
       optional :user, String
 
-      # @!method initialize(image:, prompt:, background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, user: nil, request_options: {})
+      # @!method initialize(image:, prompt:, background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, user: nil, request_options: {})
       #   @param image [Pathname, StringIO, IO, String, OpenAI::FilePart, Array<Pathname, StringIO, IO, String, OpenAI::FilePart>]
       #     The image(s) to edit. Must be a supported image file or an array of images.
       #
@@ -238,6 +252,14 @@ module OpenAI
       #     Legacy response format parameter for retired image models. Unsupported for GPT
       #     image models, which always return base64-encoded images.
       #
+      #   @param safety_identifier [String, nil]
+      #     A stable identifier for an end user in your organization, used for safety
+      #     monitoring and abuse detection. Hash a username or email address to avoid
+      #     sending identifying information. A non-empty value takes precedence over the
+      #     deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+      #     when available.
+      #     [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+      #
       #   @param size [String, Symbol, OpenAI::Models::ImageEditParams::Size, nil]
       #     The size of the generated images. Defaults to `auto`. For `gpt-image-2`,
       #     `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
@@ -252,8 +274,9 @@ module OpenAI
       #     models that allow automatic sizing.
       #
       #   @param user [String]
-      #     A unique identifier representing your end-user, which can help OpenAI to monitor
-      #     and detect abuse.
+      #     Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+      #     backward compatibility and is used when `safety_identifier` is omitted, null, or
+      #     empty.
       #     [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/image_edit_partial_image_event.rb

@@ -137,7 +137,6 @@ module OpenAI
 
         variant const: -> { OpenAI::Models::ImageEditPartialImageEvent::Size::AUTO }
 
-        # Keep known dimensions as symbols when reading existing API responses.
         variant String
 
         # @!method self.variants
@@ -156,7 +155,7 @@ module OpenAI
 
         # @!endgroup
 
-        # Preserve the enum helper available before custom dimensions were supported.
+        # Preserve the enum helper available before arbitrary strings were supported.
         #
         # @return [Array<Symbol>]
         def self.values = [SIZE_1024X1024, SIZE_1024X1536, SIZE_1536X1024, AUTO]

data/lib/openai/models/image_gen_completed_event.rb

@@ -52,7 +52,15 @@ module OpenAI
       #   @return [OpenAI::Models::ImageGenCompletedEvent::Usage]
       required :usage, -> { OpenAI::ImageGenCompletedEvent::Usage }
 
-      # @!method initialize(b64_json:, background:, created_at:, output_format:, quality:, size:, usage:, type: :"image_generation.completed")
+      # @!attribute safety_identifier
+      #   The effective safety identifier used for safety monitoring and abuse detection.
+      #   This is the non-empty `safety_identifier` from the request, or the deprecated
+      #   `user` value when `safety_identifier` is omitted, null, or empty.
+      #
+      #   @return [String, nil]
+      optional :safety_identifier, String, nil?: true
+
+      # @!method initialize(b64_json:, background:, created_at:, output_format:, quality:, size:, usage:, safety_identifier: nil, type: :"image_generation.completed")
       #   Emitted when image generation has completed and the final image is available.
       #
       #   @param b64_json [String]
@@ -77,6 +85,11 @@ module OpenAI
       #     For the GPT image models only, the token usage information for the image
       #     generation.
       #
+      #   @param safety_identifier [String, nil]
+      #     The effective safety identifier used for safety monitoring and abuse detection.
+      #     This is the non-empty `safety_identifier` from the request, or the deprecated
+      #     `user` value when `safety_identifier` is omitted, null, or empty.
+      #
       #   @param type [Symbol, :"image_generation.completed"]
       #     The type of the event. Always `image_generation.completed`.
 
@@ -139,7 +152,6 @@ module OpenAI
 
         variant const: -> { OpenAI::Models::ImageGenCompletedEvent::Size::AUTO }
 
-        # Keep known dimensions as symbols when reading existing API responses.
         variant String
 
         # @!method self.variants
@@ -158,7 +170,7 @@ module OpenAI
 
         # @!endgroup
 
-        # Preserve the enum helper available before custom dimensions were supported.
+        # Preserve the enum helper available before arbitrary strings were supported.
         #
         # @return [Array<Symbol>]
         def self.values = [SIZE_1024X1024, SIZE_1024X1536, SIZE_1536X1024, AUTO]

data/lib/openai/models/image_gen_partial_image_event.rb

@@ -137,7 +137,6 @@ module OpenAI
 
         variant const: -> { OpenAI::Models::ImageGenPartialImageEvent::Size::AUTO }
 
-        # Keep known dimensions as symbols when reading existing API responses.
         variant String
 
         # @!method self.variants
@@ -156,7 +155,7 @@ module OpenAI
 
         # @!endgroup
 
-        # Preserve the enum helper available before custom dimensions were supported.
+        # Preserve the enum helper available before arbitrary strings were supported.
         #
         # @return [Array<Symbol>]
         def self.values = [SIZE_1024X1024, SIZE_1024X1536, SIZE_1536X1024, AUTO]

data/lib/openai/models/image_generate_params.rb

@@ -101,6 +101,17 @@ module OpenAI
       #   @return [Symbol, OpenAI::Models::ImageGenerateParams::ResponseFormat, nil]
       optional :response_format, enum: -> { OpenAI::ImageGenerateParams::ResponseFormat }, nil?: true
 
+      # @!attribute safety_identifier
+      #   A stable identifier for an end user in your organization, used for safety
+      #   monitoring and abuse detection. Hash a username or email address to avoid
+      #   sending identifying information. A non-empty value takes precedence over the
+      #   deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+      #   when available.
+      #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+      #
+      #   @return [String, nil]
+      optional :safety_identifier, String, nil?: true
+
       # @!attribute size
       #   The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
       #   `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
@@ -126,14 +137,17 @@ module OpenAI
       optional :style, enum: -> { OpenAI::ImageGenerateParams::Style }, nil?: true
 
       # @!attribute user
-      #   A unique identifier representing your end-user, which can help OpenAI to monitor
-      #   and detect abuse.
+      #   @deprecated
+      #
+      #   Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+      #   backward compatibility and is used when `safety_identifier` is omitted, null, or
+      #   empty.
       #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       #
       #   @return [String, nil]
       optional :user, String
 
-      # @!method initialize(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, style: nil, user: nil, request_options: {})
+      # @!method initialize(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, style: nil, user: nil, request_options: {})
       #   @param prompt [String]
       #     A text description of the desired image(s). The maximum length is 32000
       #     characters.
@@ -194,6 +208,14 @@ module OpenAI
       #     Legacy response format parameter for retired image models. Unsupported for GPT
       #     image models, which always return base64-encoded images.
       #
+      #   @param safety_identifier [String, nil]
+      #     A stable identifier for an end user in your organization, used for safety
+      #     monitoring and abuse detection. Hash a username or email address to avoid
+      #     sending identifying information. A non-empty value takes precedence over the
+      #     deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+      #     when available.
+      #     [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+      #
       #   @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, nil]
       #     The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
       #     `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
@@ -211,8 +233,9 @@ module OpenAI
       #     models; describe the desired style in the prompt instead.
       #
       #   @param user [String]
-      #     A unique identifier representing your end-user, which can help OpenAI to monitor
-      #     and detect abuse.
+      #     Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+      #     backward compatibility and is used when `safety_identifier` is omitted, null, or
+      #     empty.
       #     [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/images_response.rb

@@ -36,6 +36,14 @@ module OpenAI
       #   @return [Symbol, OpenAI::Models::ImagesResponse::Quality, nil]
       optional :quality, enum: -> { OpenAI::ImagesResponse::Quality }
 
+      # @!attribute safety_identifier
+      #   The effective safety identifier used for safety monitoring and abuse detection.
+      #   This is the non-empty `safety_identifier` from the request, or the deprecated
+      #   `user` value when `safety_identifier` is omitted, null, or empty.
+      #
+      #   @return [String, nil]
+      optional :safety_identifier, String, nil?: true
+
       # @!attribute size
       #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
@@ -48,7 +56,7 @@ module OpenAI
       #   @return [OpenAI::Models::ImagesResponse::Usage, nil]
       optional :usage, -> { OpenAI::ImagesResponse::Usage }
 
-      # @!method initialize(created:, background: nil, data: nil, output_format: nil, quality: nil, size: nil, usage: nil)
+      # @!method initialize(created:, background: nil, data: nil, output_format: nil, quality: nil, safety_identifier: nil, size: nil, usage: nil)
       #   The response from the image generation endpoint.
       #
       #   @param created [Integer]
@@ -68,6 +76,11 @@ module OpenAI
       #     The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
       #     `max`.
       #
+      #   @param safety_identifier [String, nil]
+      #     The effective safety identifier used for safety monitoring and abuse detection.
+      #     This is the non-empty `safety_identifier` from the request, or the deprecated
+      #     `user` value when `safety_identifier` is omitted, null, or empty.
+      #
       #   @param size [String, Symbol, OpenAI::Models::ImagesResponse::Size]
       #     The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
@@ -131,7 +144,6 @@ module OpenAI
 
         variant const: -> { OpenAI::Models::ImagesResponse::Size::SIZE_1536X1024 }
 
-        # Keep known dimensions as symbols when reading existing API responses.
         variant String
 
         # @!method self.variants
@@ -149,7 +161,7 @@ module OpenAI
 
         # @!endgroup
 
-        # Preserve the enum helper available before custom dimensions were supported.
+        # Preserve the enum helper available before arbitrary strings were supported.
         #
         # @return [Array<Symbol>]
         def self.values = [SIZE_1024X1024, SIZE_1024X1536, SIZE_1536X1024]

data/lib/openai/models/live/built_in_voice.rb

@@ -23,6 +23,7 @@ module OpenAI
         QUARTZ = :quartz
         RIPPLE = :ripple
         SAGE = :sage
+        SHIDA = :shida
         SHIMMER = :shimmer
         STONE = :stone
         TEMPO = :tempo

data/lib/openai/models/live/client_event.rb

@@ -16,7 +16,7 @@ module OpenAI
         # Start a Live session on a primary WebSocket. Send this event before other commands and wait for `session.started`.
         variant :"session.start", -> { OpenAI::Live::SessionStartEvent }
 
-        # Update the delegation settings of an active Live session. The server acknowledges accepted changes with `session.updated`.
+        # Update the delegation settings or transcript triggers of an active Live session. The server acknowledges accepted changes with `session.updated`.
         variant :"session.update", -> { OpenAI::Live::SessionUpdateEvent }
 
         # Send audio to a Live session over its primary WebSocket. WebRTC and SIP sessions send audio over their media transport.
@@ -28,6 +28,9 @@ module OpenAI
         # Resume audio input to a Live model after muting it. The server acknowledges with `session.input_audio.unmuted`.
         variant :"session.input_audio.unmute", -> { OpenAI::Live::InputAudioUnmuteEvent }
 
+        # Play one complete audio fixture through the session output. Send this event over the primary WebSocket or a server sideband. Audio must be raw mono PCM16 little-endian at 24 kHz, regardless of the session audio format, and at most 30 seconds. The entire payload is validated before model speech is interrupted and input is muted. Only one fixture can be active. fixture.playing acknowledges acceptance and fixture.played reports server mixer drain. These notifications are not exact transport-media boundaries. Input arriving during playback is dropped and not replayed.
+        variant :"session.output_audio.fixture.play", -> { OpenAI::Live::OutputAudioFixturePlayEvent }
+
         # Append instructions to the Live conversation while it is running, optionally associating them with an existing client delegation.
         variant :"session.instructions.append", -> { OpenAI::Live::InstructionsAppendEvent }
 
@@ -37,6 +40,15 @@ module OpenAI
         # Provide context the Live model can communicate to the user, optionally for an existing client delegation.
         variant :"session.commentary.append", -> { OpenAI::Live::CommentaryAppendEvent }
 
+        # Evaluate the configured questions using the current conversation and Decision inputs. Reusing an event_id is rejected for the lifetime of the session.
+        variant :"decision.create", -> { OpenAI::Live::DecisionCreateEvent }
+
+        # Append an input item for future decisions without starting an evaluation or changing Live voice context.
+        variant :"decision.item.create", -> { OpenAI::Live::DecisionItemCreateEvent }
+
+        # Delete an input item from future decisions without starting an evaluation or changing Live voice context.
+        variant :"decision.item.delete", -> { OpenAI::Live::DecisionItemDeleteEvent }
+
         # Add an input item to the Live session’s Responses backend. Requires Responses delegation; use `response.create` to request a response.
         variant :"response.item.create", -> { OpenAI::Live::ResponseItemCreateEvent }
 
@@ -47,7 +59,7 @@ module OpenAI
         variant :"session.close", -> { OpenAI::Live::SessionCloseEvent }
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Live::SessionStartEvent, OpenAI::Models::Live::SessionUpdateEvent, OpenAI::Models::Live::InputAudioAppendEvent, OpenAI::Models::Live::InputAudioMuteEvent, OpenAI::Models::Live::InputAudioUnmuteEvent, OpenAI::Models::Live::InstructionsAppendEvent, OpenAI::Models::Live::ThinkingAppendEvent, OpenAI::Models::Live::CommentaryAppendEvent, OpenAI::Models::Live::ResponseItemCreateEvent, OpenAI::Models::Live::ResponseCreateEvent, OpenAI::Models::Live::SessionCloseEvent)]
+        #   @return [Array(OpenAI::Models::Live::SessionStartEvent, OpenAI::Models::Live::SessionUpdateEvent, OpenAI::Models::Live::InputAudioAppendEvent, OpenAI::Models::Live::InputAudioMuteEvent, OpenAI::Models::Live::InputAudioUnmuteEvent, OpenAI::Models::Live::OutputAudioFixturePlayEvent, OpenAI::Models::Live::InstructionsAppendEvent, OpenAI::Models::Live::ThinkingAppendEvent, OpenAI::Models::Live::CommentaryAppendEvent, OpenAI::Models::Live::DecisionCreateEvent, OpenAI::Models::Live::DecisionItemCreateEvent, OpenAI::Models::Live::DecisionItemDeleteEvent, OpenAI::Models::Live::ResponseItemCreateEvent, OpenAI::Models::Live::ResponseCreateEvent, OpenAI::Models::Live::SessionCloseEvent)]
       end
     end
   end

data/lib/openai/models/live/decision_create_event.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class DecisionCreateEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute event_id
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :"decision.create"]
+        required :type, const: :"decision.create"
+
+        # @!method initialize(event_id:, type: :"decision.create")
+        #   Evaluate the configured questions using the current conversation and Decision
+        #   inputs. Reusing an event_id is rejected for the lifetime of the session.
+        #
+        #   @param event_id [String]
+        #   @param type [Symbol, :"decision.create"]
+      end
+    end
+  end
+end