openai 7.10.0 → 7.13.0

package/resources/beta/responses/responses.d.mts

@@ -13,16 +13,16 @@ export declare class Responses extends APIResource {
     inputTokens: InputTokensAPI.InputTokens;
     /**
      * 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.
      *
      * @example
      * ```ts
@@ -59,7 +59,7 @@ export declare class Responses extends APIResource {
     /**
      * 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).
      *
      * @example
      * ```ts
@@ -73,9 +73,9 @@ export declare class Responses extends APIResource {
      * 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).
      *
      * @example
      * ```ts
@@ -328,7 +328,7 @@ export declare namespace BetaComputerAction {
 export type BetaComputerActionList = Array<BetaComputerAction>;
 /**
  * A tool that controls a virtual computer. Learn more about the
- * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+ * [computer tool](https://developers.openai.com/api/docs/guides/tools-computer-use).
  */
 export interface BetaComputerTool {
     /**
@@ -338,7 +338,7 @@ export interface BetaComputerTool {
 }
 /**
  * A tool that controls a virtual computer. Learn more about the
- * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+ * [computer tool](https://developers.openai.com/api/docs/guides/tools-computer-use).
  */
 export interface BetaComputerUsePreviewTool {
     /**
@@ -426,7 +426,7 @@ export interface BetaContainerReference {
 }
 /**
  * A custom tool that processes input using a specified format. Learn more about
- * [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+ * [custom tools](https://developers.openai.com/api/docs/guides/function-calling#custom-tools)
  */
 export interface BetaCustomTool {
     /**
@@ -520,7 +520,7 @@ export interface BetaEasyInputMessage {
 /**
  * A tool that searches for relevant content from uploaded files. Learn more about
  * the
- * [file search tool](https://platform.openai.com/docs/guides/tools-file-search).
+ * [file search tool](https://developers.openai.com/api/docs/guides/tools-file-search).
  */
 export interface BetaFileSearchTool {
     /**
@@ -674,7 +674,7 @@ export interface BetaFunctionShellTool {
 /**
  * Defines a function in your own code the model can choose to call. Learn more
  * about
- * [function calling](https://platform.openai.com/docs/guides/function-calling).
+ * [function calling](https://developers.openai.com/api/docs/guides/function-calling).
  */
 export interface BetaFunctionTool {
     /**
@@ -889,8 +889,8 @@ export interface BetaResponse {
      * 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: 'gpt-6-astra' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.5' | 'gpt-5.5-2026-04-23' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.3-chat-latest' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o3-deep-research' | 'o3-deep-research-2025-06-26' | 'o4-mini-deep-research' | 'o4-mini-deep-research-2025-06-26' | 'computer-use-preview' | 'computer-use-preview-2025-03-11' | 'gpt-5.5-pro' | 'gpt-5.5-pro-2026-04-23' | 'gpt-5-codex' | 'gpt-5-pro' | 'gpt-5-pro-2025-10-06' | 'gpt-5.1-codex-max' | 'gpt-daybreak-blue-latest' | 'gpt-daybreak-red-latest' | 'gpt-5.6-cyber' | (string & {});
     /**
@@ -932,17 +932,18 @@ export interface BetaResponse {
      *
      * - **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: Array<BetaTool>;
@@ -956,7 +957,7 @@ export interface BetaResponse {
     top_p: number | null;
     /**
      * 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?: boolean | null;
     /**
@@ -972,7 +973,7 @@ export interface BetaResponse {
     /**
      * 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?: number | null;
     /**
@@ -990,19 +991,23 @@ export interface BetaResponse {
     /**
      * 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?: string | null;
     /**
      * 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?: BetaResponsePrompt | null;
+    /**
+     * Prompt cache diagnostics requested for this response.
+     */
+    prompt_cache_diagnostics?: BetaResponse.CacheMiss | BetaResponse.CacheHit | BetaResponse.ComparisonResponseNotFound | BetaResponse.Unavailable;
     /**
      * 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?: string | null;
     /**
@@ -1016,7 +1021,7 @@ export interface BetaResponse {
      * 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
@@ -1032,7 +1037,7 @@ export interface BetaResponse {
     prompt_cache_retention?: 'in_memory' | '24h' | null;
     /**
      * Configuration options for
-     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     * [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
      */
     reasoning?: BetaResponse.Reasoning | null;
     /**
@@ -1041,7 +1046,7 @@ export interface BetaResponse {
      * 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?: string | null;
     /**
@@ -1052,13 +1057,15 @@ export interface BetaResponse {
      *   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
@@ -1080,8 +1087,8 @@ export interface BetaResponse {
      * 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?: BetaResponseTextConfig;
     /**
@@ -1111,7 +1118,7 @@ export interface BetaResponse {
      * 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?: string;
 }
@@ -1267,6 +1274,31 @@ export declare namespace BetaResponse {
             type: 'error';
         }
     }
+    interface CacheMiss {
+        /**
+         * The estimated number of input tokens affected after the first detected
+         * divergence.
+         */
+        cache_missed_tokens: number;
+        /**
+         * The reason prompt cache reuse did not occur.
+         */
+        reason: 'model_changed' | 'prompt_cache_key_changed' | 'tools_changed' | 'text_format_changed' | 'reasoning_effort_changed' | 'verbosity_changed' | 'context_compacted' | 'input_changed' | 'service_tier_changed';
+        type: 'cache_miss';
+        /**
+         * The raw token count of the reusable prefix in the compared response.
+         */
+        comparison_reusable_tokens?: number;
+    }
+    interface CacheHit {
+        type: 'cache_hit';
+    }
+    interface ComparisonResponseNotFound {
+        type: 'comparison_response_not_found';
+    }
+    interface Unavailable {
+        type: 'unavailable';
+    }
     /**
      * The prompt-caching options that were applied to the response. Supported for
      * `gpt-5.6` and later models.
@@ -1280,10 +1312,14 @@ export declare namespace BetaResponse {
          * The minimum lifetime applied to each cache breakpoint.
          */
         ttl: '30m';
+        /**
+         * The response ID supplied as the prompt cache diagnostics comparison.
+         */
+        comparison_response_id?: string | null;
     }
     /**
      * Configuration options for
-     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     * [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
      */
     interface Reasoning {
         /**
@@ -1300,7 +1336,7 @@ export declare namespace BetaResponse {
          * 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.
          */
         effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
@@ -1881,7 +1917,7 @@ export declare namespace BetaResponseCodeInterpreterToolCall {
 }
 /**
  * A compaction item generated by the
- * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+ * [`v1/responses/compact` API](https://developers.openai.com/api/reference/resources/responses/methods/compact).
  */
 export interface BetaResponseCompactionItem {
     /**
@@ -1918,7 +1954,7 @@ export declare namespace BetaResponseCompactionItem {
 }
 /**
  * A compaction item generated by the
- * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+ * [`v1/responses/compact` API](https://developers.openai.com/api/reference/resources/responses/methods/compact).
  */
 export interface BetaResponseCompactionItemParam {
     /**
@@ -1983,7 +2019,7 @@ export declare namespace BetaResponseCompletedEvent {
 }
 /**
  * A tool call to a computer use tool. See the
- * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use)
+ * [computer use guide](https://developers.openai.com/api/docs/guides/tools-computer-use)
  * for more information.
  */
 export interface BetaResponseComputerToolCall {
@@ -2861,7 +2897,7 @@ export declare namespace BetaResponseFileSearchCallSearchingEvent {
 }
 /**
  * The results of a file search tool call. See the
- * [file search guide](https://platform.openai.com/docs/guides/tools-file-search)
+ * [file search guide](https://developers.openai.com/api/docs/guides/tools-file-search)
  * for more information.
  */
 export interface BetaResponseFileSearchToolCall {
@@ -2935,7 +2971,7 @@ export declare namespace BetaResponseFileSearchToolCall {
  *
  * Configuring `{ "type": "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).
  *
  * The default format is `{ "type": "text" }` with no additional options.
  *
@@ -2971,7 +3007,7 @@ export declare namespace BetaResponseFormatTextConfig {
 /**
  * JSON Schema response format. Used to generate structured JSON responses. Learn
  * more about
- * [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs).
+ * [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs).
  */
 export interface BetaResponseFormatTextJSONSchemaConfig {
     /**
@@ -3000,7 +3036,7 @@ export interface BetaResponseFormatTextJSONSchemaConfig {
      * true, the model will always follow the exact schema defined in the `schema`
      * field. Only a subset of JSON Schema is supported when `strict` is `true`. To
      * learn more, read the
-     * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+     * [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
      */
     strict?: boolean | null;
 }
@@ -3056,10 +3092,6 @@ export interface BetaResponseFunctionCallArgumentsDoneEvent {
      * The ID of the item.
      */
     item_id: string;
-    /**
-     * The name of the function that was called.
-     */
-    name: string;
     /**
      * The index of the output item.
      */
@@ -3325,7 +3357,7 @@ export declare namespace BetaResponseFunctionShellToolCallOutput {
 }
 /**
  * A tool call to run a function. See the
- * [function calling guide](https://platform.openai.com/docs/guides/function-calling)
+ * [function calling guide](https://developers.openai.com/api/docs/guides/function-calling)
  * for more information.
  */
 export interface BetaResponseFunctionToolCall {
@@ -3394,7 +3426,7 @@ export declare namespace BetaResponseFunctionToolCall {
 }
 /**
  * A tool call to run a function. See the
- * [function calling guide](https://platform.openai.com/docs/guides/function-calling)
+ * [function calling guide](https://developers.openai.com/api/docs/guides/function-calling)
  * for more information.
  */
 export interface BetaResponseFunctionToolCallItem extends BetaResponseFunctionToolCall {
@@ -3485,8 +3517,8 @@ export declare namespace BetaResponseFunctionToolCallOutputItem {
 }
 /**
  * The results of a web search tool call. See the
- * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for
- * more information.
+ * [web search guide](https://developers.openai.com/api/docs/guides/tools-web-search)
+ * for more information.
  */
 export interface BetaResponseFunctionWebSearch {
     /**
@@ -3501,7 +3533,7 @@ export interface BetaResponseFunctionWebSearch {
     /**
      * The status of the web search tool call.
      */
-    status: 'in_progress' | 'searching' | 'completed' | 'failed';
+    status: 'in_progress' | 'searching' | 'completed' | 'failed' | 'incomplete';
     /**
      * The type of the web search tool call. Always `web_search_call`.
      */
@@ -4076,7 +4108,7 @@ export declare namespace BetaResponseInputFileContent {
 }
 /**
  * An image input to the model. Learn about
- * [image inputs](https://platform.openai.com/docs/guides/vision).
+ * [image inputs](https://developers.openai.com/api/docs/guides/images-vision).
  */
 export interface BetaResponseInputImage {
     /**
@@ -4119,7 +4151,7 @@ export declare namespace BetaResponseInputImage {
 }
 /**
  * An image input to the model. Learn about
- * [image inputs](https://platform.openai.com/docs/guides/vision)
+ * [image inputs](https://developers.openai.com/api/docs/guides/images-vision)
  */
 export interface BetaResponseInputImageContent {
     /**
@@ -4650,6 +4682,15 @@ export declare namespace BetaResponseInputItem {
          * The agent that produced this item.
          */
         agent?: ImageGenerationCall.Agent | null;
+        /**
+         * The quality of the image generated by the image generation tool call. One of
+         * `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+         */
+        quality?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto' | null;
+        /**
+         * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+         */
+        size?: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | null;
     }
     namespace ImageGenerationCall {
         /**
@@ -5863,6 +5904,15 @@ export declare namespace BetaResponseItem {
          * The agent that produced this item.
          */
         agent?: ImageGenerationCall.Agent | null;
+        /**
+         * The quality of the image generated by the image generation tool call. One of
+         * `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+         */
+        quality?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto' | null;
+        /**
+         * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+         */
+        size?: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | null;
     }
     namespace ImageGenerationCall {
         /**
@@ -6844,6 +6894,15 @@ export declare namespace BetaResponseOutputItem {
          * The agent that produced this item.
          */
         agent?: ImageGenerationCall.Agent | null;
+        /**
+         * The quality of the image generated by the image generation tool call. One of
+         * `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+         */
+        quality?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto' | null;
+        /**
+         * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+         */
+        size?: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | null;
     }
     namespace ImageGenerationCall {
         /**
@@ -7573,7 +7632,7 @@ export declare namespace BetaResponseOutputTextAnnotationAddedEvent {
 }
 /**
  * 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).
  */
 export interface BetaResponsePrompt {
     /**
@@ -7629,7 +7688,7 @@ export declare namespace BetaResponseQueuedEvent {
  * A description of the chain of thought used by a reasoning model while generating
  * a response. Be sure to include these items in your `input` to the Responses API
  * for subsequent turns of a conversation if you are manually
- * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+ * [managing context](https://developers.openai.com/api/docs/guides/conversation-state).
  */
 export interface BetaResponseReasoningItem {
     /**
@@ -8844,8 +8903,8 @@ export type BetaResponseStreamEvent = BetaResponseAudioDeltaEvent | BetaResponse
  * 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)
  */
 export interface BetaResponseTextConfig {
     /**
@@ -8853,7 +8912,7 @@ export interface BetaResponseTextConfig {
      *
      * Configuring `{ "type": "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).
      *
      * The default format is `{ "type": "text" }` with no additional options.
      *
@@ -9198,7 +9257,7 @@ export declare namespace BetaResponseUsage {
         cache_write_tokens: number;
         /**
          * The number of tokens that were retrieved from the cache.
-         * [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
+         * [More on prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching).
          */
         cached_tokens: number;
     }
@@ -9343,7 +9402,7 @@ export declare namespace BetaResponsesClientEvent {
         type: 'response.create';
         /**
          * 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?: boolean | null;
         /**
@@ -9383,11 +9442,11 @@ export declare namespace BetaResponsesClientEvent {
          *
          * 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?: string | ResponsesAPI.BetaResponseInput;
         /**
@@ -9401,7 +9460,7 @@ export declare namespace BetaResponsesClientEvent {
         /**
          * 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?: number | null;
         /**
@@ -9426,8 +9485,8 @@ export declare namespace BetaResponsesClientEvent {
          * 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?: 'gpt-6-astra' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.5' | 'gpt-5.5-2026-04-23' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.3-chat-latest' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o3-deep-research' | 'o3-deep-research-2025-06-26' | 'o4-mini-deep-research' | 'o4-mini-deep-research-2025-06-26' | 'computer-use-preview' | 'computer-use-preview-2025-03-11' | 'gpt-5.5-pro' | 'gpt-5.5-pro-2026-04-23' | 'gpt-5-codex' | 'gpt-5-pro' | 'gpt-5-pro-2025-10-06' | 'gpt-5.1-codex-max' | 'gpt-daybreak-blue-latest' | 'gpt-daybreak-red-latest' | 'gpt-5.6-cyber' | (string & {});
         /**
@@ -9445,19 +9504,19 @@ export declare namespace BetaResponsesClientEvent {
         /**
          * 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?: string | null;
         /**
          * 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?: ResponsesAPI.BetaResponsePrompt | null;
         /**
          * 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?: string | null;
         /**
@@ -9468,7 +9527,7 @@ export declare namespace BetaResponsesClientEvent {
          * 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
-         * [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?: ResponseCreate.PromptCacheOptions;
@@ -9478,7 +9537,7 @@ export declare namespace BetaResponsesClientEvent {
          * 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
@@ -9494,7 +9553,7 @@ export declare namespace BetaResponsesClientEvent {
         prompt_cache_retention?: 'in_memory' | '24h' | null;
         /**
          * Configuration options for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+         * [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
          */
         reasoning?: ResponseCreate.Reasoning | null;
         /**
@@ -9503,7 +9562,7 @@ export declare namespace BetaResponsesClientEvent {
          * 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?: string | null;
         /**
@@ -9514,13 +9573,15 @@ export declare namespace BetaResponsesClientEvent {
          *   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
@@ -9535,6 +9596,9 @@ export declare namespace BetaResponsesClientEvent {
         service_tier?: ResponsesAPI.BetaServiceTier | null;
         /**
          * 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](https://developers.openai.com/api/docs/guides/your-data#v1responses).
          */
         store?: boolean | null;
         /**
@@ -9542,7 +9606,7 @@ export declare namespace BetaResponsesClientEvent {
          * generated using
          * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
          * See the
-         * [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+         * [Streaming section below](https://developers.openai.com/api/reference/resources/responses/streaming-events)
          * for more information.
          */
         stream?: boolean | null;
@@ -9569,8 +9633,8 @@ export declare namespace BetaResponsesClientEvent {
          * 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?: ResponsesAPI.BetaResponseTextConfig;
         /**
@@ -9587,17 +9651,18 @@ export declare namespace BetaResponsesClientEvent {
          *
          * - **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?: Array<ResponsesAPI.BetaTool>;
@@ -9631,7 +9696,7 @@ export declare namespace BetaResponsesClientEvent {
          * 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?: string;
     }
@@ -9715,10 +9780,15 @@ export declare namespace BetaResponsesClientEvent {
          * 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
-         * [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.
          */
         interface PromptCacheOptions {
+            /**
+             * The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+             * this field requests prompt cache diagnostics when the feature is enabled.
+             */
+            comparison_response_id?: string | null;
             /**
              * Controls whether OpenAI automatically creates an implicit cache breakpoint.
              * Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -9737,7 +9807,7 @@ export declare namespace BetaResponsesClientEvent {
         }
         /**
          * Configuration options for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+         * [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
          */
         interface Reasoning {
             /**
@@ -9754,7 +9824,7 @@ export declare namespace BetaResponsesClientEvent {
              * 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.
              */
             effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
@@ -10502,13 +10572,15 @@ export declare namespace BetaResponsesServerEvent {
  *   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
@@ -10543,7 +10615,7 @@ export declare namespace BetaTool {
     /**
      * Give the model access to additional tools via remote Model Context Protocol
      * (MCP) servers.
-     * [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
+     * [Learn more about MCP](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
      */
     interface Mcp {
         /**
@@ -10572,7 +10644,7 @@ export declare namespace BetaTool {
          * Identifier for service connectors, like those available in ChatGPT. One of
          * `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
          * service connectors
-         * [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+         * [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
          *
          * Currently supported `connector_id` values are:
          *
@@ -10748,9 +10820,11 @@ export declare namespace BetaTool {
          * 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?: 'transparent' | 'opaque' | 'auto';
         /**
@@ -10767,10 +10841,12 @@ export declare namespace BetaTool {
         input_image_mask?: ImageGeneration.InputImageMask;
         /**
          * The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-         * `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+         * `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`. Default: `gpt-image-1`.
          */
-        model?: (string & {}) | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-2' | 'gpt-image-2-2026-04-21' | 'gpt-image-1.5' | 'chatgpt-image-latest';
+        model?: (string & {}) | 'gpt-image-1' | 'gpt-image-1-mini' | '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' | 'gpt-image-1.5' | 'chatgpt-image-latest';
         /**
          * Moderation level for the generated image. Default: `auto`.
          */
@@ -10790,22 +10866,25 @@ export declare namespace BetaTool {
          */
         partial_images?: number;
         /**
-         * The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-         * Default: `auto`.
-         */
-        quality?: 'low' | 'medium' | 'high' | 'auto';
-        /**
-         * 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 quality of the generated image. 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`. Default:
+         * `auto`.
+         */
+        quality?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto';
+        /**
+         * 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?: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
     }
@@ -10944,12 +11023,12 @@ export interface BetaToolChoiceShell {
 }
 /**
  * Indicates that the model should use a built-in tool to generate a response.
- * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+ * [Learn more about built-in tools](https://developers.openai.com/api/docs/guides/tools).
  */
 export interface BetaToolChoiceTypes {
     /**
      * The type of hosted tool the model should to use. Learn more about
-     * [built-in tools](https://platform.openai.com/docs/guides/tools).
+     * [built-in tools](https://developers.openai.com/api/docs/guides/tools).
      *
      * Allowed values are:
      *
@@ -10987,7 +11066,7 @@ export interface BetaToolSearchTool {
 /**
  * This tool searches the web for relevant results to use in a response. Learn more
  * about the
- * [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+ * [web search tool](https://developers.openai.com/api/docs/guides/tools-web-search).
  */
 export interface BetaWebSearchPreviewTool {
     /**
@@ -11037,7 +11116,7 @@ export declare namespace BetaWebSearchPreviewTool {
 }
 /**
  * Search the Internet for sources related to the prompt. Learn more about the
- * [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+ * [web search tool](https://developers.openai.com/api/docs/guides/tools-web-search).
  */
 export interface BetaWebSearchTool {
     /**
@@ -11109,7 +11188,7 @@ export type ResponseCreateParams = ResponseCreateParamsNonStreaming | ResponseCr
 export interface ResponseCreateParamsBase {
     /**
      * 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?: boolean | null;
     /**
@@ -11150,11 +11229,11 @@ export interface ResponseCreateParamsBase {
      *
      * 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?: string | BetaResponseInput;
     /**
@@ -11168,7 +11247,7 @@ export interface ResponseCreateParamsBase {
     /**
      * 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?: number | null;
     /**
@@ -11193,8 +11272,8 @@ export interface ResponseCreateParamsBase {
      * 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?: 'gpt-6-astra' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.5' | 'gpt-5.5-2026-04-23' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.3-chat-latest' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o3-deep-research' | 'o3-deep-research-2025-06-26' | 'o4-mini-deep-research' | 'o4-mini-deep-research-2025-06-26' | 'computer-use-preview' | 'computer-use-preview-2025-03-11' | 'gpt-5.5-pro' | 'gpt-5.5-pro-2026-04-23' | 'gpt-5-codex' | 'gpt-5-pro' | 'gpt-5-pro-2025-10-06' | 'gpt-5.1-codex-max' | 'gpt-daybreak-blue-latest' | 'gpt-daybreak-red-latest' | 'gpt-5.6-cyber' | (string & {});
     /**
@@ -11213,19 +11292,19 @@ export interface ResponseCreateParamsBase {
     /**
      * 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?: string | null;
     /**
      * 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?: BetaResponsePrompt | null;
     /**
      * 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?: string | null;
     /**
@@ -11237,7 +11316,7 @@ export interface ResponseCreateParamsBase {
      * 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?: ResponseCreateParams.PromptCacheOptions;
@@ -11247,7 +11326,7 @@ export interface ResponseCreateParamsBase {
      * 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
@@ -11263,7 +11342,7 @@ export interface ResponseCreateParamsBase {
     prompt_cache_retention?: 'in_memory' | '24h' | null;
     /**
      * 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?: ResponseCreateParams.Reasoning | null;
     /**
@@ -11272,7 +11351,7 @@ export interface ResponseCreateParamsBase {
      * 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?: string | null;
     /**
@@ -11283,13 +11362,15 @@ export interface ResponseCreateParamsBase {
      *   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
@@ -11304,7 +11385,9 @@ export interface ResponseCreateParamsBase {
     service_tier?: BetaServiceTier | null;
     /**
      * Body param: Whether to store the generated model response for later retrieval
-     * via API.
+     * 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](https://developers.openai.com/api/docs/guides/your-data#v1responses).
      */
     store?: boolean | null;
     /**
@@ -11312,7 +11395,7 @@ export interface ResponseCreateParamsBase {
      * client as it is generated using
      * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
      * See the
-     * [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+     * [Streaming section below](https://developers.openai.com/api/reference/resources/responses/streaming-events)
      * for more information.
      */
     stream?: boolean | null;
@@ -11332,8 +11415,8 @@ export interface ResponseCreateParamsBase {
      * 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?: BetaResponseTextConfig;
     /**
@@ -11350,17 +11433,18 @@ export interface ResponseCreateParamsBase {
      *
      * - **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?: Array<BetaTool>;
@@ -11396,7 +11480,7 @@ export interface ResponseCreateParamsBase {
      * 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?: string;
     /**
@@ -11484,10 +11568,15 @@ export declare namespace ResponseCreateParams {
      * 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
-     * [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.
      */
     interface PromptCacheOptions {
+        /**
+         * The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+         * this field requests prompt cache diagnostics when the feature is enabled.
+         */
+        comparison_response_id?: string | null;
         /**
          * Controls whether OpenAI automatically creates an implicit cache breakpoint.
          * Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -11506,7 +11595,7 @@ export declare namespace ResponseCreateParams {
     }
     /**
      * Configuration options for
-     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     * [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
      */
     interface Reasoning {
         /**
@@ -11523,7 +11612,7 @@ export declare namespace ResponseCreateParams {
          * 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.
          */
         effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
@@ -11580,7 +11669,7 @@ export interface ResponseCreateParamsNonStreaming extends ResponseCreateParamsBa
      * client as it is generated using
      * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
      * See the
-     * [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+     * [Streaming section below](https://developers.openai.com/api/reference/resources/responses/streaming-events)
      * for more information.
      */
     stream?: false | null;
@@ -11591,7 +11680,7 @@ export interface ResponseCreateParamsStreaming extends ResponseCreateParamsBase
      * client as it is generated using
      * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
      * See the
-     * [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+     * [Streaming section below](https://developers.openai.com/api/reference/resources/responses/streaming-events)
      * for more information.
      */
     stream: true;
@@ -11622,7 +11711,7 @@ export interface ResponseRetrieveParamsBase {
      * client as it is generated using
      * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
      * See the
-     * [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+     * [Streaming section below](https://developers.openai.com/api/reference/resources/responses/streaming-events)
      * for more information.
      */
     stream?: boolean;
@@ -11641,7 +11730,7 @@ export interface ResponseRetrieveParamsNonStreaming extends ResponseRetrievePara
      * client as it is generated using
      * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
      * See the
-     * [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+     * [Streaming section below](https://developers.openai.com/api/reference/resources/responses/streaming-events)
      * for more information.
      */
     stream?: false;
@@ -11652,7 +11741,7 @@ export interface ResponseRetrieveParamsStreaming extends ResponseRetrieveParamsB
      * client as it is generated using
      * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
      * See the
-     * [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+     * [Streaming section below](https://developers.openai.com/api/reference/resources/responses/streaming-events)
      * for more information.
      */
     stream: true;
@@ -11674,8 +11763,8 @@ export interface ResponseCompactParams {
      * 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: 'gpt-6-astra' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.5' | 'gpt-5.5-2026-04-23' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.3-chat-latest' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o3-deep-research' | 'o3-deep-research-2025-06-26' | 'o4-mini-deep-research' | 'o4-mini-deep-research-2025-06-26' | 'computer-use-preview' | 'computer-use-preview-2025-03-11' | 'gpt-5.5-pro' | 'gpt-5.5-pro-2026-04-23' | 'gpt-5-codex' | 'gpt-5-pro' | 'gpt-5-pro-2025-10-06' | 'gpt-5.1-codex-max' | 'gpt-daybreak-blue-latest' | 'gpt-daybreak-red-latest' | 'gpt-5.6-cyber' | (string & {}) | null;
     /**
@@ -11693,7 +11782,7 @@ export interface ResponseCompactParams {
     /**
      * 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?: string | null;
@@ -11710,7 +11799,7 @@ export interface ResponseCompactParams {
      * 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?: ResponseCompactParams.PromptCacheOptions | null;
@@ -11725,16 +11814,17 @@ export interface ResponseCompactParams {
      * 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. The response will show `service_tier=priority` regardless of if you
-     * specify `service_tier=fast` or `priority` in your request. - 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?: 'auto' | 'default' | 'fast' | 'flex' | 'priority' | null;
     /**
@@ -11751,7 +11841,7 @@ export declare namespace ResponseCompactParams {
      * 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
-     * [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.
      */
     interface PromptCacheOptions {