openai 0.87.0 → 0.88.0

data/lib/openai/models/image_gen_completed_event.rb

@@ -53,26 +53,32 @@ module OpenAI
       required :usage, -> { OpenAI::ImageGenCompletedEvent::Usage }
 
       # @!method initialize(b64_json:, background:, created_at:, output_format:, quality:, size:, usage:, type: :"image_generation.completed")
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::ImageGenCompletedEvent} for more details.
-      #
       #   Emitted when image generation has completed and the final image is available.
       #
-      #   @param b64_json [String] Base64-encoded image data, suitable for rendering as an image.
+      #   @param b64_json [String]
+      #     Base64-encoded image data, suitable for rendering as an image.
       #
-      #   @param background [Symbol, OpenAI::Models::ImageGenCompletedEvent::Background] The background setting for the generated image.
+      #   @param background [Symbol, OpenAI::Models::ImageGenCompletedEvent::Background]
+      #     The background setting for the generated image.
       #
-      #   @param created_at [Integer] The Unix timestamp when the event was created.
+      #   @param created_at [Integer]
+      #     The Unix timestamp when the event was created.
       #
-      #   @param output_format [Symbol, OpenAI::Models::ImageGenCompletedEvent::OutputFormat] The output format for the generated image.
+      #   @param output_format [Symbol, OpenAI::Models::ImageGenCompletedEvent::OutputFormat]
+      #     The output format for the generated image.
       #
-      #   @param quality [Symbol, OpenAI::Models::ImageGenCompletedEvent::Quality] The quality setting for the generated image.
+      #   @param quality [Symbol, OpenAI::Models::ImageGenCompletedEvent::Quality]
+      #     The quality setting for the generated image.
       #
-      #   @param size [String, Symbol, OpenAI::Models::ImageGenCompletedEvent::Size] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+      #   @param size [String, Symbol, OpenAI::Models::ImageGenCompletedEvent::Size]
+      #     The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
-      #   @param usage [OpenAI::Models::ImageGenCompletedEvent::Usage] For the GPT image models only, the token usage information for the image generat
+      #   @param usage [OpenAI::Models::ImageGenCompletedEvent::Usage]
+      #     For the GPT image models only, the token usage information for the image
+      #     generation.
       #
-      #   @param type [Symbol, :"image_generation.completed"] The type of the event. Always `image_generation.completed`.
+      #   @param type [Symbol, :"image_generation.completed"]
+      #     The type of the event. Always `image_generation.completed`.
 
       # The background setting for the generated image.
       #
@@ -185,19 +191,20 @@ module OpenAI
         required :total_tokens, Integer
 
         # @!method initialize(input_tokens:, input_tokens_details:, output_tokens:, total_tokens:)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::ImageGenCompletedEvent::Usage} for more details.
-        #
         #   For the GPT image models only, the token usage information for the image
         #   generation.
         #
-        #   @param input_tokens [Integer] The number of tokens (images and text) in the input prompt.
+        #   @param input_tokens [Integer]
+        #     The number of tokens (images and text) in the input prompt.
         #
-        #   @param input_tokens_details [OpenAI::Models::ImageGenCompletedEvent::Usage::InputTokensDetails] The input tokens detailed information for the image generation.
+        #   @param input_tokens_details [OpenAI::Models::ImageGenCompletedEvent::Usage::InputTokensDetails]
+        #     The input tokens detailed information for the image generation.
         #
-        #   @param output_tokens [Integer] The number of image tokens in the output image.
+        #   @param output_tokens [Integer]
+        #     The number of image tokens in the output image.
         #
-        #   @param total_tokens [Integer] The total number of tokens (images and text) used for the image generation.
+        #   @param total_tokens [Integer]
+        #     The total number of tokens (images and text) used for the image generation.
 
         # @see OpenAI::Models::ImageGenCompletedEvent::Usage#input_tokens_details
         class InputTokensDetails < OpenAI::Internal::Type::BaseModel
@@ -216,9 +223,11 @@ module OpenAI
           # @!method initialize(image_tokens:, text_tokens:)
           #   The input tokens detailed information for the image generation.
           #
-          #   @param image_tokens [Integer] The number of image tokens in the input prompt.
+          #   @param image_tokens [Integer]
+          #     The number of image tokens in the input prompt.
           #
-          #   @param text_tokens [Integer] The number of text tokens in the input prompt.
+          #   @param text_tokens [Integer]
+          #     The number of text tokens in the input prompt.
         end
       end
     end

data/lib/openai/models/image_gen_partial_image_event.rb

@@ -52,26 +52,31 @@ module OpenAI
       required :type, const: :"image_generation.partial_image"
 
       # @!method initialize(b64_json:, background:, created_at:, output_format:, partial_image_index:, quality:, size:, type: :"image_generation.partial_image")
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::ImageGenPartialImageEvent} for more details.
-      #
       #   Emitted when a partial image is available during image generation streaming.
       #
-      #   @param b64_json [String] Base64-encoded partial image data, suitable for rendering as an image.
+      #   @param b64_json [String]
+      #     Base64-encoded partial image data, suitable for rendering as an image.
       #
-      #   @param background [Symbol, OpenAI::Models::ImageGenPartialImageEvent::Background] The background setting for the requested image.
+      #   @param background [Symbol, OpenAI::Models::ImageGenPartialImageEvent::Background]
+      #     The background setting for the requested image.
       #
-      #   @param created_at [Integer] The Unix timestamp when the event was created.
+      #   @param created_at [Integer]
+      #     The Unix timestamp when the event was created.
       #
-      #   @param output_format [Symbol, OpenAI::Models::ImageGenPartialImageEvent::OutputFormat] The output format for the requested image.
+      #   @param output_format [Symbol, OpenAI::Models::ImageGenPartialImageEvent::OutputFormat]
+      #     The output format for the requested image.
       #
-      #   @param partial_image_index [Integer] 0-based index for the partial image (streaming).
+      #   @param partial_image_index [Integer]
+      #     0-based index for the partial image (streaming).
       #
-      #   @param quality [Symbol, OpenAI::Models::ImageGenPartialImageEvent::Quality] The quality setting for the requested image.
+      #   @param quality [Symbol, OpenAI::Models::ImageGenPartialImageEvent::Quality]
+      #     The quality setting for the requested image.
       #
-      #   @param size [String, Symbol, OpenAI::Models::ImageGenPartialImageEvent::Size] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+      #   @param size [String, Symbol, OpenAI::Models::ImageGenPartialImageEvent::Size]
+      #     The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
-      #   @param type [Symbol, :"image_generation.partial_image"] The type of the event. Always `image_generation.partial_image`.
+      #   @param type [Symbol, :"image_generation.partial_image"]
+      #     The type of the event. Always `image_generation.partial_image`.
 
       # The background setting for the requested image.
       #

data/lib/openai/models/image_generate_params.rb

@@ -135,40 +135,103 @@ module OpenAI
       # @!attribute user
       #   A unique identifier representing your end-user, which can help OpenAI to monitor
       #   and detect abuse.
-      #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+      #   [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: {})
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::ImageGenerateParams} for more details.
-      #
-      #   @param prompt [String] A text description of the desired image(s). The maximum length is 32000 characte
-      #
-      #   @param background [Symbol, OpenAI::Models::ImageGenerateParams::Background, nil] Allows to set transparency for the background of the generated image(s). Must
-      #
-      #   @param model [String, Symbol, OpenAI::Models::ImageModel, nil] The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT i
-      #
-      #   @param moderation [Symbol, OpenAI::Models::ImageGenerateParams::Moderation, nil] Control the content-moderation level for images generated by the GPT image model
-      #
-      #   @param n [Integer, nil] The number of images to generate. Must be between 1 and 10. For `dall-e-3`, only
-      #
-      #   @param output_compression [Integer, nil] The compression level (0-100%) for the generated images. This parameter is only
-      #
-      #   @param output_format [Symbol, OpenAI::Models::ImageGenerateParams::OutputFormat, nil] The format in which the generated images are returned. This parameter is only su
-      #
-      #   @param partial_images [Integer, nil] The number of partial images to generate. This parameter is used for
-      #
-      #   @param quality [Symbol, OpenAI::Models::ImageGenerateParams::Quality, nil] The quality of the image that will be generated.
-      #
-      #   @param response_format [Symbol, OpenAI::Models::ImageGenerateParams::ResponseFormat, nil] The format in which generated images with `dall-e-2` and `dall-e-3` are returned
-      #
-      #   @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`, `
-      #
-      #   @param style [Symbol, OpenAI::Models::ImageGenerateParams::Style, nil] The style of the generated images. This parameter is only supported for `dall-e-
-      #
-      #   @param user [String] A unique identifier representing your end-user, which can help OpenAI to monitor
+      #   @param prompt [String]
+      #     A text description of the desired image(s). The maximum length is 32000
+      #     characters for the GPT image models, 1000 characters for `dall-e-2` and 4000
+      #     characters for `dall-e-3`.
+      #
+      #   @param background [Symbol, OpenAI::Models::ImageGenerateParams::Background, nil]
+      #     Allows to set transparency for the background of the generated image(s). Must be
+      #     one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
+      #     the model will automatically determine the best background for the image.
+      #
+      #     `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+      #     snapshots, support `opaque` and `transparent` backgrounds. Transparent
+      #     backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+      #     `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+      #     set the output format to `png` or `webp`.
+      #
+      #   @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
+      #     The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
+      #     image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+      #     `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+      #     `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+      #     `gpt-image-2.5-flare-2026-09-08`). Defaults to `dall-e-2` unless a parameter
+      #     specific to the GPT image models is used.
+      #
+      #   @param moderation [Symbol, OpenAI::Models::ImageGenerateParams::Moderation, nil]
+      #     Control the content-moderation level for images generated by the GPT image
+      #     models. Must be either `low` for less restrictive filtering or `auto` (default
+      #     value).
+      #
+      #   @param n [Integer, nil]
+      #     The number of images to generate. Must be between 1 and 10. For `dall-e-3`, only
+      #     `n=1` is supported.
+      #
+      #   @param output_compression [Integer, nil]
+      #     The compression level (0-100%) for the generated images. This parameter is only
+      #     supported for the GPT image models with the `webp` or `jpeg` output formats, and
+      #     defaults to 100.
+      #
+      #   @param output_format [Symbol, OpenAI::Models::ImageGenerateParams::OutputFormat, nil]
+      #     The format in which the generated images are returned. This parameter is only
+      #     supported for the GPT image models. Must be one of `png`, `jpeg`, or `webp`.
+      #
+      #   @param partial_images [Integer, nil]
+      #     The number of partial images to generate. This parameter is used for streaming
+      #     responses that return partial images. Value must be between 0 and 3. When set to
+      #     0, the response will be a single image sent in one streaming event.
+      #
+      #     Note that the final image may be sent before the full number of partial images
+      #     are generated if the full image is generated more quickly.
+      #
+      #   @param quality [Symbol, OpenAI::Models::ImageGenerateParams::Quality, nil]
+      #     The quality of the image that will be generated.
+      #
+      #     - `auto` (default value) will automatically select the best quality for the
+      #       given model.
+      #     - `high`, `medium` and `low` are supported for the GPT image models.
+      #     - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
+      #       `2026-09-08` snapshots, also support `xhigh` and `max`.
+      #     - `hd` and `standard` are supported for `dall-e-3`.
+      #     - `standard` is the only option for `dall-e-2`.
+      #
+      #   @param response_format [Symbol, OpenAI::Models::ImageGenerateParams::ResponseFormat, nil]
+      #     The format in which generated images with `dall-e-2` and `dall-e-3` are
+      #     returned. Must be one of `url` or `b64_json`. URLs are only valid for 60 minutes
+      #     after the image has been generated. This parameter isn't supported for the GPT
+      #     image models, which always return base64-encoded images.
+      #
+      #   @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`,
+      #     `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+      #     resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+      #     Width and height must both be divisible by 16 and the requested aspect ratio
+      #     must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+      #     the maximum supported resolution is `3840x2160`. The requested size must also
+      #     satisfy the model's current pixel and edge limits. The standard sizes
+      #     `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+      #     `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
+      #     one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
+      #     `1024x1024`, `1792x1024`, or `1024x1792`.
+      #
+      #   @param style [Symbol, OpenAI::Models::ImageGenerateParams::Style, nil]
+      #     The style of the generated images. This parameter is only supported for
+      #     `dall-e-3`. Must be one of `vivid` or `natural`. Vivid causes the model to lean
+      #     towards generating hyper-real and dramatic images. Natural causes the model to
+      #     produce more natural, less hyper-real looking images.
+      #
+      #   @param user [String]
+      #     A unique identifier representing your end-user, which can help OpenAI to monitor
+      #     and detect abuse.
+      #     [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_input_reference_param.rb

@@ -17,7 +17,8 @@ module OpenAI
       # @!method initialize(file_id: nil, image_url: nil)
       #   @param file_id [String]
       #
-      #   @param image_url [String] A fully qualified URL or base64-encoded data URL.
+      #   @param image_url [String]
+      #     A fully qualified URL or base64-encoded data URL.
     end
   end
 end

data/lib/openai/models/images_response.rb

@@ -49,24 +49,30 @@ module OpenAI
       optional :usage, -> { OpenAI::ImagesResponse::Usage }
 
       # @!method initialize(created:, background: nil, data: nil, output_format: nil, quality: nil, size: nil, usage: nil)
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::ImagesResponse} for more details.
-      #
       #   The response from the image generation endpoint.
       #
-      #   @param created [Integer] The Unix timestamp (in seconds) of when the image was created.
+      #   @param created [Integer]
+      #     The Unix timestamp (in seconds) of when the image was created.
       #
-      #   @param background [Symbol, OpenAI::Models::ImagesResponse::Background] The background parameter used for the image generation. Either `transparent` or
+      #   @param background [Symbol, OpenAI::Models::ImagesResponse::Background]
+      #     The background parameter used for the image generation. Either `transparent` or
+      #     `opaque`.
       #
-      #   @param data [Array<OpenAI::Models::Image>] The list of generated images.
+      #   @param data [Array<OpenAI::Models::Image>]
+      #     The list of generated images.
       #
-      #   @param output_format [Symbol, OpenAI::Models::ImagesResponse::OutputFormat] The output format of the image generation. Either `png`, `webp`, or `jpeg`.
+      #   @param output_format [Symbol, OpenAI::Models::ImagesResponse::OutputFormat]
+      #     The output format of the image generation. Either `png`, `webp`, or `jpeg`.
       #
-      #   @param quality [Symbol, OpenAI::Models::ImagesResponse::Quality] The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
+      #   @param quality [Symbol, OpenAI::Models::ImagesResponse::Quality]
+      #     The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
+      #     `max`.
       #
-      #   @param size [String, Symbol, OpenAI::Models::ImagesResponse::Size] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+      #   @param size [String, Symbol, OpenAI::Models::ImagesResponse::Size]
+      #     The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
-      #   @param usage [OpenAI::Models::ImagesResponse::Usage] For `gpt-image-1` only, the token usage information for the image generation.
+      #   @param usage [OpenAI::Models::ImagesResponse::Usage]
+      #     For `gpt-image-1` only, the token usage information for the image generation.
 
       # The background parameter used for the image generation. Either `transparent` or
       # `opaque`.
@@ -184,15 +190,20 @@ module OpenAI
         # @!method initialize(input_tokens:, input_tokens_details:, output_tokens:, total_tokens:, output_tokens_details: nil)
         #   For `gpt-image-1` only, the token usage information for the image generation.
         #
-        #   @param input_tokens [Integer] The number of tokens (images and text) in the input prompt.
+        #   @param input_tokens [Integer]
+        #     The number of tokens (images and text) in the input prompt.
         #
-        #   @param input_tokens_details [OpenAI::Models::ImagesResponse::Usage::InputTokensDetails] The input tokens detailed information for the image generation.
+        #   @param input_tokens_details [OpenAI::Models::ImagesResponse::Usage::InputTokensDetails]
+        #     The input tokens detailed information for the image generation.
         #
-        #   @param output_tokens [Integer] The number of output tokens generated by the model.
+        #   @param output_tokens [Integer]
+        #     The number of output tokens generated by the model.
         #
-        #   @param total_tokens [Integer] The total number of tokens (images and text) used for the image generation.
+        #   @param total_tokens [Integer]
+        #     The total number of tokens (images and text) used for the image generation.
         #
-        #   @param output_tokens_details [OpenAI::Models::ImagesResponse::Usage::OutputTokensDetails] The output token details for the image generation.
+        #   @param output_tokens_details [OpenAI::Models::ImagesResponse::Usage::OutputTokensDetails]
+        #     The output token details for the image generation.
 
         # @see OpenAI::Models::ImagesResponse::Usage#input_tokens_details
         class InputTokensDetails < OpenAI::Internal::Type::BaseModel
@@ -211,9 +222,11 @@ module OpenAI
           # @!method initialize(image_tokens:, text_tokens:)
           #   The input tokens detailed information for the image generation.
           #
-          #   @param image_tokens [Integer] The number of image tokens in the input prompt.
+          #   @param image_tokens [Integer]
+          #     The number of image tokens in the input prompt.
           #
-          #   @param text_tokens [Integer] The number of text tokens in the input prompt.
+          #   @param text_tokens [Integer]
+          #     The number of text tokens in the input prompt.
         end
 
         # @see OpenAI::Models::ImagesResponse::Usage#output_tokens_details
@@ -233,9 +246,11 @@ module OpenAI
           # @!method initialize(image_tokens:, text_tokens:)
           #   The output token details for the image generation.
           #
-          #   @param image_tokens [Integer] The number of image output tokens generated by the model.
+          #   @param image_tokens [Integer]
+          #     The number of image output tokens generated by the model.
           #
-          #   @param text_tokens [Integer] The number of text output tokens generated by the model.
+          #   @param text_tokens [Integer]
+          #     The number of text output tokens generated by the model.
         end
       end
     end

data/lib/openai/models/model.rb

@@ -37,15 +37,20 @@ module OpenAI
       # @!method initialize(id:, created:, owned_by:, shutdown_date: nil, object: :model)
       #   Describes an OpenAI model offering that can be used with the API.
       #
-      #   @param id [String] The model identifier, which can be referenced in the API endpoints.
+      #   @param id [String]
+      #     The model identifier, which can be referenced in the API endpoints.
       #
-      #   @param created [Integer] The Unix timestamp (in seconds) when the model was created.
+      #   @param created [Integer]
+      #     The Unix timestamp (in seconds) when the model was created.
       #
-      #   @param owned_by [String] The organization that owns the model.
+      #   @param owned_by [String]
+      #     The organization that owns the model.
       #
-      #   @param shutdown_date [Date, nil] The date when the model will shut down, or null if not announced.
+      #   @param shutdown_date [Date, nil]
+      #     The date when the model will shut down, or null if not announced.
       #
-      #   @param object [Symbol, :model] The object type, which is always "model".
+      #   @param object [Symbol, :model]
+      #     The object type, which is always "model".
     end
   end
 end

data/lib/openai/models/moderation.rb

@@ -28,16 +28,17 @@ module OpenAI
       required :flagged, OpenAI::Internal::Type::Boolean
 
       # @!method initialize(categories:, category_applied_input_types:, category_scores:, flagged:)
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::Moderation} for more details.
+      #   @param categories [OpenAI::Models::Moderation::Categories]
+      #     A list of the categories, and whether they are flagged or not.
       #
-      #   @param categories [OpenAI::Models::Moderation::Categories] A list of the categories, and whether they are flagged or not.
+      #   @param category_applied_input_types [OpenAI::Models::Moderation::CategoryAppliedInputTypes]
+      #     A list of the categories along with the input type(s) that the score applies to.
       #
-      #   @param category_applied_input_types [OpenAI::Models::Moderation::CategoryAppliedInputTypes] A list of the categories along with the input type(s) that the score applies to.
+      #   @param category_scores [OpenAI::Models::Moderation::CategoryScores]
+      #     A list of the categories along with their scores as predicted by model.
       #
-      #   @param category_scores [OpenAI::Models::Moderation::CategoryScores] A list of the categories along with their scores as predicted by model.
-      #
-      #   @param flagged [Boolean] Whether any of the below categories are flagged.
+      #   @param flagged [Boolean]
+      #     Whether any of the below categories are flagged.
 
       # @see OpenAI::Models::Moderation#categories
       class Categories < OpenAI::Internal::Type::BaseModel
@@ -137,36 +138,63 @@ module OpenAI
         required :violence_graphic, OpenAI::Internal::Type::Boolean, api_name: :"violence/graphic"
 
         # @!method initialize(harassment:, harassment_threatening:, hate:, hate_threatening:, illicit:, illicit_violent:, self_harm:, self_harm_instructions:, self_harm_intent:, sexual:, sexual_minors:, violence:, violence_graphic:)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Moderation::Categories} for more details.
-        #
         #   A list of the categories, and whether they are flagged or not.
         #
-        #   @param harassment [Boolean] Content that expresses, incites, or promotes harassing language towards any targ
-        #
-        #   @param harassment_threatening [Boolean] Harassment content that also includes violence or serious harm towards any targe
-        #
-        #   @param hate [Boolean] Content that expresses, incites, or promotes hate based on race, gender, ethnici
-        #
-        #   @param hate_threatening [Boolean] Hateful content that also includes violence or serious harm towards the targeted
-        #
-        #   @param illicit [Boolean, nil] Content that includes instructions or advice that facilitate the planning or exe
-        #
-        #   @param illicit_violent [Boolean, nil] Content that includes instructions or advice that facilitate the planning or exe
-        #
-        #   @param self_harm [Boolean] Content that promotes, encourages, or depicts acts of self-harm, such as suicide
-        #
-        #   @param self_harm_instructions [Boolean] Content that encourages performing acts of self-harm, such as suicide, cutting,
-        #
-        #   @param self_harm_intent [Boolean] Content where the speaker expresses that they are engaging or intend to engage i
-        #
-        #   @param sexual [Boolean] Content meant to arouse sexual excitement, such as the description of sexual act
-        #
-        #   @param sexual_minors [Boolean] Sexual content that includes an individual who is under 18 years old.
-        #
-        #   @param violence [Boolean] Content that depicts death, violence, or physical injury.
-        #
-        #   @param violence_graphic [Boolean] Content that depicts death, violence, or physical injury in graphic detail.
+        #   @param harassment [Boolean]
+        #     Content that expresses, incites, or promotes harassing language towards any
+        #     target.
+        #
+        #   @param harassment_threatening [Boolean]
+        #     Harassment content that also includes violence or serious harm towards any
+        #     target.
+        #
+        #   @param hate [Boolean]
+        #     Content that expresses, incites, or promotes hate based on race, gender,
+        #     ethnicity, religion, nationality, sexual orientation, disability status, or
+        #     caste. Hateful content aimed at non-protected groups (e.g., chess players) is
+        #     harassment.
+        #
+        #   @param hate_threatening [Boolean]
+        #     Hateful content that also includes violence or serious harm towards the targeted
+        #     group based on race, gender, ethnicity, religion, nationality, sexual
+        #     orientation, disability status, or caste.
+        #
+        #   @param illicit [Boolean, nil]
+        #     Content that includes instructions or advice that facilitate the planning or
+        #     execution of wrongdoing, or that gives advice or instruction on how to commit
+        #     illicit acts. For example, "how to shoplift" would fit this category.
+        #
+        #   @param illicit_violent [Boolean, nil]
+        #     Content that includes instructions or advice that facilitate the planning or
+        #     execution of wrongdoing that also includes violence, or that gives advice or
+        #     instruction on the procurement of any weapon.
+        #
+        #   @param self_harm [Boolean]
+        #     Content that promotes, encourages, or depicts acts of self-harm, such as
+        #     suicide, cutting, and eating disorders.
+        #
+        #   @param self_harm_instructions [Boolean]
+        #     Content that encourages performing acts of self-harm, such as suicide, cutting,
+        #     and eating disorders, or that gives instructions or advice on how to commit such
+        #     acts.
+        #
+        #   @param self_harm_intent [Boolean]
+        #     Content where the speaker expresses that they are engaging or intend to engage
+        #     in acts of self-harm, such as suicide, cutting, and eating disorders.
+        #
+        #   @param sexual [Boolean]
+        #     Content meant to arouse sexual excitement, such as the description of sexual
+        #     activity, or that promotes sexual services (excluding sex education and
+        #     wellness).
+        #
+        #   @param sexual_minors [Boolean]
+        #     Sexual content that includes an individual who is under 18 years old.
+        #
+        #   @param violence [Boolean]
+        #     Content that depicts death, violence, or physical injury.
+        #
+        #   @param violence_graphic [Boolean]
+        #     Content that depicts death, violence, or physical injury in graphic detail.
       end
 
       # @see OpenAI::Models::Moderation#category_applied_input_types
@@ -315,32 +343,44 @@ module OpenAI
         # @!method initialize(harassment:, harassment_threatening:, hate:, hate_threatening:, illicit:, illicit_violent:, self_harm:, self_harm_instructions:, self_harm_intent:, sexual:, sexual_minors:, violence:, violence_graphic:)
         #   A list of the categories along with the input type(s) that the score applies to.
         #
-        #   @param harassment [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Harassment>] The applied input type(s) for the category 'harassment'.
+        #   @param harassment [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Harassment>]
+        #     The applied input type(s) for the category 'harassment'.
         #
-        #   @param harassment_threatening [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::HarassmentThreatening>] The applied input type(s) for the category 'harassment/threatening'.
+        #   @param harassment_threatening [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::HarassmentThreatening>]
+        #     The applied input type(s) for the category 'harassment/threatening'.
         #
-        #   @param hate [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Hate>] The applied input type(s) for the category 'hate'.
+        #   @param hate [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Hate>]
+        #     The applied input type(s) for the category 'hate'.
         #
-        #   @param hate_threatening [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::HateThreatening>] The applied input type(s) for the category 'hate/threatening'.
+        #   @param hate_threatening [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::HateThreatening>]
+        #     The applied input type(s) for the category 'hate/threatening'.
         #
-        #   @param illicit [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Illicit>] The applied input type(s) for the category 'illicit'.
+        #   @param illicit [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Illicit>]
+        #     The applied input type(s) for the category 'illicit'.
         #
-        #   @param illicit_violent [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::IllicitViolent>] The applied input type(s) for the category 'illicit/violent'.
+        #   @param illicit_violent [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::IllicitViolent>]
+        #     The applied input type(s) for the category 'illicit/violent'.
         #
-        #   @param self_harm [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarm>] The applied input type(s) for the category 'self-harm'.
+        #   @param self_harm [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarm>]
+        #     The applied input type(s) for the category 'self-harm'.
         #
-        #   @param self_harm_instructions [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarmInstruction>] The applied input type(s) for the category 'self-harm/instructions'.
+        #   @param self_harm_instructions [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarmInstruction>]
+        #     The applied input type(s) for the category 'self-harm/instructions'.
         #
-        #   @param self_harm_intent [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarmIntent>] The applied input type(s) for the category 'self-harm/intent'.
+        #   @param self_harm_intent [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarmIntent>]
+        #     The applied input type(s) for the category 'self-harm/intent'.
         #
-        #   @param sexual [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Sexual>] The applied input type(s) for the category 'sexual'.
+        #   @param sexual [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Sexual>]
+        #     The applied input type(s) for the category 'sexual'.
         #
-        #   @param sexual_minors [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SexualMinor>] The applied input type(s) for the category 'sexual/minors'.
+        #   @param sexual_minors [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SexualMinor>]
+        #     The applied input type(s) for the category 'sexual/minors'.
         #
-        #   @param violence [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Violence>] The applied input type(s) for the category 'violence'.
+        #   @param violence [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Violence>]
+        #     The applied input type(s) for the category 'violence'.
         #
-        #   @param violence_graphic [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::ViolenceGraphic>] The applied input type(s) for the category 'violence/graphic'.
-
+        #   @param violence_graphic [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::ViolenceGraphic>]
+        #     The applied input type(s) for the category 'violence/graphic'.
         module Harassment
           extend OpenAI::Internal::Type::Enum
 
@@ -548,31 +588,44 @@ module OpenAI
         # @!method initialize(harassment:, harassment_threatening:, hate:, hate_threatening:, illicit:, illicit_violent:, self_harm:, self_harm_instructions:, self_harm_intent:, sexual:, sexual_minors:, violence:, violence_graphic:)
         #   A list of the categories along with their scores as predicted by model.
         #
-        #   @param harassment [Float] The score for the category 'harassment'.
+        #   @param harassment [Float]
+        #     The score for the category 'harassment'.
         #
-        #   @param harassment_threatening [Float] The score for the category 'harassment/threatening'.
+        #   @param harassment_threatening [Float]
+        #     The score for the category 'harassment/threatening'.
         #
-        #   @param hate [Float] The score for the category 'hate'.
+        #   @param hate [Float]
+        #     The score for the category 'hate'.
         #
-        #   @param hate_threatening [Float] The score for the category 'hate/threatening'.
+        #   @param hate_threatening [Float]
+        #     The score for the category 'hate/threatening'.
         #
-        #   @param illicit [Float] The score for the category 'illicit'.
+        #   @param illicit [Float]
+        #     The score for the category 'illicit'.
         #
-        #   @param illicit_violent [Float] The score for the category 'illicit/violent'.
+        #   @param illicit_violent [Float]
+        #     The score for the category 'illicit/violent'.
         #
-        #   @param self_harm [Float] The score for the category 'self-harm'.
+        #   @param self_harm [Float]
+        #     The score for the category 'self-harm'.
         #
-        #   @param self_harm_instructions [Float] The score for the category 'self-harm/instructions'.
+        #   @param self_harm_instructions [Float]
+        #     The score for the category 'self-harm/instructions'.
         #
-        #   @param self_harm_intent [Float] The score for the category 'self-harm/intent'.
+        #   @param self_harm_intent [Float]
+        #     The score for the category 'self-harm/intent'.
         #
-        #   @param sexual [Float] The score for the category 'sexual'.
+        #   @param sexual [Float]
+        #     The score for the category 'sexual'.
         #
-        #   @param sexual_minors [Float] The score for the category 'sexual/minors'.
+        #   @param sexual_minors [Float]
+        #     The score for the category 'sexual/minors'.
         #
-        #   @param violence [Float] The score for the category 'violence'.
+        #   @param violence [Float]
+        #     The score for the category 'violence'.
         #
-        #   @param violence_graphic [Float] The score for the category 'violence/graphic'.
+        #   @param violence_graphic [Float]
+        #     The score for the category 'violence/graphic'.
       end
     end
   end