openai 0.97.0 → 0.99.0

data/lib/openai/resources/beta/agents/sessions/artifacts.rb

@@ -1,11 +1,19 @@
 # frozen_string_literal: true
 
+require_relative "../../../../helpers/beta/agents/artifacts"
+
 module OpenAI
   module Resources
     class Beta
       class Agents
         class Sessions
           class Artifacts
+            # Access artifacts from exactly this completed turn (beta).
+            # @return [OpenAI::Helpers::Beta::Agents::ResultArtifacts]
+            def for_result(result)
+              OpenAI::Helpers::Beta::Agents::ResultArtifacts.new(artifacts: self, client: @client, result: result)
+            end
+
             # Retrieves immutable metadata for one durable session artifact. See
             # [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).
             #

data/lib/openai/resources/beta/agents/sessions/events.rb

@@ -6,11 +6,12 @@ module OpenAI
       class Agents
         class Sessions
           class Events
-            # Submits message, cancellation, or tool-result events to a managed agent session.
-            # Cancellation can recover a still-open turn whose backend execution has ended by
-            # marking it cancelled and abandoning unpublished outputs. Saved results,
-            # published files, and existing terminal outcomes are preserved. HTTP 202 confirms
-            # acceptance, not durable completion. See
+            # Submits message, cancellation, tool-result, or computer-use approval-response
+            # events to a managed agent session. Cancellation can recover a still-open turn
+            # whose backend execution has ended by marking it cancelled and abandoning
+            # unpublished outputs. Saved results, published files, and existing terminal
+            # outcomes are preserved. HTTP 202 confirms acceptance, not durable completion.
+            # See
             # [session events](https://developers.openai.com/api/docs/guides/agents-api/sessions/events).
             #
             # @overload create(session_id, events:, idempotency_key: nil, request_options: {})

data/lib/openai/resources/beta/agents/sessions/traces.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Traces
+            # Lists published root-turn traces as OTLP JSON, ordered by turn creation time and
+            # ID. Unpublished traces are skipped. Each page returns data available when read;
+            # it does not wait for late traces. Trace reads and the JSON response are limited
+            # to 16 MiB per request. If the limit is exceeded, request fewer traces.
+            #
+            # @overload list(session_id, after: nil, limit: nil, order: nil, request_options: {})
+            #
+            # @param session_id [String]
+            #   The ID of the session.
+            #
+            # @param after [String]
+            #   Return resources after this resource ID in the selected order.
+            #
+            # @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::TraceListParams::Order]
+            #   The order in which resources are returned. Defaults to `desc`.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::Agents::Sessions::SessionTrace>]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::TraceListParams
+            def list(session_id, params = {})
+              parsed, options = OpenAI::Beta::Agents::Sessions::TraceListParams.dump_request(params)
+              query = OpenAI::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: ["agents/sessions/%1$s/traces", session_id],
+                query: query,
+                page: OpenAI::Internal::CursorPage,
+                model: OpenAI::Beta::Agents::Sessions::SessionTrace,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # @api private
+            #
+            # @param client [OpenAI::Client]
+            def initialize(client:)
+              @client = client
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/beta/agents/sessions.rb

@@ -17,6 +17,9 @@ module OpenAI
           # @return [OpenAI::Resources::Beta::Agents::Sessions::Events]
           attr_reader :events
 
+          # @return [OpenAI::Resources::Beta::Agents::Sessions::Traces]
+          attr_reader :traces
+
           # @return [OpenAI::Resources::Beta::Agents::Sessions::Turns]
           attr_reader :turns
 
@@ -82,7 +85,7 @@ module OpenAI
           # the session or streams its events when stream is true. See
           # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
           #
-          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, vault_ids: nil, request_options: {})
+          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, metadata: nil, vault_ids: nil, request_options: {})
           #
           # @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
           #   An inline execution environment or a reference to an environment template.
@@ -108,29 +111,36 @@ module OpenAI
           # @param vault_ids [Array<String>, nil]
           #   The IDs of vaults made available to the session.
           #
+          # @param output_type [Class<OpenAI::BaseModel>, nil] Beta: configure and parse a structured answer.
+          #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentSessionEnvironmentResetEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent>]
+          # @return [OpenAI::Helpers::Beta::Agents::CreationStream]
           #
           # @see OpenAI::Models::Beta::Agents::SessionCreateParams
           def create_streaming(params)
+            params = params.to_h.transform_keys { _1.is_a?(String) ? _1.to_sym : _1 }
+            output_type = params.delete(:output_type)
+            parser = OpenAI::Helpers::Beta::Agents::OutputParser.new(output_type) unless output_type.nil?
             parsed, options = OpenAI::Beta::Agents::SessionCreateParams.dump_request(params)
             unless parsed.fetch(:stream, true)
               message = "Please use `#create` for the non-streaming use case."
               raise ArgumentError.new(message)
             end
 
+            parser&.prepare_request(parsed)
             parsed.store(:stream, true)
-            @client.request(
+            stream = @client.request(
               method: :post,
               path: "agents/sessions",
               headers: {"accept" => "text/event-stream", "accept-encoding" => "identity"},
               body: parsed,
-              stream: OpenAI::Internal::Stream,
+              stream: OpenAI::Helpers::Beta::Agents::CreationStream,
               model: OpenAI::Beta::AgentSessionEvent,
               security: {bearer_auth: true},
               options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
             )
+            stream.configure_output_parser(parser)
           end
 
           # Retrieves the current state of a managed agent session. See
@@ -265,16 +275,18 @@ module OpenAI
           # @param input [String, Array<OpenAI::Models::Beta::AgentSessionInputMessageParam>]
           # @param tool_handlers [Hash{String=>Proc}]
           # @param idempotency_key [String, nil] Applies only to the input submission.
+          # @param output_type [Class<OpenAI::BaseModel>, nil] Beta: parse output without changing session configuration.
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           # @yieldparam stream [OpenAI::Helpers::Agents::SessionStream]
           # @return [OpenAI::Helpers::Agents::SessionStream]
-          def stream(session_id, input:, tool_handlers: {}, idempotency_key: nil, request_options: {})
+          def stream(session_id, input:, tool_handlers: {}, idempotency_key: nil, output_type: nil, request_options: {})
             stream = OpenAI::Helpers::Agents::SessionStream.new(
               sessions: self,
               session_id: session_id,
               input: input,
               tool_handlers: tool_handlers,
               idempotency_key: idempotency_key,
+              output_type: output_type,
               request_options: request_options
             )
             return stream unless block_given?
@@ -297,6 +309,7 @@ module OpenAI
             @artifacts = OpenAI::Resources::Beta::Agents::Sessions::Artifacts.new(client: client)
             @items = OpenAI::Resources::Beta::Agents::Sessions::Items.new(client: client)
             @events = OpenAI::Resources::Beta::Agents::Sessions::Events.new(client: client)
+            @traces = OpenAI::Resources::Beta::Agents::Sessions::Traces.new(client: client)
             @turns = OpenAI::Resources::Beta::Agents::Sessions::Turns.new(client: client)
           end
         end

data/lib/openai/resources/evals/runs.rb

@@ -172,7 +172,7 @@ module OpenAI
 
           @client.request(
             method: :post,
-            path: ["evals/%1$s/runs/%2$s", eval_id, run_id],
+            path: ["evals/%1$s/runs/%2$s/cancel", eval_id, run_id],
             model: OpenAI::Models::Evals::RunCancelResponse,
             security: {bearer_auth: true},
             options: options

data/lib/openai/resources/images.rb

@@ -4,7 +4,11 @@ module OpenAI
   module Resources
     # Given a prompt and/or an input image, the model will generate a new image.
     class Images
-      # Creates a variation of a given image. This endpoint only supports `dall-e-2`.
+      # @deprecated
+      #
+      # This endpoint is retired and no longer available. Use the image edits endpoint
+      # with a GPT Image model and a prompt to create a variation of an image. The
+      # request and response schemas below describe the legacy contract.
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -21,8 +25,8 @@ module OpenAI
       #   content type.
       #
       # @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
-      #   The model to use for image generation. Only `dall-e-2` is supported at this
-      #   time.
+      #   The legacy model used by the retired image variations endpoint. This endpoint no
+      #   longer accepts requests.
       #
       # @param n [Integer, nil]
       #   The number of images to generate. Must be between 1 and 10.
@@ -62,7 +66,7 @@ module OpenAI
       # See {OpenAI::Resources::Images#edit_stream_raw} for streaming counterpart.
       #
       # Creates an edited or extended image given one or more source images and a
-      # prompt. This endpoint supports GPT Image models and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models.
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -80,16 +84,13 @@ module OpenAI
       #   be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
       #   images.
       #
-      #   For `dall-e-2`, you can only provide one image, and it should be a square `png`
-      #   file less than 4MB.
-      #
       #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
       #   content type.
       #
       # @param prompt [String]
-      #   A text description of the desired image(s). The maximum length is 1000
-      #   characters for `dall-e-2`, and 32000 characters for the GPT image models.
+      #   A text description of the desired image(s). The maximum length is 32000
+      #   characters for the GPT image models.
       #
       # @param background [Symbol, OpenAI::Models::ImageEditParams::Background, nil]
       #   Allows to set transparency for the background of the generated image(s). Must be
@@ -118,12 +119,11 @@ module OpenAI
       #   content type.
       #
       # @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
-      #   The model to use for image generation. One of `dall-e-2` 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`, or `chatgpt-image-latest`). Defaults to
-      #   `gpt-image-1.5`.
+      #   The GPT image model to use for image editing (`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`, or
+      #   `chatgpt-image-latest`).
       #
       # @param n [Integer, nil]
       #   The number of images to generate. Must be between 1 and 10.
@@ -153,24 +153,21 @@ module OpenAI
       #   `xhigh` and `max`. Defaults to `auto`.
       #
       # @param response_format [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil]
-      #   The format in which the generated images 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 is only supported for `dall-e-2` (default is `url` for
-      #   `dall-e-2`), as GPT image models always return base64-encoded images.
+      #   Legacy response format parameter for retired image models. Unsupported for GPT
+      #   image models, which always return base64-encoded images.
       #
       # @param size [String, Symbol, OpenAI::Models::ImageEditParams::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`.
+      #   The size of the generated images. Defaults to `auto`. 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.
       #
       # @param user [String]
       #   A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -203,7 +200,7 @@ module OpenAI
       # See {OpenAI::Resources::Images#edit} for non-streaming counterpart.
       #
       # Creates an edited or extended image given one or more source images and a
-      # prompt. This endpoint supports GPT Image models and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models.
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -221,16 +218,13 @@ module OpenAI
       #   be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
       #   images.
       #
-      #   For `dall-e-2`, you can only provide one image, and it should be a square `png`
-      #   file less than 4MB.
-      #
       #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
       #   content type.
       #
       # @param prompt [String]
-      #   A text description of the desired image(s). The maximum length is 1000
-      #   characters for `dall-e-2`, and 32000 characters for the GPT image models.
+      #   A text description of the desired image(s). The maximum length is 32000
+      #   characters for the GPT image models.
       #
       # @param background [Symbol, OpenAI::Models::ImageEditParams::Background, nil]
       #   Allows to set transparency for the background of the generated image(s). Must be
@@ -259,12 +253,11 @@ module OpenAI
       #   content type.
       #
       # @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
-      #   The model to use for image generation. One of `dall-e-2` 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`, or `chatgpt-image-latest`). Defaults to
-      #   `gpt-image-1.5`.
+      #   The GPT image model to use for image editing (`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`, or
+      #   `chatgpt-image-latest`).
       #
       # @param n [Integer, nil]
       #   The number of images to generate. Must be between 1 and 10.
@@ -294,24 +287,21 @@ module OpenAI
       #   `xhigh` and `max`. Defaults to `auto`.
       #
       # @param response_format [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil]
-      #   The format in which the generated images 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 is only supported for `dall-e-2` (default is `url` for
-      #   `dall-e-2`), as GPT image models always return base64-encoded images.
+      #   Legacy response format parameter for retired image models. Unsupported for GPT
+      #   image models, which always return base64-encoded images.
       #
       # @param size [String, Symbol, OpenAI::Models::ImageEditParams::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`.
+      #   The size of the generated images. Defaults to `auto`. 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.
       #
       # @param user [String]
       #   A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -349,15 +339,14 @@ module OpenAI
 
       # See {OpenAI::Resources::Images#generate_stream_raw} for streaming counterpart.
       #
-      # Creates an image given a prompt.
+      # Creates an image given a prompt using a GPT Image model.
       # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       #
       # @overload generate(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: {})
       #
       # @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`.
+      #   characters.
       #
       # @param background [Symbol, OpenAI::Models::ImageGenerateParams::Background, nil]
       #   Allows to set transparency for the background of the generated image(s). Must be
@@ -371,12 +360,11 @@ module OpenAI
       #   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`,
+      #   The GPT image model to use for image generation. Specify a model explicitly.
+      #   Supported models include `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.
+      #   `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`.
       #
       # @param moderation [Symbol, OpenAI::Models::ImageGenerateParams::Moderation, nil]
       #   Control the content-moderation level for images generated by the GPT image
@@ -384,8 +372,7 @@ module OpenAI
       #   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.
+      #   The number of images to generate. Must be between 1 and 10.
       #
       # @param output_compression [Integer, nil]
       #   The compression level (0-100%) for the generated images. This parameter is only
@@ -412,13 +399,9 @@ module OpenAI
       #   - `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
+      #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
       # @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, nil]
@@ -431,15 +414,11 @@ module OpenAI
       #   the maximum supported resolution is `3840x2160`. The requested size must also
       #   satisfy the model's current pixel and edge limits. The standard sizes
       #   `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-      #   `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-      #   one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-      #   `1024x1024`, `1792x1024`, or `1024x1792`.
+      #   `auto` is supported for models that allow automatic sizing.
       #
       # @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.
+      #   Legacy style parameter for retired image models. Unsupported for GPT image
+      #   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
@@ -470,15 +449,14 @@ module OpenAI
 
       # See {OpenAI::Resources::Images#generate} for non-streaming counterpart.
       #
-      # Creates an image given a prompt.
+      # Creates an image given a prompt using a GPT Image model.
       # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       #
       # @overload generate_stream_raw(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: {})
       #
       # @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`.
+      #   characters.
       #
       # @param background [Symbol, OpenAI::Models::ImageGenerateParams::Background, nil]
       #   Allows to set transparency for the background of the generated image(s). Must be
@@ -492,12 +470,11 @@ module OpenAI
       #   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`,
+      #   The GPT image model to use for image generation. Specify a model explicitly.
+      #   Supported models include `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.
+      #   `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`.
       #
       # @param moderation [Symbol, OpenAI::Models::ImageGenerateParams::Moderation, nil]
       #   Control the content-moderation level for images generated by the GPT image
@@ -505,8 +482,7 @@ module OpenAI
       #   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.
+      #   The number of images to generate. Must be between 1 and 10.
       #
       # @param output_compression [Integer, nil]
       #   The compression level (0-100%) for the generated images. This parameter is only
@@ -533,13 +509,9 @@ module OpenAI
       #   - `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
+      #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
       # @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, nil]
@@ -552,15 +524,11 @@ module OpenAI
       #   the maximum supported resolution is `3840x2160`. The requested size must also
       #   satisfy the model's current pixel and edge limits. The standard sizes
       #   `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-      #   `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-      #   one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-      #   `1024x1024`, `1792x1024`, or `1024x1792`.
+      #   `auto` is supported for models that allow automatic sizing.
       #
       # @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.
+      #   Legacy style parameter for retired image models. Unsupported for GPT image
+      #   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

data/lib/openai/resources/realtime/translations/client_secrets.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Realtime
+      class Translations
+        class ClientSecrets
+          # Create a Realtime translation client secret with an associated translation
+          # session configuration.
+          #
+          # Client secrets are short-lived tokens that can be passed to a client app, such
+          # as a web frontend or mobile client, which grants access to the Realtime
+          # Translation API without leaking your main API key. You can configure a custom
+          # TTL for each client secret.
+          #
+          # Returns the created client secret and the effective translation session object.
+          # The client secret is a string that looks like `ek_1234`.
+          #
+          # @overload create(session:, expires_after: nil, request_options: {})
+          #
+          # @param session [OpenAI::Models::Realtime::RealtimeTranslationSessionCreateRequest]
+          #   Realtime translation session configuration. Translation sessions stream source
+          #   audio in and translated audio plus transcript deltas out continuously.
+          #
+          # @param expires_after [OpenAI::Models::Realtime::RealtimeTranslationClientSecretCreateRequest::ExpiresAfter]
+          #   Configuration for the client secret expiration. Expiration refers to the time
+          #   after which a client secret will no longer be valid for creating sessions. The
+          #   session itself may continue after that time once started. A secret can be used
+          #   to create multiple sessions until it expires.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Realtime::RealtimeTranslationClientSecretCreateResponse]
+          #
+          # @see OpenAI::Models::Realtime::Translations::ClientSecretCreateParams
+          def create(params)
+            parsed, options = OpenAI::Realtime::Translations::ClientSecretCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "realtime/translations/client_secrets",
+              body: parsed,
+              model: OpenAI::Realtime::RealtimeTranslationClientSecretCreateResponse,
+              security: {bearer_auth: true},
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [OpenAI::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/realtime/translations.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Realtime
+      class Translations
+        # @return [OpenAI::Resources::Realtime::Translations::ClientSecrets]
+        attr_reader :client_secrets
+
+        # @api private
+        #
+        # @param client [OpenAI::Client]
+        def initialize(client:)
+          @client = client
+          @client_secrets = OpenAI::Resources::Realtime::Translations::ClientSecrets.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/realtime.rb

@@ -9,6 +9,9 @@ module OpenAI
       # @return [OpenAI::Resources::Realtime::Calls]
       attr_reader :calls
 
+      # @return [OpenAI::Resources::Realtime::Translations]
+      attr_reader :translations
+
       # @api private
       #
       # @param client [OpenAI::Client]
@@ -16,6 +19,7 @@ module OpenAI
         @client = client
         @client_secrets = OpenAI::Resources::Realtime::ClientSecrets.new(client: client)
         @calls = OpenAI::Resources::Realtime::Calls.new(client: client)
+        @translations = OpenAI::Resources::Realtime::Translations.new(client: client)
       end
     end
   end