@nocobase/plugin-ai 2.2.0-alpha.1 → 2.2.0-alpha.10

package/dist/node_modules/openai/src/resources/evals/runs/runs.ts

@@ -19,6 +19,9 @@ import { CursorPage, type CursorPageParams, PagePromise } from '../../../core/pa
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
+/**
+ * Manage and run evals in the OpenAI platform.
+ */
 export class Runs extends APIResource {
   outputItems: OutputItemsAPI.OutputItems = new OutputItemsAPI.OutputItems(this._client);
 
@@ -28,7 +31,11 @@ export class Runs extends APIResource {
    * schema specified in the config of the evaluation.
    */
   create(evalID: string, body: RunCreateParams, options?: RequestOptions): APIPromise<RunCreateResponse> {
-    return this._client.post(path`/evals/${evalID}/runs`, { body, ...options });
+    return this._client.post(path`/evals/${evalID}/runs`, {
+      body,
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 
   /**
@@ -40,7 +47,10 @@ export class Runs extends APIResource {
     options?: RequestOptions,
   ): APIPromise<RunRetrieveResponse> {
     const { eval_id } = params;
-    return this._client.get(path`/evals/${eval_id}/runs/${runID}`, options);
+    return this._client.get(path`/evals/${eval_id}/runs/${runID}`, {
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 
   /**
@@ -54,6 +64,7 @@ export class Runs extends APIResource {
     return this._client.getAPIList(path`/evals/${evalID}/runs`, CursorPage<RunListResponse>, {
       query,
       ...options,
+      __security: { bearerAuth: true },
     });
   }
 
@@ -62,7 +73,10 @@ export class Runs extends APIResource {
    */
   delete(runID: string, params: RunDeleteParams, options?: RequestOptions): APIPromise<RunDeleteResponse> {
     const { eval_id } = params;
-    return this._client.delete(path`/evals/${eval_id}/runs/${runID}`, options);
+    return this._client.delete(path`/evals/${eval_id}/runs/${runID}`, {
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 
   /**
@@ -70,7 +84,10 @@ export class Runs extends APIResource {
    */
   cancel(runID: string, params: RunCancelParams, options?: RequestOptions): APIPromise<RunCancelResponse> {
     const { eval_id } = params;
-    return this._client.post(path`/evals/${eval_id}/runs/${runID}`, options);
+    return this._client.post(path`/evals/${eval_id}/runs/${runID}`, {
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 }
 

package/dist/node_modules/openai/src/resources/files.ts

@@ -11,11 +11,15 @@ import { APIConnectionTimeoutError } from '../error';
 import { multipartFormRequestOptions } from '../internal/uploads';
 import { path } from '../internal/utils/path';
 
+/**
+ * Files are used to upload documents that can be used with features like Assistants and Fine-tuning.
+ */
 export class Files extends APIResource {
   /**
    * Upload a file that can be used across various endpoints. Individual files can be
    * up to 512 MB, and each project can store up to 2.5 TB of files in total. There
-   * is no organization-wide storage limit.
+   * is no organization-wide storage limit. Uploads to this endpoint are rate-limited
+   * to 1,000 requests per minute per authenticated user.
    *
    * - The Assistants API supports files up to 2 million tokens and of specific file
    *   types. See the
@@ -30,19 +34,28 @@ export class Files extends APIResource {
    * - The Batch API only supports `.jsonl` files up to 200 MB in size. The input
    *   also has a specific required
    *   [format](https://platform.openai.com/docs/api-reference/batch/request-input).
+   * - For Retrieval or `file_search` ingestion, upload files here first. If you need
+   *   to attach multiple uploaded files to the same vector store, use
+   *   [`/vector_stores/{vector_store_id}/file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+   *   instead of attaching them one by one. Vector store attachment has separate
+   *   limits from file upload, including 2,000 attached files per minute per
+   *   organization.
    *
    * Please [contact us](https://help.openai.com/) if you need to increase these
    * storage limits.
    */
   create(body: FileCreateParams, options?: RequestOptions): APIPromise<FileObject> {
-    return this._client.post('/files', multipartFormRequestOptions({ body, ...options }, this._client));
+    return this._client.post(
+      '/files',
+      multipartFormRequestOptions({ body, ...options, __security: { bearerAuth: true } }, this._client),
+    );
   }
 
   /**
    * Returns information about a specific file.
    */
   retrieve(fileID: string, options?: RequestOptions): APIPromise<FileObject> {
-    return this._client.get(path`/files/${fileID}`, options);
+    return this._client.get(path`/files/${fileID}`, { ...options, __security: { bearerAuth: true } });
   }
 
   /**
@@ -52,14 +65,18 @@ export class Files extends APIResource {
     query: FileListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<FileObjectsPage, FileObject> {
-    return this._client.getAPIList('/files', CursorPage<FileObject>, { query, ...options });
+    return this._client.getAPIList('/files', CursorPage<FileObject>, {
+      query,
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 
   /**
    * Delete a file and remove it from all vector stores.
    */
   delete(fileID: string, options?: RequestOptions): APIPromise<FileDeleted> {
-    return this._client.delete(path`/files/${fileID}`, options);
+    return this._client.delete(path`/files/${fileID}`, { ...options, __security: { bearerAuth: true } });
   }
 
   /**
@@ -69,6 +86,7 @@ export class Files extends APIResource {
     return this._client.get(path`/files/${fileID}/content`, {
       ...options,
       headers: buildHeaders([{ Accept: 'application/binary' }, options?.headers]),
+      __security: { bearerAuth: true },
       __binaryResponse: true,
     });
   }

package/dist/node_modules/openai/src/resources/fine-tuning/alpha/graders.ts

@@ -5,6 +5,9 @@ import * as GraderModelsAPI from '../../graders/grader-models';
 import { APIPromise } from '../../../core/api-promise';
 import { RequestOptions } from '../../../internal/request-options';
 
+/**
+ * Manage fine-tuning jobs to tailor a model to your specific training data.
+ */
 export class Graders extends APIResource {
   /**
    * Run a grader.
@@ -24,7 +27,11 @@ export class Graders extends APIResource {
    * ```
    */
   run(body: GraderRunParams, options?: RequestOptions): APIPromise<GraderRunResponse> {
-    return this._client.post('/fine_tuning/alpha/graders/run', { body, ...options });
+    return this._client.post('/fine_tuning/alpha/graders/run', {
+      body,
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 
   /**
@@ -45,7 +52,11 @@ export class Graders extends APIResource {
    * ```
    */
   validate(body: GraderValidateParams, options?: RequestOptions): APIPromise<GraderValidateResponse> {
-    return this._client.post('/fine_tuning/alpha/graders/validate', { body, ...options });
+    return this._client.post('/fine_tuning/alpha/graders/validate', {
+      body,
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 }
 

package/dist/node_modules/openai/src/resources/fine-tuning/checkpoints/checkpoints.ts

@@ -8,6 +8,9 @@ import {
   PermissionCreateResponsesPage,
   PermissionDeleteParams,
   PermissionDeleteResponse,
+  PermissionListParams,
+  PermissionListResponse,
+  PermissionListResponsesPage,
   PermissionRetrieveParams,
   PermissionRetrieveResponse,
   Permissions,
@@ -24,10 +27,13 @@ export declare namespace Checkpoints {
     Permissions as Permissions,
     type PermissionCreateResponse as PermissionCreateResponse,
     type PermissionRetrieveResponse as PermissionRetrieveResponse,
+    type PermissionListResponse as PermissionListResponse,
     type PermissionDeleteResponse as PermissionDeleteResponse,
     type PermissionCreateResponsesPage as PermissionCreateResponsesPage,
+    type PermissionListResponsesPage as PermissionListResponsesPage,
     type PermissionCreateParams as PermissionCreateParams,
     type PermissionRetrieveParams as PermissionRetrieveParams,
+    type PermissionListParams as PermissionListParams,
     type PermissionDeleteParams as PermissionDeleteParams,
   };
 }

package/dist/node_modules/openai/src/resources/fine-tuning/checkpoints/index.ts

@@ -5,9 +5,12 @@ export {
   Permissions,
   type PermissionCreateResponse,
   type PermissionRetrieveResponse,
+  type PermissionListResponse,
   type PermissionDeleteResponse,
   type PermissionCreateParams,
   type PermissionRetrieveParams,
+  type PermissionListParams,
   type PermissionDeleteParams,
   type PermissionCreateResponsesPage,
+  type PermissionListResponsesPage,
 } from './permissions';

package/dist/node_modules/openai/src/resources/fine-tuning/checkpoints/permissions.ts

@@ -2,10 +2,18 @@
 
 import { APIResource } from '../../../core/resource';
 import { APIPromise } from '../../../core/api-promise';
-import { Page, PagePromise } from '../../../core/pagination';
+import {
+  ConversationCursorPage,
+  type ConversationCursorPageParams,
+  Page,
+  PagePromise,
+} from '../../../core/pagination';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
+/**
+ * Manage fine-tuning jobs to tailor a model to your specific training data.
+ */
 export class Permissions extends APIResource {
   /**
    * **NOTE:** Calling this endpoint requires an [admin API key](../admin-api-keys).
@@ -32,7 +40,7 @@ export class Permissions extends APIResource {
     return this._client.getAPIList(
       path`/fine_tuning/checkpoints/${fineTunedModelCheckpoint}/permissions`,
       Page<PermissionCreateResponse>,
-      { body, method: 'post', ...options },
+      { body, method: 'post', ...options, __security: { adminAPIKeyAuth: true } },
     );
   }
 
@@ -42,13 +50,7 @@ export class Permissions extends APIResource {
    * Organization owners can use this endpoint to view all permissions for a
    * fine-tuned model checkpoint.
    *
-   * @example
-   * ```ts
-   * const permission =
-   *   await client.fineTuning.checkpoints.permissions.retrieve(
-   *     'ft-AF1WoRqd3aJAHsqc9NY7iL8F',
-   *   );
-   * ```
+   * @deprecated Retrieve is deprecated. Please swap to the paginated list method instead.
    */
   retrieve(
     fineTunedModelCheckpoint: string,
@@ -58,9 +60,38 @@ export class Permissions extends APIResource {
     return this._client.get(path`/fine_tuning/checkpoints/${fineTunedModelCheckpoint}/permissions`, {
       query,
       ...options,
+      __security: { adminAPIKeyAuth: true },
     });
   }
 
+  /**
+   * **NOTE:** This endpoint requires an [admin API key](../admin-api-keys).
+   *
+   * Organization owners can use this endpoint to view all permissions for a
+   * fine-tuned model checkpoint.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const permissionListResponse of client.fineTuning.checkpoints.permissions.list(
+   *   'ft-AF1WoRqd3aJAHsqc9NY7iL8F',
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    fineTunedModelCheckpoint: string,
+    query: PermissionListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<PermissionListResponsesPage, PermissionListResponse> {
+    return this._client.getAPIList(
+      path`/fine_tuning/checkpoints/${fineTunedModelCheckpoint}/permissions`,
+      ConversationCursorPage<PermissionListResponse>,
+      { query, ...options, __security: { adminAPIKeyAuth: true } },
+    );
+  }
+
   /**
    * **NOTE:** This endpoint requires an [admin API key](../admin-api-keys).
    *
@@ -87,7 +118,7 @@ export class Permissions extends APIResource {
     const { fine_tuned_model_checkpoint } = params;
     return this._client.delete(
       path`/fine_tuning/checkpoints/${fine_tuned_model_checkpoint}/permissions/${permissionID}`,
-      options,
+      { ...options, __security: { adminAPIKeyAuth: true } },
     );
   }
 }
@@ -95,6 +126,8 @@ export class Permissions extends APIResource {
 // Note: no pagination actually occurs yet, this is for forwards-compatibility.
 export type PermissionCreateResponsesPage = Page<PermissionCreateResponse>;
 
+export type PermissionListResponsesPage = ConversationCursorPage<PermissionListResponse>;
+
 /**
  * The `checkpoint.permission` object represents a permission for a fine-tuned
  * model checkpoint.
@@ -161,6 +194,32 @@ export namespace PermissionRetrieveResponse {
   }
 }
 
+/**
+ * The `checkpoint.permission` object represents a permission for a fine-tuned
+ * model checkpoint.
+ */
+export interface PermissionListResponse {
+  /**
+   * The permission identifier, which can be referenced in the API endpoints.
+   */
+  id: string;
+
+  /**
+   * The Unix timestamp (in seconds) for when the permission was created.
+   */
+  created_at: number;
+
+  /**
+   * The object type, which is always "checkpoint.permission".
+   */
+  object: 'checkpoint.permission';
+
+  /**
+   * The project identifier that the permission is for.
+   */
+  project_id: string;
+}
+
 export interface PermissionDeleteResponse {
   /**
    * The ID of the fine-tuned model checkpoint permission that was deleted.
@@ -207,6 +266,18 @@ export interface PermissionRetrieveParams {
   project_id?: string;
 }
 
+export interface PermissionListParams extends ConversationCursorPageParams {
+  /**
+   * The order in which to retrieve permissions.
+   */
+  order?: 'ascending' | 'descending';
+
+  /**
+   * The ID of the project to get permissions for.
+   */
+  project_id?: string;
+}
+
 export interface PermissionDeleteParams {
   /**
    * The ID of the fine-tuned model checkpoint to delete a permission for.
@@ -218,10 +289,13 @@ export declare namespace Permissions {
   export {
     type PermissionCreateResponse as PermissionCreateResponse,
     type PermissionRetrieveResponse as PermissionRetrieveResponse,
+    type PermissionListResponse as PermissionListResponse,
     type PermissionDeleteResponse as PermissionDeleteResponse,
     type PermissionCreateResponsesPage as PermissionCreateResponsesPage,
+    type PermissionListResponsesPage as PermissionListResponsesPage,
     type PermissionCreateParams as PermissionCreateParams,
     type PermissionRetrieveParams as PermissionRetrieveParams,
+    type PermissionListParams as PermissionListParams,
     type PermissionDeleteParams as PermissionDeleteParams,
   };
 }

package/dist/node_modules/openai/src/resources/fine-tuning/jobs/checkpoints.ts

@@ -5,6 +5,9 @@ import { CursorPage, type CursorPageParams, PagePromise } from '../../../core/pa
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
+/**
+ * Manage fine-tuning jobs to tailor a model to your specific training data.
+ */
 export class Checkpoints extends APIResource {
   /**
    * List checkpoints for a fine-tuning job.
@@ -27,7 +30,7 @@ export class Checkpoints extends APIResource {
     return this._client.getAPIList(
       path`/fine_tuning/jobs/${fineTuningJobID}/checkpoints`,
       CursorPage<FineTuningJobCheckpoint>,
-      { query, ...options },
+      { query, ...options, __security: { bearerAuth: true } },
     );
   }
 }

package/dist/node_modules/openai/src/resources/fine-tuning/jobs/jobs.ts

@@ -15,6 +15,9 @@ import { CursorPage, type CursorPageParams, PagePromise } from '../../../core/pa
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
+/**
+ * Manage fine-tuning jobs to tailor a model to your specific training data.
+ */
 export class Jobs extends APIResource {
   checkpoints: CheckpointsAPI.Checkpoints = new CheckpointsAPI.Checkpoints(this._client);
 
@@ -36,7 +39,7 @@ export class Jobs extends APIResource {
    * ```
    */
   create(body: JobCreateParams, options?: RequestOptions): APIPromise<FineTuningJob> {
-    return this._client.post('/fine_tuning/jobs', { body, ...options });
+    return this._client.post('/fine_tuning/jobs', { body, ...options, __security: { bearerAuth: true } });
   }
 
   /**
@@ -52,7 +55,10 @@ export class Jobs extends APIResource {
    * ```
    */
   retrieve(fineTuningJobID: string, options?: RequestOptions): APIPromise<FineTuningJob> {
-    return this._client.get(path`/fine_tuning/jobs/${fineTuningJobID}`, options);
+    return this._client.get(path`/fine_tuning/jobs/${fineTuningJobID}`, {
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 
   /**
@@ -70,7 +76,11 @@ export class Jobs extends APIResource {
     query: JobListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<FineTuningJobsPage, FineTuningJob> {
-    return this._client.getAPIList('/fine_tuning/jobs', CursorPage<FineTuningJob>, { query, ...options });
+    return this._client.getAPIList('/fine_tuning/jobs', CursorPage<FineTuningJob>, {
+      query,
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 
   /**
@@ -84,7 +94,10 @@ export class Jobs extends APIResource {
    * ```
    */
   cancel(fineTuningJobID: string, options?: RequestOptions): APIPromise<FineTuningJob> {
-    return this._client.post(path`/fine_tuning/jobs/${fineTuningJobID}/cancel`, options);
+    return this._client.post(path`/fine_tuning/jobs/${fineTuningJobID}/cancel`, {
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 
   /**
@@ -108,7 +121,7 @@ export class Jobs extends APIResource {
     return this._client.getAPIList(
       path`/fine_tuning/jobs/${fineTuningJobID}/events`,
       CursorPage<FineTuningJobEvent>,
-      { query, ...options },
+      { query, ...options, __security: { bearerAuth: true } },
     );
   }
 
@@ -123,7 +136,10 @@ export class Jobs extends APIResource {
    * ```
    */
   pause(fineTuningJobID: string, options?: RequestOptions): APIPromise<FineTuningJob> {
-    return this._client.post(path`/fine_tuning/jobs/${fineTuningJobID}/pause`, options);
+    return this._client.post(path`/fine_tuning/jobs/${fineTuningJobID}/pause`, {
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 
   /**
@@ -137,7 +153,10 @@ export class Jobs extends APIResource {
    * ```
    */
   resume(fineTuningJobID: string, options?: RequestOptions): APIPromise<FineTuningJob> {
-    return this._client.post(path`/fine_tuning/jobs/${fineTuningJobID}/resume`, options);
+    return this._client.post(path`/fine_tuning/jobs/${fineTuningJobID}/resume`, {
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 }
 

package/dist/node_modules/openai/src/resources/images.ts

@@ -8,6 +8,9 @@ import { type Uploadable } from '../core/uploads';
 import { RequestOptions } from '../internal/request-options';
 import { multipartFormRequestOptions } from '../internal/uploads';
 
+/**
+ * Given a prompt and/or an input image, the model will generate a new image.
+ */
 export class Images extends APIResource {
   /**
    * Creates a variation of a given image. This endpoint only supports `dall-e-2`.
@@ -22,7 +25,7 @@ export class Images extends APIResource {
   createVariation(body: ImageCreateVariationParams, options?: RequestOptions): APIPromise<ImagesResponse> {
     return this._client.post(
       '/images/variations',
-      multipartFormRequestOptions({ body, ...options }, this._client),
+      multipartFormRequestOptions({ body, ...options, __security: { bearerAuth: true } }, this._client),
     );
   }
 
@@ -51,7 +54,10 @@ export class Images extends APIResource {
   ): APIPromise<ImagesResponse> | APIPromise<Stream<ImageEditStreamEvent>> {
     return this._client.post(
       '/images/edits',
-      multipartFormRequestOptions({ body, ...options, stream: body.stream ?? false }, this._client),
+      multipartFormRequestOptions(
+        { body, ...options, stream: body.stream ?? false, __security: { bearerAuth: true } },
+        this._client,
+      ),
     ) as APIPromise<ImagesResponse> | APIPromise<Stream<ImageEditStreamEvent>>;
   }
 
@@ -79,9 +85,12 @@ export class Images extends APIResource {
     body: ImageGenerateParams,
     options?: RequestOptions,
   ): APIPromise<ImagesResponse> | APIPromise<Stream<ImageGenStreamEvent>> {
-    return this._client.post('/images/generations', { body, ...options, stream: body.stream ?? false }) as
-      | APIPromise<ImagesResponse>
-      | APIPromise<Stream<ImageGenStreamEvent>>;
+    return this._client.post('/images/generations', {
+      body,
+      ...options,
+      stream: body.stream ?? false,
+      __security: { bearerAuth: true },
+    }) as APIPromise<ImagesResponse> | APIPromise<Stream<ImageGenStreamEvent>>;
   }
 }
 
@@ -391,7 +400,15 @@ export interface ImageGenPartialImageEvent {
  */
 export type ImageGenStreamEvent = ImageGenPartialImageEvent | ImageGenCompletedEvent;
 
-export type ImageModel = 'gpt-image-1.5' | 'dall-e-2' | 'dall-e-3' | 'gpt-image-1' | 'gpt-image-1-mini';
+export type ImageModel =
+  | 'gpt-image-1'
+  | 'gpt-image-1-mini'
+  | 'gpt-image-2'
+  | 'gpt-image-2-2026-04-21'
+  | 'gpt-image-1.5'
+  | 'chatgpt-image-latest'
+  | 'dall-e-2'
+  | 'dall-e-3';
 
 /**
  * The response from the image generation endpoint.
@@ -544,10 +561,10 @@ 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`, and
-   * `gpt-image-1.5`), each image should be a `png`, `webp`, or `jpg` file less than
-   * 50MB. You can provide up to 16 images. `chatgpt-image-latest` follows the same
-   * input constraints as GPT image models.
+   * 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.
    *
    * For `dall-e-2`, you can only provide one image, and it should be a square `png`
    * file less than 4MB.
@@ -562,9 +579,14 @@ export interface ImageEditParamsBase {
 
   /**
    * Allows to set transparency for the background of the generated image(s). This
-   * parameter is only supported for the GPT image models. 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.
+   * 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.
    *
    * If `transparent`, the output format needs to support transparency, so it should
    * be set to either `png` (default value) or `webp`.
@@ -588,7 +610,10 @@ export interface ImageEditParamsBase {
   mask?: Uploadable;
 
   /**
-   * The model to use for image generation. Defaults to `gpt-image-1.5`.
+   * 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-1.5`.
    */
   model?: (string & {}) | ImageModel | null;
 
@@ -636,11 +661,19 @@ export interface ImageEditParamsBase {
   response_format?: 'url' | 'b64_json' | null;
 
   /**
-   * The size of the generated images. Must be one of `1024x1024`, `1536x1024`
-   * (landscape), `1024x1536` (portrait), or `auto` (default value) for the GPT image
-   * models, and one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`.
+   * 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`.
    */
-  size?: '256x256' | '512x512' | '1024x1024' | '1536x1024' | '1024x1536' | 'auto' | null;
+  size?: (string & {}) | '256x256' | '512x512' | '1024x1024' | '1536x1024' | '1024x1536' | 'auto' | null;
 
   /**
    * Edit the image in streaming mode. Defaults to `false`. See the
@@ -692,9 +725,14 @@ export interface ImageGenerateParamsBase {
 
   /**
    * Allows to set transparency for the background of the generated image(s). This
-   * parameter is only supported for the GPT image models. 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.
+   * 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.
    *
    * If `transparent`, the output format needs to support transparency, so it should
    * be set to either `png` (default value) or `webp`.
@@ -703,8 +741,9 @@ export interface ImageGenerateParamsBase {
 
   /**
    * 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`). Defaults to
-   * `dall-e-2` unless a parameter specific to the GPT image models is used.
+   * 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.
    */
   model?: (string & {}) | ImageModel | null;
 
@@ -764,12 +803,20 @@ export interface ImageGenerateParamsBase {
   response_format?: 'url' | 'b64_json' | null;
 
   /**
-   * The size of the generated images. Must be one of `1024x1024`, `1536x1024`
-   * (landscape), `1024x1536` (portrait), or `auto` (default value) for the GPT image
-   * models, one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`, and one of
-   * `1024x1024`, `1792x1024`, or `1024x1792` for `dall-e-3`.
+   * 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`.
    */
   size?:
+    | (string & {})
     | 'auto'
     | '1024x1024'
     | '1536x1024'