openai 0.117.0 → 0.119.0

data/lib/openai/resources/images.rb

@@ -72,7 +72,7 @@ module OpenAI
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
       # content type.
       #
-      # @overload edit(image:, prompt:, background: nil, input_fidelity: nil, markup: 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: {})
+      # @overload edit(image:, prompt:, background: nil, complexity: nil, frame_count: nil, frame_duration_ms: nil, input_fidelity: nil, markup: 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.
@@ -103,6 +103,23 @@ module OpenAI
       #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
       #   set the output format to `png` or `webp`.
       #
+      # @param complexity [Symbol, OpenAI::Models::ImageEditParams::Complexity, nil]
+      #   Computation spent planning the image, independently of rendering quality. Uses
+      #   the image model's configured default when omitted. For SVG output, controls the
+      #   reference image, independently of the SVG author's reasoning.
+      #
+      # @param frame_count [Integer, nil]
+      #   Number of frames for GIF output. Accepts integers from 2 through 16. Defaults to
+      #   9 when omitted. Only supported with output_format=gif. The requested size must
+      #   satisfy the selected model's GIF size limits. GIF output does not support
+      #   streaming, partial images, masks, or custom output compression. Requires access
+      #   to the GIF preview for the selected model.
+      #
+      # @param frame_duration_ms [Integer, nil]
+      #   Requested delay per GIF frame, in milliseconds. Defaults to 200 when omitted.
+      #   GIF output rounds to the nearest 10 ms and caps the encoded delay at 655,350 ms
+      #   per frame. Only supported with output_format=gif.
+      #
       # @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
       #   Control how much effort the model will exert to match the style and features,
       #   especially facial features, of input images. Supports `high` and `low` on
@@ -112,7 +129,7 @@ module OpenAI
       # @param markup [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #   A transparent PNG overlaid on the first image to guide the edit. Must match that
       #   image's dimensions after orientation and contain transparent pixels. Supports
-      #   GPT Image 2.5 and 2.6. Cannot be combined with mask.
+      #   GPT Image 2.5. Cannot be combined with mask.
       #
       #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -132,8 +149,8 @@ module OpenAI
       #   The GPT image model to use for image editing (`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`).
+      #   `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`,
+      #   `gpt-image-2.6-sunburst`, `gpt-image-2.6-flare`, or `chatgpt-image-latest`).
       #
       #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
       #   `gpt-image-2.5-flare` instead.
@@ -148,8 +165,7 @@ module OpenAI
       #
       # @param output_format [Symbol, OpenAI::Models::ImageEditParams::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`. The
-      #   default value is `png`.
+      #   supported for the GPT image models. The default value is `png`.
       #
       # @param partial_images [Integer, nil]
       #   The number of partial images to generate. This parameter is used for streaming
@@ -229,7 +245,7 @@ module OpenAI
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
       # content type.
       #
-      # @overload edit_stream_raw(image:, prompt:, background: nil, input_fidelity: nil, markup: 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: {})
+      # @overload edit_stream_raw(image:, prompt:, background: nil, complexity: nil, frame_count: nil, frame_duration_ms: nil, input_fidelity: nil, markup: 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.
@@ -260,6 +276,23 @@ module OpenAI
       #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
       #   set the output format to `png` or `webp`.
       #
+      # @param complexity [Symbol, OpenAI::Models::ImageEditParams::Complexity, nil]
+      #   Computation spent planning the image, independently of rendering quality. Uses
+      #   the image model's configured default when omitted. For SVG output, controls the
+      #   reference image, independently of the SVG author's reasoning.
+      #
+      # @param frame_count [Integer, nil]
+      #   Number of frames for GIF output. Accepts integers from 2 through 16. Defaults to
+      #   9 when omitted. Only supported with output_format=gif. The requested size must
+      #   satisfy the selected model's GIF size limits. GIF output does not support
+      #   streaming, partial images, masks, or custom output compression. Requires access
+      #   to the GIF preview for the selected model.
+      #
+      # @param frame_duration_ms [Integer, nil]
+      #   Requested delay per GIF frame, in milliseconds. Defaults to 200 when omitted.
+      #   GIF output rounds to the nearest 10 ms and caps the encoded delay at 655,350 ms
+      #   per frame. Only supported with output_format=gif.
+      #
       # @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
       #   Control how much effort the model will exert to match the style and features,
       #   especially facial features, of input images. Supports `high` and `low` on
@@ -269,7 +302,7 @@ module OpenAI
       # @param markup [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #   A transparent PNG overlaid on the first image to guide the edit. Must match that
       #   image's dimensions after orientation and contain transparent pixels. Supports
-      #   GPT Image 2.5 and 2.6. Cannot be combined with mask.
+      #   GPT Image 2.5. Cannot be combined with mask.
       #
       #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -289,8 +322,8 @@ module OpenAI
       #   The GPT image model to use for image editing (`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`).
+      #   `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`,
+      #   `gpt-image-2.6-sunburst`, `gpt-image-2.6-flare`, or `chatgpt-image-latest`).
       #
       #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
       #   `gpt-image-2.5-flare` instead.
@@ -305,8 +338,7 @@ module OpenAI
       #
       # @param output_format [Symbol, OpenAI::Models::ImageEditParams::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`. The
-      #   default value is `png`.
+      #   supported for the GPT image models. The default value is `png`.
       #
       # @param partial_images [Integer, nil]
       #   The number of partial images to generate. This parameter is used for streaming
@@ -388,7 +420,7 @@ module OpenAI
       # 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, safety_identifier: nil, size: nil, style: nil, user: nil, request_options: {})
+      # @overload generate(prompt:, background: nil, complexity: nil, frame_count: nil, frame_duration_ms: 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, svg: nil, user: nil, request_options: {})
       #
       # @param prompt [String]
       #   A text description of the desired image(s). The maximum length is 32000
@@ -405,12 +437,30 @@ module OpenAI
       #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
       #   set the output format to `png` or `webp`.
       #
+      # @param complexity [Symbol, OpenAI::Models::ImageGenerateParams::Complexity, nil]
+      #   Computation spent planning the image, independently of rendering quality. Uses
+      #   the image model's configured default when omitted. For SVG output, controls the
+      #   reference image, independently of the SVG author's reasoning.
+      #
+      # @param frame_count [Integer, nil]
+      #   Number of frames for GIF output. Accepts integers from 2 through 16. Defaults to
+      #   9 when omitted. Only supported with output_format=gif. The requested size must
+      #   satisfy the selected model's GIF size limits. GIF output does not support
+      #   streaming, partial images, masks, or custom output compression. Requires access
+      #   to the GIF preview for the selected model.
+      #
+      # @param frame_duration_ms [Integer, nil]
+      #   Requested delay per GIF frame, in milliseconds. Defaults to 200 when omitted.
+      #   GIF output rounds to the nearest 10 ms and caps the encoded delay at 655,350 ms
+      #   per frame. Only supported with output_format=gif.
+      #
       # @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
       #   The GPT image model to use for image generation. Specify a model explicitly.
       #   Supported models include `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`, and `chatgpt-image-latest`.
+      #   `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
+      #   `gpt-image-2.6-flare`, and `chatgpt-image-latest`.
       #
       #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
       #   `gpt-image-2.5-flare` instead.
@@ -430,7 +480,7 @@ module OpenAI
       #
       # @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`.
+      #   supported for the GPT image models.
       #
       # @param partial_images [Integer, nil]
       #   The number of partial images to generate. This parameter is used for streaming
@@ -477,6 +527,14 @@ module OpenAI
       #   Legacy style parameter for retired image models. Unsupported for GPT image
       #   models; describe the desired style in the prompt instead.
       #
+      # @param svg [OpenAI::Models::ImageGenerateParams::Svg, nil]
+      #   Selects the model and reasoning effort used to author SVG output. Requires
+      #   output_format=svg and access to SVG model selection. When model selection is
+      #   enabled, supply svg.model. When model selection is disabled, omit this object.
+      #   The top-level model selects the image model that creates the reference image.
+      #   SVG generation requires n=1 and does not support streaming, partial images,
+      #   prompt_rewriter, or output_compression. SVG edits are not supported.
+      #
       # @param user [String]
       #   Deprecated: use `safety_identifier` instead. This parameter remains accepted for
       #   backward compatibility and is used when `safety_identifier` is omitted, null, or
@@ -510,7 +568,7 @@ module OpenAI
       # 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, safety_identifier: nil, size: nil, style: nil, user: nil, request_options: {})
+      # @overload generate_stream_raw(prompt:, background: nil, complexity: nil, frame_count: nil, frame_duration_ms: 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, svg: nil, user: nil, request_options: {})
       #
       # @param prompt [String]
       #   A text description of the desired image(s). The maximum length is 32000
@@ -527,12 +585,30 @@ module OpenAI
       #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
       #   set the output format to `png` or `webp`.
       #
+      # @param complexity [Symbol, OpenAI::Models::ImageGenerateParams::Complexity, nil]
+      #   Computation spent planning the image, independently of rendering quality. Uses
+      #   the image model's configured default when omitted. For SVG output, controls the
+      #   reference image, independently of the SVG author's reasoning.
+      #
+      # @param frame_count [Integer, nil]
+      #   Number of frames for GIF output. Accepts integers from 2 through 16. Defaults to
+      #   9 when omitted. Only supported with output_format=gif. The requested size must
+      #   satisfy the selected model's GIF size limits. GIF output does not support
+      #   streaming, partial images, masks, or custom output compression. Requires access
+      #   to the GIF preview for the selected model.
+      #
+      # @param frame_duration_ms [Integer, nil]
+      #   Requested delay per GIF frame, in milliseconds. Defaults to 200 when omitted.
+      #   GIF output rounds to the nearest 10 ms and caps the encoded delay at 655,350 ms
+      #   per frame. Only supported with output_format=gif.
+      #
       # @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
       #   The GPT image model to use for image generation. Specify a model explicitly.
       #   Supported models include `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`, and `chatgpt-image-latest`.
+      #   `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
+      #   `gpt-image-2.6-flare`, and `chatgpt-image-latest`.
       #
       #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
       #   `gpt-image-2.5-flare` instead.
@@ -552,7 +628,7 @@ module OpenAI
       #
       # @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`.
+      #   supported for the GPT image models.
       #
       # @param partial_images [Integer, nil]
       #   The number of partial images to generate. This parameter is used for streaming
@@ -599,6 +675,14 @@ module OpenAI
       #   Legacy style parameter for retired image models. Unsupported for GPT image
       #   models; describe the desired style in the prompt instead.
       #
+      # @param svg [OpenAI::Models::ImageGenerateParams::Svg, nil]
+      #   Selects the model and reasoning effort used to author SVG output. Requires
+      #   output_format=svg and access to SVG model selection. When model selection is
+      #   enabled, supply svg.model. When model selection is disabled, omit this object.
+      #   The top-level model selects the image model that creates the reference image.
+      #   SVG generation requires n=1 and does not support streaming, partial images,
+      #   prompt_rewriter, or output_compression. SVG edits are not supported.
+      #
       # @param user [String]
       #   Deprecated: use `safety_identifier` instead. This parameter remains accepted for
       #   backward compatibility and is used when `safety_identifier` is omitted, null, or

data/lib/openai/resources/responses.rb

@@ -47,7 +47,7 @@ module OpenAI
       # [file search](https://developers.openai.com/api/docs/guides/tools-file-search)
       # to use your own data as input for the model's response.
       #
-      # @overload create(access_programs: nil, background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
+      # @overload create(access_programs: nil, background: nil, context_management: nil, conversation: nil, image: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
       #
       # @param access_programs [OpenAI::Models::Responses::ResponseCreateParams::AccessPrograms]
       #   Domain-specific access programs to use for this request.
@@ -65,6 +65,9 @@ module OpenAI
       #   items from this response are automatically added to this conversation after this
       #   response completes.
       #
+      # @param image [OpenAI::Models::Responses::ResponseCreateParams::Image]
+      #   Request level image options.
+      #
       # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>, nil]
       #   Specify additional output data to include in the model response. Currently
       #   supported values are:
@@ -157,7 +160,7 @@ module OpenAI
       #   request can write up to four breakpoints. For cache matching, OpenAI considers
       #   up to the latest 80 breakpoints in the conversation, without a content-block
       #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-      #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+      #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
       #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
       #   for current details.
       #
@@ -340,7 +343,7 @@ module OpenAI
       # [file search](https://developers.openai.com/api/docs/guides/tools-file-search)
       # to use your own data as input for the model's response.
       #
-      # @overload stream_raw(access_programs: nil, background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
+      # @overload stream_raw(access_programs: nil, background: nil, context_management: nil, conversation: nil, image: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
       #
       # @param access_programs [OpenAI::Models::Responses::ResponseCreateParams::AccessPrograms]
       #   Domain-specific access programs to use for this request.
@@ -358,6 +361,9 @@ module OpenAI
       #   items from this response are automatically added to this conversation after this
       #   response completes.
       #
+      # @param image [OpenAI::Models::Responses::ResponseCreateParams::Image]
+      #   Request level image options.
+      #
       # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>, nil]
       #   Specify additional output data to include in the model response. Currently
       #   supported values are:
@@ -450,7 +456,7 @@ module OpenAI
       #   request can write up to four breakpoints. For cache matching, OpenAI considers
       #   up to the latest 80 breakpoints in the conversation, without a content-block
       #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-      #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+      #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
       #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
       #   for current details.
       #
@@ -785,7 +791,7 @@ module OpenAI
       # For ZDR-compatible compaction details, see
       # [Compaction (advanced)](https://developers.openai.com/api/docs/guides/conversation-state#compaction-advanced).
       #
-      # @overload compact(model:, input: nil, instructions: nil, previous_response_id: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, service_tier: nil, request_options: {})
+      # @overload compact(model:, image: nil, input: nil, instructions: nil, previous_response_id: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, service_tier: nil, request_options: {})
       #
       # @param model [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil]
       #   Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
@@ -794,6 +800,9 @@ module OpenAI
       #   [model guide](https://developers.openai.com/api/docs/models) to browse and
       #   compare available models.
       #
+      # @param image [OpenAI::Models::Responses::ResponseCompactParams::Image]
+      #   Request level image options.
+      #
       # @param input [String, Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference, OpenAI::Models::Responses::ResponseInputItem::Program, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput>, nil]
       #   Text, image, or file inputs to the model, used to generate a response
       #
@@ -819,7 +828,7 @@ module OpenAI
       #   request can write up to four breakpoints. For cache matching, OpenAI considers
       #   up to the latest 80 breakpoints in the conversation, without a content-block
       #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-      #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+      #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
       #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
       #   for current details.
       #

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.117.0"
+  VERSION = "0.119.0"
 end

data/lib/openai.rb

@@ -349,8 +349,10 @@ require_relative "openai/models/admin/organization/projects/project_group"
 require_relative "openai/models/admin/organization/projects/project_hosted_tool_permissions"
 require_relative "openai/models/admin/organization/projects/project_model_permissions"
 require_relative "openai/models/admin/organization/projects/project_model_permissions_deleted"
+require_relative "openai/models/admin/organization/projects/project_optional_service_tier"
 require_relative "openai/models/admin/organization/projects/project_rate_limit"
 require_relative "openai/models/admin/organization/projects/project_service_account"
+require_relative "openai/models/admin/organization/projects/project_service_tier_settings"
 require_relative "openai/models/admin/organization/projects/project_spend_alert"
 require_relative "openai/models/admin/organization/projects/project_spend_alert_deleted"
 require_relative "openai/models/admin/organization/projects/project_spend_limit"
@@ -373,6 +375,8 @@ require_relative "openai/models/admin/organization/projects/service_account_retr
 require_relative "openai/models/admin/organization/projects/service_accounts/api_key_create_params"
 require_relative "openai/models/admin/organization/projects/service_accounts/api_key_create_response"
 require_relative "openai/models/admin/organization/projects/service_account_update_params"
+require_relative "openai/models/admin/organization/projects/service_tier_setting_retrieve_params"
+require_relative "openai/models/admin/organization/projects/service_tier_setting_update_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_create_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_delete_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_list_params"
@@ -1592,6 +1596,7 @@ require_relative "openai/resources/admin/organization/projects/rate_limits"
 require_relative "openai/resources/admin/organization/projects/roles"
 require_relative "openai/resources/admin/organization/projects/service_accounts"
 require_relative "openai/resources/admin/organization/projects/service_accounts/api_keys"
+require_relative "openai/resources/admin/organization/projects/service_tier_settings"
 require_relative "openai/resources/admin/organization/projects/spend_alerts"
 require_relative "openai/resources/admin/organization/projects/spend_limit"
 require_relative "openai/resources/admin/organization/projects/users"

data/rbi/openai/models/admin/organization/projects/project_optional_service_tier.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Admin
+
+      module Organization
+
+        ProjectOptionalServiceTier = Projects::ProjectOptionalServiceTier
+
+        module Projects
+
+          module ProjectOptionalServiceTier
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias {
+              T.all(Symbol, OpenAI::Admin::Organization::Projects::ProjectOptionalServiceTier)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            FLEX = T.let(:flex, OpenAI::Admin::Organization::Projects::ProjectOptionalServiceTier::TaggedSymbol)
+            FAST = T.let(:fast, OpenAI::Admin::Organization::Projects::ProjectOptionalServiceTier::TaggedSymbol)
+            ULTRAFAST = T.let(
+              :ultrafast,
+              OpenAI::Admin::Organization::Projects::ProjectOptionalServiceTier::TaggedSymbol
+            )
+
+            sig {
+              override.returns(
+                T::Array[OpenAI::Admin::Organization::Projects::ProjectOptionalServiceTier::TaggedSymbol]
+              )
+            }
+            def self.values
+            end
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/admin/organization/projects/project_service_tier_settings.rbi

@@ -0,0 +1,143 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Admin
+
+      module Organization
+
+        ProjectServiceTierSettings = Projects::ProjectServiceTierSettings
+
+        module Projects
+
+          class ProjectServiceTierSettings < OpenAI::Internal::Type::BaseModel
+
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # Default tier for requests that omit service_tier or use auto.
+            sig { returns(OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::Default::TaggedSymbol) }
+            attr_accessor :default
+
+            # Additional service tiers enabled for this project. "all" includes future tiers.
+            # An empty array allows only Standard. Organization policy and eligibility still
+            # apply.
+            sig { returns(OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::EnabledTiers::Variants) }
+            attr_accessor :enabled_tiers
+
+            sig { returns(Symbol) }
+            attr_accessor :object
+
+            sig do
+              params(
+
+                default: OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::Default::OrSymbol,
+
+                enabled_tiers: T.any(
+                  Symbol,
+                  T::Array[OpenAI::Admin::Organization::Projects::ProjectOptionalServiceTier::OrSymbol]
+                ),
+
+                object: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # Default tier for requests that omit service_tier or use auto.
+              default:,
+
+              # Additional service tiers enabled for this project. "all" includes future tiers.
+              # An empty array allows only Standard. Organization policy and eligibility still
+              # apply.
+              enabled_tiers:,
+
+              object: :"project.service_tier_settings"
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  default: OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::Default::TaggedSymbol,
+                  enabled_tiers: OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::EnabledTiers::Variants,
+                  object: Symbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # Default tier for requests that omit service_tier or use auto.
+            module Default
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias {
+                T.all(Symbol, OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::Default)
+              }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              STANDARD = T.let(
+                :standard,
+                OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::Default::TaggedSymbol
+              )
+              FAST = T.let(
+                :fast,
+                OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::Default::TaggedSymbol
+              )
+              SCALE = T.let(
+                :scale,
+                OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::Default::TaggedSymbol
+              )
+
+              sig {
+                override.returns(
+                  T::Array[OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::Default::TaggedSymbol]
+                )
+              }
+              def self.values
+              end
+            end
+
+            # Additional service tiers enabled for this project. "all" includes future tiers.
+            # An empty array allows only Standard. Organization policy and eligibility still
+            # apply.
+            module EnabledTiers
+              extend OpenAI::Internal::Type::Union
+
+              Variants = T.type_alias {
+                T.any(Symbol, T::Array[OpenAI::Admin::Organization::Projects::ProjectOptionalServiceTier::TaggedSymbol])
+              }
+
+              sig {
+                override.returns(
+                  T::Array[OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::EnabledTiers::Variants]
+                )
+              }
+              def self.variants
+              end
+
+              ProjectOptionalServiceTierArray = T.let(
+                OpenAI::Internal::Type::ArrayOf[
+                  enum: -> { OpenAI::Models::Admin::Organization::Projects::ProjectOptionalServiceTier }
+                ],
+                OpenAI::Internal::Type::Converter
+              )
+
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/admin/organization/projects/service_tier_setting_retrieve_params.rbi

@@ -0,0 +1,63 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Admin
+
+      module Organization
+
+        module Projects
+
+          class ServiceTierSettingRetrieveParams < OpenAI::Internal::Type::BaseModel
+
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Admin::Organization::Projects::ServiceTierSettingRetrieveParams,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The ID of the project
+            sig { returns(String) }
+            attr_accessor :project_id
+
+            sig do
+              params(
+
+                project_id: String,
+
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The ID of the project
+              project_id:,
+
+              request_options: {}
+            )
+            end
+
+            sig do
+              override.returns(
+                {project_id: String, request_options: OpenAI::RequestOptions}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end