openai 0.87.0 → 0.89.0

data/rbi/openai/resources/beta/assistants.rbi

@@ -41,10 +41,10 @@ module OpenAI
         }
         def create(
           # ID of the model to use. You can use the
-          # [List models](https://platform.openai.com/docs/api-reference/models/list) API to
-          # see all of your available models, or see our
-          # [Model overview](https://platform.openai.com/docs/models) for descriptions of
-          # them.
+          # [List models](https://developers.openai.com/api/reference/resources/models/methods/list)
+          # API to see all of your available models, or see our
+          # [Model overview](https://developers.openai.com/api/docs/models) for descriptions
+          # of them.
           model:,
           # The description of the assistant. The maximum length is 512 characters.
           description: nil,
@@ -64,18 +64,18 @@ module OpenAI
           # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
           # reasoning effort can result in faster responses and fewer tokens used on
           # reasoning in a response. Not all reasoning models support every value. See the
-          # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+          # [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
           # model-specific support.
           reasoning_effort: nil,
           # Specifies the format that the model must output. Compatible with
-          # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
-          # [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
-          # and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
+          # [GPT-4o](https://developers.openai.com/api/docs/models/gpt-4o),
+          # [GPT-4 Turbo](https://developers.openai.com/api/docs/models/gpt-4-turbo), and
+          # all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
           #
           # Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
           # Outputs which ensures the model will match your supplied JSON schema. Learn more
           # in the
-          # [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+          # [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
           #
           # Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the
           # message the model generates is valid JSON.
@@ -170,10 +170,10 @@ module OpenAI
           # a maximum length of 512 characters.
           metadata: nil,
           # ID of the model to use. You can use the
-          # [List models](https://platform.openai.com/docs/api-reference/models/list) API to
-          # see all of your available models, or see our
-          # [Model overview](https://platform.openai.com/docs/models) for descriptions of
-          # them.
+          # [List models](https://developers.openai.com/api/reference/resources/models/methods/list)
+          # API to see all of your available models, or see our
+          # [Model overview](https://developers.openai.com/api/docs/models) for descriptions
+          # of them.
           model: nil,
           # The name of the assistant. The maximum length is 256 characters.
           name: nil,
@@ -181,18 +181,18 @@ module OpenAI
           # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
           # reasoning effort can result in faster responses and fewer tokens used on
           # reasoning in a response. Not all reasoning models support every value. See the
-          # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+          # [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
           # model-specific support.
           reasoning_effort: nil,
           # Specifies the format that the model must output. Compatible with
-          # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
-          # [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
-          # and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
+          # [GPT-4o](https://developers.openai.com/api/docs/models/gpt-4o),
+          # [GPT-4 Turbo](https://developers.openai.com/api/docs/models/gpt-4-turbo), and
+          # all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
           #
           # Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
           # Outputs which ensures the model will match your supplied JSON schema. Learn more
           # in the
-          # [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+          # [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
           #
           # Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the
           # message the model generates is valid JSON.

data/rbi/openai/resources/beta/responses/input_tokens.rbi

@@ -82,8 +82,8 @@ module OpenAI
             # Body param: Model ID used to generate the response, like `gpt-4o` or `o3`.
             # OpenAI offers a wide range of models with different capabilities, performance
             # characteristics, and price points. Refer to the
-            # [model guide](https://platform.openai.com/docs/models) to browse and compare
-            # available models.
+            # [model guide](https://developers.openai.com/api/docs/models) to browse and
+            # compare available models.
             model: nil,
             # Body param: Whether to allow the model to run tool calls in parallel.
             parallel_tool_calls: nil,
@@ -93,17 +93,17 @@ module OpenAI
             personality: nil,
             # Body param: The unique ID of the previous response to the model. Use this to
             # create multi-turn conversations. Learn more about
-            # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+            # [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
             # Cannot be used in conjunction with `conversation`.
             previous_response_id: nil,
             # Body param: **gpt-5 and o-series models only** Configuration options for
-            # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+            # [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
             reasoning: nil,
             # Body param: Configuration options for a text response from the model. Can be
             # plain text or structured JSON data. Learn more:
             #
-            # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-            # - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+            # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+            # - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
             text: nil,
             # Body param: Controls which tool the model should use, if any.
             tool_choice: nil,

data/rbi/openai/resources/beta/responses.rbi

@@ -16,16 +16,16 @@ module OpenAI
         # See {OpenAI::Resources::Beta::Responses#stream_raw} for streaming counterpart.
         #
         # Creates a model response. Provide
-        # [text](https://platform.openai.com/docs/guides/text) or
-        # [image](https://platform.openai.com/docs/guides/images) inputs to generate
-        # [text](https://platform.openai.com/docs/guides/text) or
-        # [JSON](https://platform.openai.com/docs/guides/structured-outputs) outputs. Have
-        # the model call your own
-        # [custom code](https://platform.openai.com/docs/guides/function-calling) or use
-        # built-in [tools](https://platform.openai.com/docs/guides/tools) like
-        # [web search](https://platform.openai.com/docs/guides/tools-web-search) or
-        # [file search](https://platform.openai.com/docs/guides/tools-file-search) to use
-        # your own data as input for the model's response.
+        # [text](https://developers.openai.com/api/docs/guides/text) or
+        # [image](https://developers.openai.com/api/docs/guides/images-vision) inputs to
+        # generate [text](https://developers.openai.com/api/docs/guides/text) or
+        # [JSON](https://developers.openai.com/api/docs/guides/structured-outputs)
+        # outputs. Have the model call your own
+        # [custom code](https://developers.openai.com/api/docs/guides/function-calling) or
+        # use built-in [tools](https://developers.openai.com/api/docs/guides/tools) like
+        # [web search](https://developers.openai.com/api/docs/guides/tools-web-search) or
+        # [file search](https://developers.openai.com/api/docs/guides/tools-file-search)
+        # to use your own data as input for the model's response.
         sig {
           params(
             background: T.nilable(T::Boolean),
@@ -96,7 +96,7 @@ module OpenAI
         }
         def create(
           # Body param: Whether to run the model response in the background.
-          # [Learn more](https://platform.openai.com/docs/guides/background).
+          # [Learn more](https://developers.openai.com/api/docs/guides/background).
           background: nil,
           # Body param: Context management configuration for this request.
           context_management: nil,
@@ -129,11 +129,11 @@ module OpenAI
           #
           # Learn more:
           #
-          # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-          # - [Image inputs](https://platform.openai.com/docs/guides/images)
-          # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
-          # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
-          # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+          # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          # - [Image inputs](https://developers.openai.com/api/docs/guides/images-vision)
+          # - [File inputs](https://developers.openai.com/api/docs/guides/file-inputs)
+          # - [Conversation state](https://developers.openai.com/api/docs/guides/conversation-state)
+          # - [Function calling](https://developers.openai.com/api/docs/guides/function-calling)
           input: nil,
           # Body param: A system (or developer) message inserted into the model's context.
           #
@@ -143,7 +143,7 @@ module OpenAI
           instructions: nil,
           # Body param: An upper bound for the number of tokens that can be generated for a
           # response, including visible output tokens and
-          # [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+          # [reasoning tokens](https://developers.openai.com/api/docs/guides/reasoning).
           max_output_tokens: nil,
           # Body param: The maximum number of total calls to built-in tools that can be
           # processed in a response. This maximum number applies across all built-in tool
@@ -160,8 +160,8 @@ module OpenAI
           # Body param: Model ID used to generate the response, like `gpt-6-astra`. OpenAI
           # offers a wide range of models with different capabilities, performance
           # characteristics, and price points. Refer to the
-          # [model guide](https://platform.openai.com/docs/models) to browse and compare
-          # available models.
+          # [model guide](https://developers.openai.com/api/docs/models) to browse and
+          # compare available models.
           model: nil,
           # Body param: Configuration for running moderation on the input and output of this
           # response.
@@ -172,15 +172,15 @@ module OpenAI
           parallel_tool_calls: nil,
           # Body param: The unique ID of the previous response to the model. Use this to
           # create multi-turn conversations. Learn more about
-          # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+          # [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
           # Cannot be used in conjunction with `conversation`.
           previous_response_id: nil,
           # Body param: 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,
           # Body param: Used by OpenAI to cache responses for similar requests to optimize
           # your cache hit rates. Replaces the `user` field.
-          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+          # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching).
           prompt_cache_key: nil,
           # Body param: Options for prompt caching. Supported for `gpt-5.6` and later
           # models. By default, OpenAI automatically chooses one implicit cache breakpoint.
@@ -190,7 +190,7 @@ module OpenAI
           # 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
-          # [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+          # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           # for current details.
           prompt_cache_options: nil,
           # Body param: Deprecated. Use `prompt_cache_options.ttl` instead.
@@ -198,7 +198,7 @@ module OpenAI
           # The retention policy for the prompt cache. Set to `24h` to enable extended
           # prompt caching, which keeps cached prefixes active for longer, up to a maximum
           # of 24 hours.
-          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+          # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching#prompt-cache-retention).
           # This field expresses a maximum retention policy, while
           # `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
           # are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
@@ -212,14 +212,14 @@ module OpenAI
           #   `prompt_cache_retention` is not specified.
           prompt_cache_retention: nil,
           # Body param: Configuration options for
-          # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+          # [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
           reasoning: nil,
           # Body param: A stable identifier used to help detect users of your application
           # that may be violating OpenAI's usage policies. The IDs should be a string that
           # uniquely identifies each user, with a maximum length of 64 characters. We
           # recommend hashing their username or email address, in order to avoid sending us
           # any identifying information.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
           safety_identifier: nil,
           # Body param: Specifies the processing type used for serving the request.
           #
@@ -228,13 +228,15 @@ module OpenAI
           #   will use 'default'.
           # - If set to 'default', then the request will be processed with the standard
           #   pricing and performance for the selected model.
-          # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)',
-          #   then the request will be processed with the Flex Processing service tier.
-          # - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level,
-          #   include the `service_tier=fast` or `service_tier=priority` parameter for
-          #   Responses or Chat Completions. The response will show `service_tier=priority`
-          #   regardless of if you specify `service_tier=fast` or `priority` in your
-          #   request.
+          # - If set to
+          #   '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+          #   the request will be processed with the Flex Processing service tier.
+          # - To opt-in to
+          #   [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+          #   request level, include the `service_tier=fast` or `service_tier=priority`
+          #   parameter for Responses or Chat Completions. The response will show
+          #   `service_tier=priority` regardless of if you specify `service_tier=fast` or
+          #   `priority` in your request.
           # - If set to 'ultrafast', then the request will be processed with the
           #   access-controlled Ultrafast Processing service tier. This tier is currently
           #   available for `gpt-5.6-sol`; a response served through it will show
@@ -249,7 +251,7 @@ module OpenAI
           # Body param: Whether to store the generated model response for later retrieval
           # via API. Defaults to true when omitted. If set to true, response data will be
           # stored for at least 30 days, subject to the
-          # [data retention exceptions](/api/docs/guides/your-data#v1responses).
+          # [data retention exceptions](https://developers.openai.com/api/docs/guides/your-data#v1responses).
           store: nil,
           # Body param: Options for streaming responses. Only set this when you set
           # `stream: true`.
@@ -262,8 +264,8 @@ module OpenAI
           # Body param: Configuration options for a text response from the model. Can be
           # plain text or structured JSON data. Learn more:
           #
-          # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-          # - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+          # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          # - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
           text: nil,
           # Body param: How the model should select which tool (or tools) to use when
           # generating a response. See the `tools` parameter to see how to specify which
@@ -276,17 +278,18 @@ module OpenAI
           #
           # - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
           #   capabilities, like
-          #   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
-          #   [file search](https://platform.openai.com/docs/guides/tools-file-search).
+          #   [web search](https://developers.openai.com/api/docs/guides/tools-web-search)
+          #   or
+          #   [file search](https://developers.openai.com/api/docs/guides/tools-file-search).
           #   Learn more about
-          #   [built-in tools](https://platform.openai.com/docs/guides/tools).
+          #   [built-in tools](https://developers.openai.com/api/docs/guides/tools).
           # - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
           #   predefined connectors such as Google Drive and SharePoint. Learn more about
-          #   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+          #   [MCP Tools](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
           # - **Function calls (custom tools)**: Functions that are defined by you, enabling
           #   the model to call your own code with strongly typed arguments and outputs.
           #   Learn more about
-          #   [function calling](https://platform.openai.com/docs/guides/function-calling).
+          #   [function calling](https://developers.openai.com/api/docs/guides/function-calling).
           #   You can also use custom tools to call your own code.
           tools: nil,
           # Body param: An integer between 0 and 20 specifying the maximum number of most
@@ -314,7 +317,7 @@ module OpenAI
           # optimizations. A stable identifier for your end-users. Used to boost cache hit
           # rates by better bucketing similar requests and to help OpenAI detect and prevent
           # abuse.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
           user: nil,
           # Header param: Optional beta features to enable for this request.
           betas: nil,
@@ -328,16 +331,16 @@ module OpenAI
         # See {OpenAI::Resources::Beta::Responses#create} for non-streaming counterpart.
         #
         # Creates a model response. Provide
-        # [text](https://platform.openai.com/docs/guides/text) or
-        # [image](https://platform.openai.com/docs/guides/images) inputs to generate
-        # [text](https://platform.openai.com/docs/guides/text) or
-        # [JSON](https://platform.openai.com/docs/guides/structured-outputs) outputs. Have
-        # the model call your own
-        # [custom code](https://platform.openai.com/docs/guides/function-calling) or use
-        # built-in [tools](https://platform.openai.com/docs/guides/tools) like
-        # [web search](https://platform.openai.com/docs/guides/tools-web-search) or
-        # [file search](https://platform.openai.com/docs/guides/tools-file-search) to use
-        # your own data as input for the model's response.
+        # [text](https://developers.openai.com/api/docs/guides/text) or
+        # [image](https://developers.openai.com/api/docs/guides/images-vision) inputs to
+        # generate [text](https://developers.openai.com/api/docs/guides/text) or
+        # [JSON](https://developers.openai.com/api/docs/guides/structured-outputs)
+        # outputs. Have the model call your own
+        # [custom code](https://developers.openai.com/api/docs/guides/function-calling) or
+        # use built-in [tools](https://developers.openai.com/api/docs/guides/tools) like
+        # [web search](https://developers.openai.com/api/docs/guides/tools-web-search) or
+        # [file search](https://developers.openai.com/api/docs/guides/tools-file-search)
+        # to use your own data as input for the model's response.
         sig {
           params(
             background: T.nilable(T::Boolean),
@@ -412,7 +415,7 @@ module OpenAI
         }
         def stream_raw(
           # Body param: Whether to run the model response in the background.
-          # [Learn more](https://platform.openai.com/docs/guides/background).
+          # [Learn more](https://developers.openai.com/api/docs/guides/background).
           background: nil,
           # Body param: Context management configuration for this request.
           context_management: nil,
@@ -445,11 +448,11 @@ module OpenAI
           #
           # Learn more:
           #
-          # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-          # - [Image inputs](https://platform.openai.com/docs/guides/images)
-          # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
-          # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
-          # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+          # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          # - [Image inputs](https://developers.openai.com/api/docs/guides/images-vision)
+          # - [File inputs](https://developers.openai.com/api/docs/guides/file-inputs)
+          # - [Conversation state](https://developers.openai.com/api/docs/guides/conversation-state)
+          # - [Function calling](https://developers.openai.com/api/docs/guides/function-calling)
           input: nil,
           # Body param: A system (or developer) message inserted into the model's context.
           #
@@ -459,7 +462,7 @@ module OpenAI
           instructions: nil,
           # Body param: An upper bound for the number of tokens that can be generated for a
           # response, including visible output tokens and
-          # [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+          # [reasoning tokens](https://developers.openai.com/api/docs/guides/reasoning).
           max_output_tokens: nil,
           # Body param: The maximum number of total calls to built-in tools that can be
           # processed in a response. This maximum number applies across all built-in tool
@@ -476,8 +479,8 @@ module OpenAI
           # Body param: Model ID used to generate the response, like `gpt-6-astra`. OpenAI
           # offers a wide range of models with different capabilities, performance
           # characteristics, and price points. Refer to the
-          # [model guide](https://platform.openai.com/docs/models) to browse and compare
-          # available models.
+          # [model guide](https://developers.openai.com/api/docs/models) to browse and
+          # compare available models.
           model: nil,
           # Body param: Configuration for running moderation on the input and output of this
           # response.
@@ -488,15 +491,15 @@ module OpenAI
           parallel_tool_calls: nil,
           # Body param: The unique ID of the previous response to the model. Use this to
           # create multi-turn conversations. Learn more about
-          # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+          # [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
           # Cannot be used in conjunction with `conversation`.
           previous_response_id: nil,
           # Body param: 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,
           # Body param: Used by OpenAI to cache responses for similar requests to optimize
           # your cache hit rates. Replaces the `user` field.
-          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+          # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching).
           prompt_cache_key: nil,
           # Body param: Options for prompt caching. Supported for `gpt-5.6` and later
           # models. By default, OpenAI automatically chooses one implicit cache breakpoint.
@@ -506,7 +509,7 @@ module OpenAI
           # 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
-          # [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+          # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           # for current details.
           prompt_cache_options: nil,
           # Body param: Deprecated. Use `prompt_cache_options.ttl` instead.
@@ -514,7 +517,7 @@ module OpenAI
           # The retention policy for the prompt cache. Set to `24h` to enable extended
           # prompt caching, which keeps cached prefixes active for longer, up to a maximum
           # of 24 hours.
-          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+          # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching#prompt-cache-retention).
           # This field expresses a maximum retention policy, while
           # `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
           # are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
@@ -528,14 +531,14 @@ module OpenAI
           #   `prompt_cache_retention` is not specified.
           prompt_cache_retention: nil,
           # Body param: Configuration options for
-          # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+          # [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
           reasoning: nil,
           # Body param: A stable identifier used to help detect users of your application
           # that may be violating OpenAI's usage policies. The IDs should be a string that
           # uniquely identifies each user, with a maximum length of 64 characters. We
           # recommend hashing their username or email address, in order to avoid sending us
           # any identifying information.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
           safety_identifier: nil,
           # Body param: Specifies the processing type used for serving the request.
           #
@@ -544,13 +547,15 @@ module OpenAI
           #   will use 'default'.
           # - If set to 'default', then the request will be processed with the standard
           #   pricing and performance for the selected model.
-          # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)',
-          #   then the request will be processed with the Flex Processing service tier.
-          # - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level,
-          #   include the `service_tier=fast` or `service_tier=priority` parameter for
-          #   Responses or Chat Completions. The response will show `service_tier=priority`
-          #   regardless of if you specify `service_tier=fast` or `priority` in your
-          #   request.
+          # - If set to
+          #   '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+          #   the request will be processed with the Flex Processing service tier.
+          # - To opt-in to
+          #   [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+          #   request level, include the `service_tier=fast` or `service_tier=priority`
+          #   parameter for Responses or Chat Completions. The response will show
+          #   `service_tier=priority` regardless of if you specify `service_tier=fast` or
+          #   `priority` in your request.
           # - If set to 'ultrafast', then the request will be processed with the
           #   access-controlled Ultrafast Processing service tier. This tier is currently
           #   available for `gpt-5.6-sol`; a response served through it will show
@@ -565,7 +570,7 @@ module OpenAI
           # Body param: Whether to store the generated model response for later retrieval
           # via API. Defaults to true when omitted. If set to true, response data will be
           # stored for at least 30 days, subject to the
-          # [data retention exceptions](/api/docs/guides/your-data#v1responses).
+          # [data retention exceptions](https://developers.openai.com/api/docs/guides/your-data#v1responses).
           store: nil,
           # Body param: Options for streaming responses. Only set this when you set
           # `stream: true`.
@@ -578,8 +583,8 @@ module OpenAI
           # Body param: Configuration options for a text response from the model. Can be
           # plain text or structured JSON data. Learn more:
           #
-          # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-          # - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+          # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          # - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
           text: nil,
           # Body param: How the model should select which tool (or tools) to use when
           # generating a response. See the `tools` parameter to see how to specify which
@@ -592,17 +597,18 @@ module OpenAI
           #
           # - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
           #   capabilities, like
-          #   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
-          #   [file search](https://platform.openai.com/docs/guides/tools-file-search).
+          #   [web search](https://developers.openai.com/api/docs/guides/tools-web-search)
+          #   or
+          #   [file search](https://developers.openai.com/api/docs/guides/tools-file-search).
           #   Learn more about
-          #   [built-in tools](https://platform.openai.com/docs/guides/tools).
+          #   [built-in tools](https://developers.openai.com/api/docs/guides/tools).
           # - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
           #   predefined connectors such as Google Drive and SharePoint. Learn more about
-          #   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+          #   [MCP Tools](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
           # - **Function calls (custom tools)**: Functions that are defined by you, enabling
           #   the model to call your own code with strongly typed arguments and outputs.
           #   Learn more about
-          #   [function calling](https://platform.openai.com/docs/guides/function-calling).
+          #   [function calling](https://developers.openai.com/api/docs/guides/function-calling).
           #   You can also use custom tools to call your own code.
           tools: nil,
           # Body param: An integer between 0 and 20 specifying the maximum number of most
@@ -630,7 +636,7 @@ module OpenAI
           # optimizations. A stable identifier for your end-users. Used to boost cache hit
           # rates by better bucketing similar requests and to help OpenAI detect and prevent
           # abuse.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
           user: nil,
           # Header param: Optional beta features to enable for this request.
           betas: nil,
@@ -746,7 +752,7 @@ module OpenAI
 
         # Cancels a model response with the given ID. Only responses created with the
         # `background` parameter set to `true` can be cancelled.
-        # [Learn more](https://platform.openai.com/docs/guides/background).
+        # [Learn more](https://developers.openai.com/api/docs/guides/background).
         sig {
           params(
             response_id: String,
@@ -767,9 +773,9 @@ module OpenAI
         # Compact a conversation. Returns a compacted response object.
         #
         # Learn when and how to compact long-running conversations in the
-        # [conversation state guide](https://platform.openai.com/docs/guides/conversation-state#managing-the-context-window).
+        # [conversation state guide](https://developers.openai.com/api/docs/guides/conversation-state#managing-the-context-window).
         # For ZDR-compatible compaction details, see
-        # [Compaction (advanced)](https://platform.openai.com/docs/guides/conversation-state#compaction-advanced).
+        # [Compaction (advanced)](https://developers.openai.com/api/docs/guides/conversation-state#compaction-advanced).
         sig {
           params(
             model: T.nilable(T.any(OpenAI::Beta::ResponseCompactParams::Model::OrSymbol, String)),
@@ -789,8 +795,8 @@ module OpenAI
           # Body param: Model ID used to generate the response, like `gpt-6-astra`. OpenAI
           # offers a wide range of models with different capabilities, performance
           # characteristics, and price points. Refer to the
-          # [model guide](https://platform.openai.com/docs/models) to browse and compare
-          # available models.
+          # [model guide](https://developers.openai.com/api/docs/models) to browse and
+          # compare available models.
           model:,
           # Body param: Text, image, or file inputs to the model, used to generate a
           # response
@@ -802,7 +808,7 @@ module OpenAI
           instructions: nil,
           # Body param: The unique ID of the previous response to the model. Use this to
           # create multi-turn conversations. Learn more about
-          # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+          # [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
           # Cannot be used in conjunction with `conversation`.
           previous_response_id: nil,
           # Body param: A key to use when reading from or writing to the prompt cache.
@@ -815,7 +821,7 @@ module OpenAI
           # 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
-          # [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+          # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           # for current details.
           prompt_cache_options: nil,
           # Body param: How long to retain a prompt cache entry created by this request.
@@ -825,17 +831,17 @@ module OpenAI
           # in the Project settings. Unless otherwise configured, the Project will use
           # 'default'. - If set to 'default', then the request will be processed with the
           # standard pricing and performance for the selected model. - If set to
-          # '[flex](https://platform.openai.com/docs/guides/flex-processing)', then the
-          # request will be processed with the Flex Processing service tier. - To opt-in to
-          # [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
-          # `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-          # Completions. For models with a dedicated Fast tier, either value resolves to
-          # `service_tier=fast`; for other models, either value resolves to
-          # `service_tier=priority`. - When not set, the default behavior is 'auto'. When
-          # the `service_tier` parameter is set, the response body will include the
-          # `service_tier` value based on the processing mode actually used to serve the
-          # request. This response value may be different from the value set in the
-          # parameter.
+          # '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+          # the request will be processed with the Flex Processing service tier. - To opt-in
+          # to [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+          # request level, include the `service_tier=fast` or `service_tier=priority`
+          # parameter for Responses or Chat Completions. For models with a dedicated Fast
+          # tier, either value resolves to `service_tier=fast`; for other models, either
+          # value resolves to `service_tier=priority`. - When not set, the default behavior
+          # is 'auto'. When the `service_tier` parameter is set, the response body will
+          # include the `service_tier` value based on the processing mode actually used to
+          # serve the request. This response value may be different from the value set in
+          # the parameter.
           service_tier: nil,
           # Header param: Optional beta features to enable for this request.
           betas: nil,