openai 7.5.0 → 7.6.0

package/src/resources/admin/organization/usage.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
+import * as UsageAPI from './usage';
 import { APIPromise } from '../../../core/api-promise';
 import { RequestOptions } from '../../../internal/request-options';
 
@@ -233,6 +234,21 @@ export class Usage extends APIResource {
   }
 }
 
+/**
+ * The unit of the `quantity` value. If no single supported unit applies to the
+ * result, this field is `null`.
+ */
+export type CostQuantityUnit =
+  | (string & {})
+  | 'tokens'
+  | '1000_tokens'
+  | 'duration_seconds'
+  | 'duration_minutes'
+  | 'duration_hours'
+  | 'gibibyte_hours'
+  | 'images'
+  | 'characters';
+
 export interface UsageAudioSpeechesResponse {
   data: Array<UsageAudioSpeechesResponse.Data>;
 
@@ -763,6 +779,12 @@ export namespace UsageAudioSpeechesResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -1314,6 +1336,12 @@ export namespace UsageAudioTranscriptionsResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -1865,6 +1893,12 @@ export namespace UsageCodeInterpreterSessionsResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -2416,6 +2450,12 @@ export namespace UsageCompletionsResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -2967,6 +3007,12 @@ export namespace UsageCostsResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -3518,6 +3564,12 @@ export namespace UsageEmbeddingsResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -4069,6 +4121,12 @@ export namespace UsageFileSearchCallsResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -4620,6 +4678,12 @@ export namespace UsageImagesResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -5171,6 +5235,12 @@ export namespace UsageModerationsResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -5722,6 +5792,12 @@ export namespace UsageVectorStoresResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -6273,6 +6349,12 @@ export namespace UsageWebSearchCallsResponse {
        * result.
        */
       quantity?: number | null;
+
+      /**
+       * The unit of the `quantity` value. If no single supported unit applies to the
+       * result, this field is `null`.
+       */
+      quantity_unit?: UsageAPI.CostQuantityUnit | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -6929,6 +7011,7 @@ export interface UsageWebSearchCallsParams {
 
 export declare namespace Usage {
   export {
+    type CostQuantityUnit as CostQuantityUnit,
     type UsageAudioSpeechesResponse as UsageAudioSpeechesResponse,
     type UsageAudioTranscriptionsResponse as UsageAudioTranscriptionsResponse,
     type UsageCodeInterpreterSessionsResponse as UsageCodeInterpreterSessionsResponse,

package/src/resources/beta/responses/internal-base.ts

@@ -4,6 +4,7 @@ import * as ResponsesAPI from './responses';
 import { OpenAI } from '../../../client';
 import { EventEmitter } from '../../../core/EventEmitter';
 import { OpenAIError } from '../../../core/error';
+import { assertX509WebSocketSupported } from '../../../internal/auth/x509-workload-identity-auth';
 
 import type { RawWebSocketData, ReconnectingEvent, UnsentMessage } from '../../../internal/ws';
 
@@ -100,6 +101,7 @@ export abstract class ResponsesEmitter extends EventEmitter<WebSocketEvents> {
 }
 
 export function buildURL(client: OpenAI, parameters: Record<string, unknown>): URL {
+  assertX509WebSocketSupported(client);
   const { ...query } = parameters;
   const endpoint = '/responses';
   const url = new URL(client.buildURL(endpoint, query, undefined));

package/src/resources/beta/responses/responses.ts

@@ -12438,18 +12438,13 @@ export namespace BetaTool {
     action?: 'generate' | 'edit' | 'auto';
 
     /**
-     * Allows to set transparency for the background of the generated image(s). This
-     * parameter is only supported for GPT image models that support transparent
-     * backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value).
-     * When `auto` is used, the model will automatically determine the best background
-     * for the image.
+     * Allows to set transparency for the background of the generated image(s). Must be
+     * one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
+     * the model will automatically determine the best background for the image.
      *
-     * `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent
-     * backgrounds. Requests with `background` set to `transparent` will return an
-     * error for these models; use `opaque` or `auto` instead.
-     *
-     * If `transparent`, the output format needs to support transparency, so it should
-     * be set to either `png` (default value) or `webp`.
+     * 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';
 
@@ -12468,7 +12463,9 @@ export namespace BetaTool {
     input_image_mask?: ImageGeneration.InputImageMask;
 
     /**
-     * The image generation model to use. Default: `gpt-image-1`.
+     * 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
+     * `chatgpt-image-latest`. Default: `gpt-image-1`.
      */
     model?:
       | (string & {})

package/src/resources/beta/threads/runs/index.ts

@@ -34,10 +34,10 @@ export {
   type FunctionToolCallDelta,
   type MessageCreationStepDetails,
   type RunStep,
-  type RunStepInclude,
   type RunStepDelta,
   type RunStepDeltaEvent,
   type RunStepDeltaMessageDelta,
+  type RunStepInclude,
   type ToolCall,
   type ToolCallDelta,
   type ToolCallDeltaObject,

package/src/resources/beta/threads/runs/runs.ts

@@ -37,7 +37,7 @@ import { Stream } from '../../../../core/streaming';
 import { buildHeaders } from '../../../../internal/headers';
 import { RequestOptions } from '../../../../internal/request-options';
 import { AssistantStream, RunCreateParamsBaseStream } from '../../../../lib/AssistantStream';
-import { sleep } from '../../../../internal/utils/sleep';
+import { pollAssistantRun } from '../../../../lib/assistant-run-polling';
 import { RunSubmitToolOutputsParamsStream } from '../../../../lib/AssistantStream';
 import { path } from '../../../../internal/utils/path';
 
@@ -180,50 +180,7 @@ export class Runs extends APIResource {
     params: RunRetrieveParams,
     options?: RequestOptions & { pollIntervalMs?: number },
   ): Promise<Run> {
-    const headers = buildHeaders([
-      options?.headers,
-      {
-        'X-Stainless-Poll-Helper': 'true',
-        'X-Stainless-Custom-Poll-Interval': options?.pollIntervalMs?.toString() ?? undefined,
-      },
-    ]);
-
-    while (true) {
-      const { data: run, response } = await this.retrieve(runId, params, {
-        ...options,
-        headers: { ...options?.headers, ...headers },
-      }).withResponse();
-
-      switch (run.status) {
-        //If we are in any sort of intermediate state we poll
-        case 'queued':
-        case 'in_progress':
-        case 'cancelling':
-          let sleepInterval = 5000;
-
-          if (options?.pollIntervalMs) {
-            sleepInterval = options.pollIntervalMs;
-          } else {
-            const headerInterval = response.headers.get('openai-poll-after-ms');
-            if (headerInterval) {
-              const headerIntervalMs = parseInt(headerInterval);
-              if (!isNaN(headerIntervalMs)) {
-                sleepInterval = headerIntervalMs;
-              }
-            }
-          }
-          await sleep(sleepInterval);
-          break;
-        //We return the run in any terminal state.
-        case 'requires_action':
-        case 'incomplete':
-        case 'cancelled':
-        case 'completed':
-        case 'failed':
-        case 'expired':
-          return run;
-      }
-    }
+    return await pollAssistantRun(this, runId, params, options);
   }
 
   /**

package/src/resources/chat/completions/completions.ts

@@ -842,6 +842,13 @@ export interface ChatCompletionChunk {
    */
   moderation?: ChatCompletionChunk.Moderation | null;
 
+  /**
+   * An obfuscation string added to normalize the size of streamed chunks as a
+   * mitigation to certain side-channel attacks. The field is included by default and
+   * omitted when `stream_options.include_obfuscation` is `false`.
+   */
+  obfuscation?: string;
+
   /**
    * Specifies the processing type used for serving the request.
    *

package/src/resources/embeddings.ts

@@ -3,7 +3,7 @@
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
-import { loggerFor, toFloat32Array } from '../internal/utils';
+import { createEmbedding } from '../lib/embeddings';
 
 type Base64EmbeddingResponse = Omit<CreateEmbeddingResponse, 'data'> & {
   data: Array<Omit<Embedding, 'embedding'> & { embedding: string }>;
@@ -34,47 +34,7 @@ export class Embeddings extends APIResource {
     body: EmbeddingCreateParams,
     options?: RequestOptions,
   ): APIPromise<CreateEmbeddingResponse | Base64EmbeddingResponse> {
-    const hasUserProvidedEncodingFormat = !!body.encoding_format;
-    // No encoding_format specified, defaulting to base64 for performance reasons
-    // See https://github.com/openai/openai-node/pull/1312
-    let encoding_format: EmbeddingCreateParams['encoding_format'] = hasUserProvidedEncodingFormat
-      ? body.encoding_format
-      : 'base64';
-
-    if (hasUserProvidedEncodingFormat) {
-      loggerFor(this._client).debug('embeddings/user defined encoding_format:', body.encoding_format);
-    }
-
-    const response: APIPromise<CreateEmbeddingResponse> = this._client.post('/embeddings', {
-      body: {
-        ...body,
-        encoding_format: encoding_format as EmbeddingCreateParams['encoding_format'],
-      },
-      ...options,
-      __security: { bearerAuth: true },
-    });
-
-    // if the user specified an encoding_format, return the response as-is
-    if (hasUserProvidedEncodingFormat) {
-      return response;
-    }
-
-    // in this stage, we are sure the user did not specify an encoding_format
-    // and we defaulted to base64 for performance reasons
-    // we are sure then that the response is base64 encoded, let's decode it
-    // the returned result will be a float32 array since this is OpenAI API's default encoding
-    loggerFor(this._client).debug('embeddings/decoding base64 embeddings from base64');
-
-    return (response as APIPromise<CreateEmbeddingResponse>)._thenUnwrap((response) => {
-      if (response && response.data) {
-        response.data.forEach((embeddingBase64Obj) => {
-          const embeddingBase64Str = embeddingBase64Obj.embedding as unknown as string;
-          embeddingBase64Obj.embedding = toFloat32Array(embeddingBase64Str);
-        });
-      }
-
-      return response;
-    });
+    return createEmbedding(this._client, body, options);
   }
 }
 

package/src/resources/files.ts

@@ -6,9 +6,8 @@ import { CursorPage, type CursorPageParams, PagePromise } from '../core/paginati
 import { type Uploadable } from '../core/uploads';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
-import { sleep } from '../internal/utils/sleep';
-import { APIConnectionTimeoutError } from '../error';
 import { multipartFormRequestOptions } from '../internal/uploads';
+import { waitForFileProcessing } from '../lib/file-processing';
 import { path } from '../internal/utils/path';
 
 /**
@@ -98,23 +97,7 @@ export class Files extends APIResource {
     id: string,
     { pollInterval = 5000, maxWait = 30 * 60 * 1000 }: { pollInterval?: number; maxWait?: number } = {},
   ): Promise<FileObject> {
-    const TERMINAL_STATES = new Set(['processed', 'error', 'deleted']);
-
-    const start = Date.now();
-    let file = await this.retrieve(id);
-
-    while (!file.status || !TERMINAL_STATES.has(file.status)) {
-      await sleep(pollInterval);
-
-      file = await this.retrieve(id);
-      if (Date.now() - start > maxWait) {
-        throw new APIConnectionTimeoutError({
-          message: `Giving up on waiting for file ${id} to finish processing after ${maxWait} milliseconds.`,
-        });
-      }
-    }
-
-    return file;
+    return await waitForFileProcessing(this, id, pollInterval, maxWait);
   }
 }
 

package/src/resources/images.ts

@@ -584,18 +584,13 @@ export interface ImageEditParamsBase {
   prompt: string;
 
   /**
-   * Allows to set transparency for the background of the generated image(s). This
-   * parameter is only supported for GPT image models that support transparent
-   * backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value).
-   * When `auto` is used, the model will automatically determine the best background
-   * for the image.
+   * Allows to set transparency for the background of the generated image(s). Must be
+   * one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
+   * the model will automatically determine the best background for the image.
    *
-   * `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent
-   * backgrounds. Requests with `background` set to `transparent` will return an
-   * error for these models; use `opaque` or `auto` instead.
-   *
-   * If `transparent`, the output format needs to support transparency, so it should
-   * be set to either `png` (default value) or `webp`.
+   * 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;
 
@@ -730,18 +725,13 @@ export interface ImageGenerateParamsBase {
   prompt: string;
 
   /**
-   * Allows to set transparency for the background of the generated image(s). This
-   * parameter is only supported for GPT image models that support transparent
-   * backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value).
-   * When `auto` is used, the model will automatically determine the best background
-   * for the image.
-   *
-   * `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent
-   * backgrounds. Requests with `background` set to `transparent` will return an
-   * error for these models; use `opaque` or `auto` instead.
+   * Allows to set transparency for the background of the generated image(s). Must be
+   * one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
+   * the model will automatically determine the best background for the image.
    *
-   * If `transparent`, the output format needs to support transparency, so it should
-   * be set to either `png` (default value) or `webp`.
+   * 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;
 

package/src/resources/realtime/api.md

@@ -139,6 +139,7 @@ Methods:
 
 Methods:
 
+- <code title="post /realtime/calls">client.realtime.calls.<a href="./src/resources/realtime/calls.ts">create</a>({ ...params }) -> Response</code>
 - <code title="post /realtime/calls/{call_id}/accept">client.realtime.calls.<a href="./src/resources/realtime/calls.ts">accept</a>(callID, { ...params }) -> void</code>
 - <code title="post /realtime/calls/{call_id}/hangup">client.realtime.calls.<a href="./src/resources/realtime/calls.ts">hangup</a>(callID) -> void</code>
 - <code title="post /realtime/calls/{call_id}/refer">client.realtime.calls.<a href="./src/resources/realtime/calls.ts">refer</a>(callID, { ...params }) -> void</code>

package/src/resources/realtime/calls.ts

@@ -7,8 +7,41 @@ import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
+import { encodedMultipartFormRequestOptions } from '../../internal/multipart-encoding';
 
 export class Calls extends APIResource {
+  /**
+   * Create a new Realtime API call over WebRTC and receive the SDP answer needed to
+   * complete the peer connection.
+   *
+   * @example
+   * ```ts
+   * await client.realtime.calls.create({
+   *   sdp: 'sdp',
+   * });
+   * ```
+   */
+  create(body: CallCreateParams, options?: RequestOptions): APIPromise<Response> {
+    return this._client.post(
+      '/realtime/calls',
+      encodedMultipartFormRequestOptions(
+        {
+          body,
+          ...options,
+          headers: buildHeaders([{ Accept: 'application/sdp' }, options?.headers]),
+          __security: { bearerAuth: true },
+          __binaryResponse: true,
+        },
+        this._client,
+        {
+          sdp: { content_type: 'application/sdp', json: false },
+          session: { content_type: 'application/json', json: true },
+        },
+        'sdp',
+      ),
+    );
+  }
+
   /**
    * Accept an incoming SIP call and configure the realtime session that will handle
    * it.
@@ -86,6 +119,18 @@ export class Calls extends APIResource {
   }
 }
 
+export interface CallCreateParams {
+  /**
+   * WebRTC Session Description Protocol (SDP) offer generated by the caller.
+   */
+  sdp: string;
+
+  /**
+   * Realtime session object configuration.
+   */
+  session?: RealtimeAPI.RealtimeSessionCreateRequest;
+}
+
 export interface CallAcceptParams {
   /**
    * The type of session to create. Always `realtime` for the Realtime API.
@@ -240,6 +285,7 @@ export interface CallRejectParams {
 
 export declare namespace Calls {
   export {
+    type CallCreateParams as CallCreateParams,
     type CallAcceptParams as CallAcceptParams,
     type CallReferParams as CallReferParams,
     type CallRejectParams as CallRejectParams,

package/src/resources/realtime/index.ts

@@ -1,6 +1,12 @@
 // File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
 
-export { Calls, type CallAcceptParams, type CallReferParams, type CallRejectParams } from './calls';
+export {
+  Calls,
+  type CallCreateParams,
+  type CallAcceptParams,
+  type CallReferParams,
+  type CallRejectParams,
+} from './calls';
 export {
   ClientSecrets,
   type RealtimeSessionCreateResponse,

package/src/resources/realtime/realtime.ts

@@ -5,7 +5,7 @@ import * as RealtimeAPI from './realtime';
 import * as Shared from '../shared';
 import * as TranscriptionsAPI from '../audio/transcriptions';
 import * as CallsAPI from './calls';
-import { CallAcceptParams, CallReferParams, CallRejectParams, Calls } from './calls';
+import { CallAcceptParams, CallCreateParams, CallReferParams, CallRejectParams, Calls } from './calls';
 import * as ClientSecretsAPI from './client-secrets';
 import {
   ClientSecretCreateParams,
@@ -3850,8 +3850,9 @@ export interface RealtimeTranslationInputTranscriptDeltaEvent {
 }
 
 /**
- * Returned when translated output audio is available. Output audio deltas are 200
- * ms frames of PCM16 audio.
+ * Returned when translated output audio is available. The `delta` contains a PCM16
+ * audio chunk whose length can vary. Clients should decode and queue the complete
+ * delta instead of assuming a fixed byte or sample count.
  */
 export interface RealtimeTranslationOutputAudioDeltaEvent {
   /**
@@ -5569,6 +5570,7 @@ export declare namespace Realtime {
 
   export {
     Calls as Calls,
+    type CallCreateParams as CallCreateParams,
     type CallAcceptParams as CallAcceptParams,
     type CallReferParams as CallReferParams,
     type CallRejectParams as CallRejectParams,

package/src/resources/responses/internal-base.ts

@@ -4,6 +4,7 @@ import * as ResponsesAPI from './responses';
 import { OpenAI } from '../../client';
 import { EventEmitter } from '../../core/EventEmitter';
 import { OpenAIError } from '../../core/error';
+import { assertX509WebSocketSupported } from '../../internal/auth/x509-workload-identity-auth';
 
 import type { RawWebSocketData, ReconnectingEvent, UnsentMessage } from '../../internal/ws';
 
@@ -96,6 +97,7 @@ export abstract class ResponsesEmitter extends EventEmitter<WebSocketEvents> {
 }
 
 export function buildURL(client: OpenAI, parameters: Record<string, unknown>): URL {
+  assertX509WebSocketSupported(client);
   const { ...query } = parameters;
   const endpoint = '/responses';
   const url = new URL(client.buildURL(endpoint, query, undefined));

package/src/resources/responses/responses.ts

@@ -9336,18 +9336,13 @@ export namespace Tool {
     action?: 'generate' | 'edit' | 'auto';
 
     /**
-     * Allows to set transparency for the background of the generated image(s). This
-     * parameter is only supported for GPT image models that support transparent
-     * backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value).
-     * When `auto` is used, the model will automatically determine the best background
-     * for the image.
+     * Allows to set transparency for the background of the generated image(s). Must be
+     * one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
+     * the model will automatically determine the best background for the image.
      *
-     * `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent
-     * backgrounds. Requests with `background` set to `transparent` will return an
-     * error for these models; use `opaque` or `auto` instead.
-     *
-     * If `transparent`, the output format needs to support transparency, so it should
-     * be set to either `png` (default value) or `webp`.
+     * 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';
 
@@ -9366,7 +9361,9 @@ export namespace Tool {
     input_image_mask?: ImageGeneration.InputImageMask;
 
     /**
-     * The image generation model to use. Default: `gpt-image-1`.
+     * 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
+     * `chatgpt-image-latest`. Default: `gpt-image-1`.
      */
     model?:
       | (string & {})