openai 0.86.0 → 0.88.0

data/rbi/openai/resources/evals.rbi

@@ -15,7 +15,7 @@ module OpenAI
       # data source, which dictates the schema of the data used in the evaluation. After
       # creating an evaluation, you can run it on different models and model parameters.
       # We support several types of graders and datasources. For more information, see
-      # the [Evals guide](https://platform.openai.com/docs/guides/evals).
+      # the [Evals guide](https://developers.openai.com/api/docs/guides/evals).
       sig {
         params(
           data_source_config: T.any(

data/rbi/openai/resources/files.rbi

@@ -14,20 +14,20 @@ module OpenAI
       #
       # - The Assistants API supports files up to 2 million tokens and of specific file
       #   types. See the
-      #   [Assistants Tools guide](https://platform.openai.com/docs/assistants/tools)
+      #   [Assistants Tools guide](https://developers.openai.com/api/docs/guides/tools)
       #   for details.
       # - The Fine-tuning API only supports `.jsonl` files. The input also has certain
       #   required formats for fine-tuning
-      #   [chat](https://platform.openai.com/docs/api-reference/fine-tuning/chat-input)
+      #   [chat](https://developers.openai.com/api/docs/guides/supervised-fine-tuning#formatting-your-data)
       #   or
-      #   [completions](https://platform.openai.com/docs/api-reference/fine-tuning/completions-input)
+      #   [completions](https://developers.openai.com/api/docs/guides/supervised-fine-tuning#formatting-your-data)
       #   models.
       # - The Batch API only supports `.jsonl` files up to 200 MB in size. The input
       #   also has a specific required
-      #   [format](https://platform.openai.com/docs/api-reference/batch/request-input).
+      #   [format](https://developers.openai.com/api/docs/guides/batch#1-prepare-your-batch-file).
       # - For Retrieval or `file_search` ingestion, upload files here first. If you need
       #   to attach multiple uploaded files to the same vector store, use
-      #   [`/vector_stores/{vector_store_id}/file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+      #   [`/vector_stores/{vector_store_id}/file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
       #   instead of attaching them one by one. Vector store attachment has separate
       #   limits from file upload, including 2,000 attached files per minute per
       #   organization.

data/rbi/openai/resources/fine_tuning/alpha/graders.rbi

@@ -31,13 +31,14 @@ module OpenAI
             grader:,
             # The model sample to be evaluated. This value will be used to populate the
             # `sample` namespace. See
-            # [the guide](https://platform.openai.com/docs/guides/graders) for more details.
-            # The `output_json` variable will be populated if the model sample is a valid JSON
-            # string.
+            # [the guide](https://developers.openai.com/api/docs/guides/graders) for more
+            # details. The `output_json` variable will be populated if the model sample is a
+            # valid JSON string.
             model_sample:,
             # The dataset item provided to the grader. This will be used to populate the
             # `item` namespace. See
-            # [the guide](https://platform.openai.com/docs/guides/graders) for more details.
+            # [the guide](https://developers.openai.com/api/docs/guides/graders) for more
+            # details.
             item: nil,
             request_options: {}
           )

data/rbi/openai/resources/fine_tuning/checkpoints/permissions.rbi

@@ -10,7 +10,8 @@ module OpenAI
         # Manage fine-tuning jobs to tailor a model to your specific training data.
         class Permissions
 
-          # **NOTE:** Calling this endpoint requires an [admin API key](../admin-api-keys).
+          # **NOTE:** Calling this endpoint requires an
+          # [admin API key](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/admin_api_keys).
           #
           # This enables organization owners to share fine-tuned models with other projects
           # in their organization.
@@ -31,7 +32,8 @@ module OpenAI
           )
           end
 
-          # **NOTE:** This endpoint requires an [admin API key](../admin-api-keys).
+          # **NOTE:** This endpoint requires an
+          # [admin API key](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/admin_api_keys).
           #
           # Organization owners can use this endpoint to view all permissions for a
           # fine-tuned model checkpoint.
@@ -61,7 +63,8 @@ module OpenAI
           )
           end
 
-          # **NOTE:** This endpoint requires an [admin API key](../admin-api-keys).
+          # **NOTE:** This endpoint requires an
+          # [admin API key](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/admin_api_keys).
           #
           # Organization owners can use this endpoint to view all permissions for a
           # fine-tuned model checkpoint.
@@ -95,7 +98,8 @@ module OpenAI
           )
           end
 
-          # **NOTE:** This endpoint requires an [admin API key](../admin-api-keys).
+          # **NOTE:** This endpoint requires an
+          # [admin API key](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/admin_api_keys).
           #
           # Organization owners can use this endpoint to delete a permission for a
           # fine-tuned model checkpoint.

data/rbi/openai/resources/fine_tuning/jobs.rbi

@@ -18,7 +18,7 @@ module OpenAI
         # Response includes details of the enqueued job including job status and the name
         # of the fine-tuned models once complete.
         #
-        # [Learn more about fine-tuning](https://platform.openai.com/docs/guides/model-optimization)
+        # [Learn more about fine-tuning](https://developers.openai.com/api/docs/guides/model-optimization)
         sig {
           params(
             model: T.any(String, OpenAI::FineTuning::JobCreateParams::Model::OrSymbol),
@@ -36,25 +36,26 @@ module OpenAI
         }
         def create(
           # The name of the model to fine-tune. You can select one of the
-          # [supported models](https://platform.openai.com/docs/guides/fine-tuning#which-models-can-be-fine-tuned).
+          # [supported models](https://developers.openai.com/api/docs/guides/model-optimization#fine-tuning-methods).
           model:,
           # The ID of an uploaded file that contains training data.
           #
-          # See [upload file](https://platform.openai.com/docs/api-reference/files/create)
+          # See
+          # [upload file](https://developers.openai.com/api/reference/resources/files/methods/create)
           # for how to upload a file.
           #
           # Your dataset must be formatted as a JSONL file. Additionally, you must upload
           # your file with the purpose `fine-tune`.
           #
           # The contents of the file should differ depending on if the model uses the
-          # [chat](https://platform.openai.com/docs/api-reference/fine-tuning/chat-input),
-          # [completions](https://platform.openai.com/docs/api-reference/fine-tuning/completions-input)
+          # [chat](https://developers.openai.com/api/docs/guides/supervised-fine-tuning#formatting-your-data),
+          # [completions](https://developers.openai.com/api/docs/guides/supervised-fine-tuning#formatting-your-data)
           # format, or if the fine-tuning method uses the
-          # [preference](https://platform.openai.com/docs/api-reference/fine-tuning/preference-input)
+          # [preference](https://developers.openai.com/api/docs/guides/direct-preference-optimization)
           # format.
           #
           # See the
-          # [fine-tuning guide](https://platform.openai.com/docs/guides/model-optimization)
+          # [fine-tuning guide](https://developers.openai.com/api/docs/guides/model-optimization)
           # for more details.
           training_file:,
           # The hyperparameters used for the fine-tuning job. This value is now deprecated
@@ -92,7 +93,7 @@ module OpenAI
           # the purpose `fine-tune`.
           #
           # See the
-          # [fine-tuning guide](https://platform.openai.com/docs/guides/model-optimization)
+          # [fine-tuning guide](https://developers.openai.com/api/docs/guides/model-optimization)
           # for more details.
           validation_file: nil,
           request_options: {}
@@ -101,7 +102,7 @@ module OpenAI
 
         # Get info about a fine-tuning job.
         #
-        # [Learn more about fine-tuning](https://platform.openai.com/docs/guides/model-optimization)
+        # [Learn more about fine-tuning](https://developers.openai.com/api/docs/guides/model-optimization)
         sig {
           params(fine_tuning_job_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
             OpenAI::FineTuning::FineTuningJob

data/rbi/openai/resources/images.rbi

@@ -41,7 +41,7 @@ module OpenAI
         size: nil,
         # 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).
         user: nil,
         request_options: {}
       )
@@ -50,8 +50,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 (`gpt-image-1.5`, `gpt-image-1`,
-      # `gpt-image-1-mini`, and `chatgpt-image-latest`) and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models and `dall-e-2`.
       sig {
         params(
           image: OpenAI::ImageEditParams::Image::Variants,
@@ -77,9 +76,11 @@ module OpenAI
         # The image(s) to edit. Must be a supported image file or an array of images.
         #
         # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-        # `gpt-image-2`, `gpt-image-2-2026-04-21`, and `chatgpt-image-latest`), each image
-        # should be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to
-        # 16 images.
+        # `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`), each image should
+        # 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.
@@ -95,9 +96,11 @@ module OpenAI
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
         # the model will automatically determine the best background for the image.
         #
-        # 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`.
+        # `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`.
         background: nil,
         # Control how much effort the model will exert to match the style and features,
         # especially facial features, of input images. This parameter is only supported
@@ -115,7 +118,9 @@ module OpenAI
         mask: 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`, or `chatgpt-image-latest`). Defaults to
+        # `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`.
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
@@ -135,29 +140,32 @@ module OpenAI
         # 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.
         partial_images: nil,
-        # The quality of the image that will be generated for GPT image models. Defaults
-        # to `auto`.
+        # The quality of the image that will be generated for GPT image models. The GPT
+        # image models support `low`, `medium`, and `high`. `gpt-image-2.5-sunburst` and
+        # `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, also support
+        # `xhigh` and `max`. Defaults to `auto`.
         quality: 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.
         response_format: nil,
-        # The size of the generated images. For `gpt-image-2` and
-        # `gpt-image-2-2026-04-21`, 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. 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`.
         size: nil,
         # 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).
         user: nil,
         # There is no need to provide `stream:`. Instead, use `#edit_stream_raw` or
         # `#edit` for streaming and non-streaming use cases, respectively.
@@ -169,8 +177,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 (`gpt-image-1.5`, `gpt-image-1`,
-      # `gpt-image-1-mini`, and `chatgpt-image-latest`) and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models and `dall-e-2`.
       sig {
         params(
           image: OpenAI::ImageEditParams::Image::Variants,
@@ -196,9 +203,11 @@ module OpenAI
         # The image(s) to edit. Must be a supported image file or an array of images.
         #
         # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-        # `gpt-image-2`, `gpt-image-2-2026-04-21`, and `chatgpt-image-latest`), each image
-        # should be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to
-        # 16 images.
+        # `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`), each image should
+        # 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.
@@ -214,9 +223,11 @@ module OpenAI
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
         # the model will automatically determine the best background for the image.
         #
-        # 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`.
+        # `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`.
         background: nil,
         # Control how much effort the model will exert to match the style and features,
         # especially facial features, of input images. This parameter is only supported
@@ -234,7 +245,9 @@ module OpenAI
         mask: 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`, or `chatgpt-image-latest`). Defaults to
+        # `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`.
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
@@ -254,29 +267,32 @@ module OpenAI
         # 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.
         partial_images: nil,
-        # The quality of the image that will be generated for GPT image models. Defaults
-        # to `auto`.
+        # The quality of the image that will be generated for GPT image models. The GPT
+        # image models support `low`, `medium`, and `high`. `gpt-image-2.5-sunburst` and
+        # `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, also support
+        # `xhigh` and `max`. Defaults to `auto`.
         quality: 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.
         response_format: nil,
-        # The size of the generated images. For `gpt-image-2` and
-        # `gpt-image-2-2026-04-21`, 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. 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`.
         size: nil,
         # 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).
         user: nil,
         # There is no need to provide `stream:`. Instead, use `#edit_stream_raw` or
         # `#edit` for streaming and non-streaming use cases, respectively.
@@ -288,7 +304,7 @@ module OpenAI
       # See {OpenAI::Resources::Images#generate_stream_raw} for streaming counterpart.
       #
       # Creates an image given a prompt.
-      # [Learn more](https://platform.openai.com/docs/guides/images).
+      # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       sig {
         params(
           prompt: String,
@@ -318,14 +334,18 @@ module OpenAI
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
         # the model will automatically determine the best background for the image.
         #
-        # 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`.
+        # `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`.
         background: 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`,
-        # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
-        # to the GPT image models is used.
+        # `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.
         model: 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
@@ -353,6 +373,8 @@ module OpenAI
         # - `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`.
         quality: nil,
@@ -361,17 +383,18 @@ module OpenAI
         # after the image has been generated. This parameter isn't supported for the GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
-        # The size of the generated images. For `gpt-image-2` and
-        # `gpt-image-2-2026-04-21`, 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. 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`.
         size: 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
@@ -380,7 +403,7 @@ module OpenAI
         style: nil,
         # 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).
         user: nil,
         # There is no need to provide `stream:`. Instead, use `#generate_stream_raw` or
         # `#generate` for streaming and non-streaming use cases, respectively.
@@ -392,7 +415,7 @@ module OpenAI
       # See {OpenAI::Resources::Images#generate} for non-streaming counterpart.
       #
       # Creates an image given a prompt.
-      # [Learn more](https://platform.openai.com/docs/guides/images).
+      # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       sig {
         params(
           prompt: String,
@@ -422,14 +445,18 @@ module OpenAI
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
         # the model will automatically determine the best background for the image.
         #
-        # 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`.
+        # `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`.
         background: 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`,
-        # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
-        # to the GPT image models is used.
+        # `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.
         model: 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
@@ -457,6 +484,8 @@ module OpenAI
         # - `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`.
         quality: nil,
@@ -465,17 +494,18 @@ module OpenAI
         # after the image has been generated. This parameter isn't supported for the GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
-        # The size of the generated images. For `gpt-image-2` and
-        # `gpt-image-2-2026-04-21`, 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. 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`.
         size: 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
@@ -484,7 +514,7 @@ module OpenAI
         style: nil,
         # 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).
         user: nil,
         # There is no need to provide `stream:`. Instead, use `#generate_stream_raw` or
         # `#generate` for streaming and non-streaming use cases, respectively.

data/rbi/openai/resources/moderations.rbi

@@ -8,7 +8,8 @@ module OpenAI
     class Moderations
 
       # Classifies if text and/or image inputs are potentially harmful. Learn more in
-      # the [moderation guide](https://platform.openai.com/docs/guides/moderation).
+      # the
+      # [moderation guide](https://developers.openai.com/api/docs/guides/moderation).
       sig {
         params(
           input: OpenAI::ModerationCreateParams::Input::Variants,
@@ -22,9 +23,9 @@ module OpenAI
         # an array of multi-modal input objects similar to other models.
         input:,
         # The content moderation model you would like to use. Learn more in
-        # [the moderation guide](https://platform.openai.com/docs/guides/moderation), and
-        # learn about available models
-        # [here](https://platform.openai.com/docs/models#moderation).
+        # [the moderation guide](https://developers.openai.com/api/docs/guides/moderation),
+        # and learn about available models
+        # [here](https://developers.openai.com/api/docs/guides/moderation).
         model: nil,
         request_options: {}
       )

data/rbi/openai/resources/realtime/calls.rbi

@@ -63,7 +63,7 @@ module OpenAI
         }
         def accept(
           # The identifier for the call provided in the
-          # [`realtime.call.incoming`](https://platform.openai.com/docs/api-reference/webhook-events/realtime/call/incoming)
+          # [`realtime.call.incoming`](https://developers.openai.com/api/reference/resources/webhooks#realtime.call.incoming)
           # webhook.
           call_id,
           # Configuration for input and output audio.
@@ -100,7 +100,7 @@ module OpenAI
           # reasoning Realtime models such as `gpt-realtime-2`.
           parallel_tool_calls: nil,
           # Reference to a prompt template and its variables.
-          # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+          # [Learn more](https://developers.openai.com/api/docs/guides/text?api-mode=responses#version-prompts-in-code).
           prompt: nil,
           # Configuration for reasoning-capable Realtime models such as `gpt-realtime-2`.
           reasoning: nil,
@@ -146,10 +146,10 @@ module OpenAI
         sig { params(call_id: String, request_options: OpenAI::RequestOptions::OrHash).void }
         def hangup(
           # The identifier for the call. For SIP calls, use the value provided in the
-          # [`realtime.call.incoming`](https://platform.openai.com/docs/api-reference/webhook-events/realtime/call/incoming)
+          # [`realtime.call.incoming`](https://developers.openai.com/api/reference/resources/webhooks#realtime.call.incoming)
           # webhook. For WebRTC sessions, reuse the call ID returned in the `Location`
           # header when creating the call with
-          # [`POST /v1/realtime/calls`](https://platform.openai.com/docs/api-reference/realtime/create-call).
+          # [`POST /v1/realtime/calls`](https://developers.openai.com/api/reference/resources/realtime/subresources/calls/methods/create).
           call_id,
           request_options: {}
         )
@@ -159,7 +159,7 @@ module OpenAI
         sig { params(call_id: String, target_uri: String, request_options: OpenAI::RequestOptions::OrHash).void }
         def refer(
           # The identifier for the call provided in the
-          # [`realtime.call.incoming`](https://platform.openai.com/docs/api-reference/webhook-events/realtime/call/incoming)
+          # [`realtime.call.incoming`](https://developers.openai.com/api/reference/resources/webhooks#realtime.call.incoming)
           # webhook.
           call_id,
           # URI that should appear in the SIP Refer-To header. Supports values like
@@ -173,7 +173,7 @@ module OpenAI
         sig { params(call_id: String, status_code: Integer, request_options: OpenAI::RequestOptions::OrHash).void }
         def reject(
           # The identifier for the call provided in the
-          # [`realtime.call.incoming`](https://platform.openai.com/docs/api-reference/webhook-events/realtime/call/incoming)
+          # [`realtime.call.incoming`](https://developers.openai.com/api/reference/resources/webhooks#realtime.call.incoming)
           # webhook.
           call_id,
           # SIP response code to send back to the caller. Defaults to `603` (Decline) when

data/rbi/openai/resources/realtime/client_secrets.rbi

@@ -18,7 +18,7 @@ module OpenAI
         # will be applied to any sessions created using that client secret, but these can
         # also be overridden by the client connection.
         #
-        # [Learn more about authentication with client secrets over WebRTC](https://platform.openai.com/docs/guides/realtime-webrtc).
+        # [Learn more about authentication with client secrets over WebRTC](https://developers.openai.com/api/docs/guides/realtime-webrtc).
         #
         # Returns the created client secret and the effective session object. The client
         # secret is a string that looks like `ek_1234`.