openai 7.10.0 → 7.12.1

package/src/resources/images.ts

@@ -31,8 +31,7 @@ export class Images extends APIResource {
 
   /**
    * Creates an edited or extended image given one or more source images and a
-   * prompt. This endpoint supports GPT Image models (`gpt-image-1.5`, `gpt-image-1`,
-   * `gpt-image-1-mini`, and `chatgpt-image-latest`) and `dall-e-2`.
+   * prompt. This endpoint supports GPT Image models and `dall-e-2`.
    *
    * @example
    * ```ts
@@ -151,12 +150,12 @@ export interface ImageEditCompletedEvent {
   /**
    * The quality setting for the edited image.
    */
-  quality: 'low' | 'medium' | 'high' | 'auto';
+  quality: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto';
 
   /**
-   * The size of the edited image.
+   * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
    */
-  size: '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
+  size: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
 
   /**
    * The type of the event. Always `image_edit.completed`.
@@ -247,12 +246,12 @@ export interface ImageEditPartialImageEvent {
   /**
    * The quality setting for the requested edited image.
    */
-  quality: 'low' | 'medium' | 'high' | 'auto';
+  quality: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto';
 
   /**
-   * The size of the requested edited image.
+   * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
    */
-  size: '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
+  size: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
 
   /**
    * The type of the event. Always `image_edit.partial_image`.
@@ -292,12 +291,12 @@ export interface ImageGenCompletedEvent {
   /**
    * The quality setting for the generated image.
    */
-  quality: 'low' | 'medium' | 'high' | 'auto';
+  quality: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto';
 
   /**
-   * The size of the generated image.
+   * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
    */
-  size: '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
+  size: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
 
   /**
    * The type of the event. Always `image_generation.completed`.
@@ -388,12 +387,12 @@ export interface ImageGenPartialImageEvent {
   /**
    * The quality setting for the requested image.
    */
-  quality: 'low' | 'medium' | 'high' | 'auto';
+  quality: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto';
 
   /**
-   * The size of the requested image.
+   * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
    */
-  size: '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
+  size: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
 
   /**
    * The type of the event. Always `image_generation.partial_image`.
@@ -411,6 +410,10 @@ export type ImageModel =
   | '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'
   | 'dall-e-2'
@@ -442,15 +445,15 @@ export interface ImagesResponse {
   output_format?: 'png' | 'webp' | 'jpeg';
 
   /**
-   * The quality of the image generated. Either `low`, `medium`, or `high`.
+   * The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
+   * `max`.
    */
-  quality?: 'low' | 'medium' | 'high';
+  quality?: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 
   /**
-   * The size of the image generated. Either `1024x1024`, `1024x1536`, or
-   * `1536x1024`.
+   * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
    */
-  size?: '1024x1024' | '1024x1536' | '1536x1024';
+  size?: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024';
 
   /**
    * For `gpt-image-1` only, the token usage information for the image generation.
@@ -568,9 +571,11 @@ export interface ImageEditParamsBase {
    * The image(s) to edit. Must be a supported image file or an array of images.
    *
    * For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-   * `gpt-image-2`, `gpt-image-2-2026-04-21`, and `chatgpt-image-latest`), each image
-   * should be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to
-   * 16 images.
+   * `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+   * `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+   * `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`), each image should
+   * be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
+   * images.
    *
    * For `dall-e-2`, you can only provide one image, and it should be a square `png`
    * file less than 4MB.
@@ -588,9 +593,11 @@ export interface ImageEditParamsBase {
    * 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' | null;
 
@@ -613,7 +620,9 @@ export interface ImageEditParamsBase {
   /**
    * The model to use for image generation. One of `dall-e-2` or a GPT image model
    * (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
-   * `gpt-image-2-2026-04-21`, or `chatgpt-image-latest`). Defaults to
+   * `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+   * `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+   * `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`). Defaults to
    * `gpt-image-1.5`.
    */
   model?: (string & {}) | ImageModel | null;
@@ -648,10 +657,12 @@ export interface ImageEditParamsBase {
   partial_images?: number | null;
 
   /**
-   * The quality of the image that will be generated for GPT image models. Defaults
-   * to `auto`.
+   * The quality of the image that will be generated for GPT image models. The GPT
+   * image models support `low`, `medium`, and `high`. `gpt-image-2.5-sunburst` and
+   * `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, also support
+   * `xhigh` and `max`. Defaults to `auto`.
    */
-  quality?: 'standard' | 'low' | 'medium' | 'high' | 'auto' | null;
+  quality?: 'standard' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto' | null;
 
   /**
    * The format in which the generated images are returned. Must be one of `url` or
@@ -662,17 +673,18 @@ export interface ImageEditParamsBase {
   response_format?: 'url' | 'b64_json' | null;
 
   /**
-   * The size of the generated images. For `gpt-image-2` and
-   * `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
-   * strings, for example `1536x864`. Width and height must both be divisible by 16
-   * and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
-   * `2560x1440` are experimental, and the maximum supported resolution is
-   * `3840x2160`. The requested size must also satisfy the model's current pixel and
-   * edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
-   * supported by the GPT image models; `auto` is supported for models that allow
-   * automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
-   * `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
-   * `1024x1792`.
+   * The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+   * `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+   * `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+   * resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+   * Width and height must both be divisible by 16 and the requested aspect ratio
+   * must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+   * the maximum supported resolution is `3840x2160`. The requested size must also
+   * satisfy the model's current pixel and edge limits. The standard sizes
+   * `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+   * `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
+   * one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
+   * `1024x1024`, `1792x1024`, or `1024x1792`.
    */
   size?: (string & {}) | '256x256' | '512x512' | '1024x1024' | '1536x1024' | '1024x1536' | 'auto' | null;
 
@@ -729,17 +741,21 @@ export interface ImageGenerateParamsBase {
    * 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' | null;
 
   /**
    * The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
    * image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
-   * or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
-   * to the GPT image models is used.
+   * `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+   * `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+   * `gpt-image-2.5-flare-2026-09-08`). Defaults to `dall-e-2` unless a parameter
+   * specific to the GPT image models is used.
    */
   model?: (string & {}) | ImageModel | null;
 
@@ -785,10 +801,12 @@ export interface ImageGenerateParamsBase {
    * - `auto` (default value) will automatically select the best quality for the
    *   given model.
    * - `high`, `medium` and `low` are supported for the GPT image models.
+   * - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
+   *   `2026-09-08` snapshots, also support `xhigh` and `max`.
    * - `hd` and `standard` are supported for `dall-e-3`.
    * - `standard` is the only option for `dall-e-2`.
    */
-  quality?: 'standard' | 'hd' | 'low' | 'medium' | 'high' | 'auto' | null;
+  quality?: 'standard' | 'hd' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto' | null;
 
   /**
    * The format in which generated images with `dall-e-2` and `dall-e-3` are
@@ -799,17 +817,18 @@ export interface ImageGenerateParamsBase {
   response_format?: 'url' | 'b64_json' | null;
 
   /**
-   * The size of the generated images. For `gpt-image-2` and
-   * `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
-   * strings, for example `1536x864`. Width and height must both be divisible by 16
-   * and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
-   * `2560x1440` are experimental, and the maximum supported resolution is
-   * `3840x2160`. The requested size must also satisfy the model's current pixel and
-   * edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
-   * supported by the GPT image models; `auto` is supported for models that allow
-   * automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
-   * `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
-   * `1024x1792`.
+   * The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+   * `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+   * `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+   * resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+   * Width and height must both be divisible by 16 and the requested aspect ratio
+   * must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+   * the maximum supported resolution is `3840x2160`. The requested size must also
+   * satisfy the model's current pixel and edge limits. The standard sizes
+   * `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+   * `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
+   * one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
+   * `1024x1024`, `1792x1024`, or `1024x1792`.
    */
   size?:
     | (string & {})

package/src/resources/responses/responses.ts

@@ -1212,6 +1212,15 @@ export interface Response {
    */
   prompt?: ResponsePrompt | null;
 
+  /**
+   * Prompt cache diagnostics requested for this response.
+   */
+  prompt_cache_diagnostics?:
+    | Response.CacheMiss
+    | Response.CacheHit
+    | Response.ComparisonResponseNotFound
+    | Response.Unavailable;
+
   /**
    * Used by OpenAI to cache responses for similar requests to optimize your cache
    * hit rates. Replaces the `user` field.
@@ -1502,6 +1511,47 @@ export namespace Response {
     }
   }
 
+  export 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;
+  }
+
+  export interface CacheHit {
+    type: 'cache_hit';
+  }
+
+  export interface ComparisonResponseNotFound {
+    type: 'comparison_response_not_found';
+  }
+
+  export interface Unavailable {
+    type: 'unavailable';
+  }
+
   /**
    * The prompt-caching options that were applied to the response. Supported for
    * `gpt-5.6` and later models.
@@ -1516,6 +1566,11 @@ export namespace Response {
      * 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;
   }
 }
 
@@ -3237,11 +3292,6 @@ export interface ResponseFunctionCallArgumentsDoneEvent {
    */
   item_id: string;
 
-  /**
-   * The name of the function that was called.
-   */
-  name: string;
-
   /**
    * The index of the output item.
    */
@@ -3694,7 +3744,7 @@ export interface ResponseFunctionWebSearch {
   /**
    * 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`.
@@ -4524,6 +4574,17 @@ export namespace ResponseInputItem {
      * The type of the image generation call. Always `image_generation_call`.
      */
     type: 'image_generation_call';
+
+    /**
+     * 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;
   }
 
   /**
@@ -5430,6 +5491,17 @@ export namespace ResponseItem {
      * The type of the image generation call. Always `image_generation_call`.
      */
     type: 'image_generation_call';
+
+    /**
+     * 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;
   }
 
   /**
@@ -6071,6 +6143,17 @@ export namespace ResponseOutputItem {
      * The type of the image generation call. Always `image_generation_call`.
      */
     type: 'image_generation_call';
+
+    /**
+     * 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;
   }
 
   /**
@@ -8720,6 +8803,9 @@ export namespace ResponsesClientEvent {
 
     /**
      * 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).
      */
     store?: boolean | null;
 
@@ -8915,6 +9001,12 @@ export namespace ResponsesClientEvent {
      * for current details.
      */
     export 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
@@ -10086,9 +10178,11 @@ export namespace Tool {
      * 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';
 
@@ -10108,7 +10202,9 @@ export namespace Tool {
 
     /**
      * 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?:
@@ -10117,6 +10213,10 @@ export namespace Tool {
       | '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';
 
@@ -10143,23 +10243,26 @@ export namespace Tool {
     partial_images?: number;
 
     /**
-     * The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-     * Default: `auto`.
+     * 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' | 'auto';
+    quality?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | '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 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';
   }
@@ -10714,6 +10817,9 @@ export interface ResponseCreateParamsBase {
 
   /**
    * 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).
    */
   store?: boolean | null;
 
@@ -10900,6 +11006,12 @@ export namespace ResponseCreateParams {
    * for current details.
    */
   export 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
@@ -11201,12 +11313,13 @@ export interface ResponseCompactParams {
    * 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.
+   * 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;
 }

package/src/resources/webhooks/webhooks.ts

@@ -538,8 +538,8 @@ export namespace LiveCallIncomingWebhookEvent {
    */
   export interface Data {
     /**
-     * The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-     * as `call_id` in `realtime.call.incoming`.
+     * The `live_...` ID of the pending SIP session. Forward this value unchanged when
+     * accepting or rejecting the call through the Live API.
      */
     session_id: string;
 
@@ -605,8 +605,10 @@ export namespace RealtimeCallIncomingWebhookEvent {
    */
   export interface Data {
     /**
-     * The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-     * as `session_id` in `live.call.incoming`.
+     * The Transceiver `rtc_...` ID of the pending SIP session. The paired
+     * `live.call.incoming` event derives its `session_id` by replacing the `rtc_`
+     * prefix with `live_`. Use the ID returned by the event with the corresponding
+     * Realtime or Live API.
      */
     call_id: string;
 

package/src/version.ts

@@ -1,2 +1,2 @@
 /** Version of the installed OpenAI SDK package. */
-export const VERSION = '7.10.0'; // x-release-please-version
+export const VERSION = '7.12.1'; // x-release-please-version

package/version.d.mts

@@ -1,3 +1,3 @@
 /** Version of the installed OpenAI SDK package. */
-export declare const VERSION = "7.10.0";
+export declare const VERSION = "7.12.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,3 +1,3 @@
 /** Version of the installed OpenAI SDK package. */
-export declare const VERSION = "7.10.0";
+export declare const VERSION = "7.12.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 /** Version of the installed OpenAI SDK package. */
-exports.VERSION = '7.10.0'; // x-release-please-version
+exports.VERSION = '7.12.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,3 +1,3 @@
 /** Version of the installed OpenAI SDK package. */
-export const VERSION = '7.10.0'; // x-release-please-version
+export const VERSION = '7.12.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map