@scenario-labs/sdk 0.3.0 → 1.0.0

package/src/resources/assets/assets.ts

@@ -13,6 +13,13 @@ import {
 import * as PublicAPI from './public';
 import { Public, PublicListParams, PublicListResponse, PublicRetrieveResponse } from './public';
 import { APIPromise } from '../../core/api-promise';
+import {
+  AssetsCursor,
+  type AssetsCursorParams,
+  PagePromise,
+  SnapshotsCursor,
+  type SnapshotsCursorParams,
+} from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -53,8 +60,8 @@ export class Assets extends APIResource {
   list(
     query: AssetListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<AssetListResponse> {
-    return this._client.get('/assets', { query, ...options });
+  ): PagePromise<AssetListResponsesAssetsCursor, AssetListResponse> {
+    return this._client.getAPIList('/assets', AssetsCursor<AssetListResponse>, { query, ...options });
   }
 
   /**
@@ -91,8 +98,12 @@ export class Assets extends APIResource {
     assetID: string,
     query: AssetListSnapshotsParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<AssetListSnapshotsResponse> {
-    return this._client.get(path`/assets/${assetID}/snapshots`, { query, ...options });
+  ): PagePromise<AssetListSnapshotsResponsesSnapshotsCursor, AssetListSnapshotsResponse> {
+    return this._client.getAPIList(
+      path`/assets/${assetID}/snapshots`,
+      SnapshotsCursor<AssetListSnapshotsResponse>,
+      { query, ...options },
+    );
   }
 
   /**
@@ -135,6 +146,10 @@ export class Assets extends APIResource {
   }
 }
 
+export type AssetListResponsesAssetsCursor = AssetsCursor<AssetListResponse>;
+
+export type AssetListSnapshotsResponsesSnapshotsCursor = SnapshotsCursor<AssetListSnapshotsResponse>;
+
 export interface AssetRetrieveResponse {
   asset: AssetRetrieveResponse.Asset;
 }
@@ -2360,96 +2375,269 @@ export namespace AssetUpdateResponse {
 }
 
 export interface AssetListResponse {
-  assets: Array<AssetListResponse.Asset>;
+  /**
+   * The asset ID (example: "asset_GTrL3mq4SXWyMxkOHRxlpw")
+   */
+  id: string;
 
   /**
-   * A token to query the next page of assets
+   * The author user ID (example: "dcf121faaa1a0a0bbbd9ca1b73d62aea")
    */
-  nextPaginationToken?: string;
-}
+  authorId: string;
 
-export namespace AssetListResponse {
-  export interface Asset {
-    /**
-     * The asset ID (example: "asset_GTrL3mq4SXWyMxkOHRxlpw")
-     */
-    id: string;
+  /**
+   * A list of CollectionId this asset belongs to
+   */
+  collectionIds: Array<string>;
 
-    /**
-     * The author user ID (example: "dcf121faaa1a0a0bbbd9ca1b73d62aea")
-     */
-    authorId: string;
+  /**
+   * The asset creation date as an ISO string (example: "2023-02-03T11:19:41.579Z")
+   */
+  createdAt: string;
 
-    /**
-     * A list of CollectionId this asset belongs to
-     */
-    collectionIds: Array<string>;
+  /**
+   * List of edit capabilities
+   */
+  editCapabilities: Array<
+    | 'DETECTION'
+    | 'GENERATIVE_FILL'
+    | 'PIXELATE'
+    | 'PROMPT_EDITING'
+    | 'REFINE'
+    | 'REFRAME'
+    | 'REMOVE_BACKGROUND'
+    | 'SEGMENTATION'
+    | 'UPSCALE'
+    | 'UPSCALE_360'
+    | 'VECTORIZATION'
+  >;
 
-    /**
-     * The asset creation date as an ISO string (example: "2023-02-03T11:19:41.579Z")
-     */
-    createdAt: string;
+  /**
+   * The kind of asset
+   */
+  kind: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
 
-    /**
-     * List of edit capabilities
-     */
-    editCapabilities: Array<
-      | 'DETECTION'
-      | 'GENERATIVE_FILL'
-      | 'PIXELATE'
-      | 'PROMPT_EDITING'
-      | 'REFINE'
-      | 'REFRAME'
-      | 'REMOVE_BACKGROUND'
-      | 'SEGMENTATION'
-      | 'UPSCALE'
-      | 'UPSCALE_360'
-      | 'VECTORIZATION'
-    >;
+  /**
+   * Metadata of the asset with some additional information
+   */
+  metadata: AssetListResponse.Metadata;
 
-    /**
-     * The kind of asset
-     */
-    kind: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
+  /**
+   * The mime type of the asset (example: "image/png")
+   */
+  mimeType: string;
 
-    /**
-     * Metadata of the asset with some additional information
-     */
-    metadata: Asset.Metadata;
+  /**
+   * The owner (project) ID (example: "proj_23tlk332lkht3kl2" or
+   * "team_dlkhgs23tlk3hlkth32lkht3kl2" for old teams)
+   */
+  ownerId: string;
 
-    /**
-     * The mime type of the asset (example: "image/png")
-     */
-    mimeType: string;
+  /**
+   * The privacy of the asset
+   */
+  privacy: 'private' | 'public' | 'unlisted';
 
-    /**
-     * The owner (project) ID (example: "proj_23tlk332lkht3kl2" or
-     * "team_dlkhgs23tlk3hlkth32lkht3kl2" for old teams)
-     */
-    ownerId: string;
+  /**
+   * The properties of the asset, content may depend on the kind of asset returned
+   */
+  properties: AssetListResponse.Properties;
 
-    /**
-     * The privacy of the asset
-     */
-    privacy: 'private' | 'public' | 'unlisted';
+  /**
+   * source of the asset
+   */
+  source:
+    | '3d23d'
+    | '3d23d:texture'
+    | '3d:texture'
+    | '3d:texture:albedo'
+    | '3d:texture:metallic'
+    | '3d:texture:mtl'
+    | '3d:texture:normal'
+    | '3d:texture:roughness'
+    | 'audio2audio'
+    | 'background-removal'
+    | 'canvas'
+    | 'canvas-drawing'
+    | 'canvas-export'
+    | 'detection'
+    | 'generative-fill'
+    | 'image-prompt-editing'
+    | 'img23d'
+    | 'img2img'
+    | 'img2video'
+    | 'inference-control-net'
+    | 'inference-control-net-img'
+    | 'inference-control-net-inpainting'
+    | 'inference-control-net-inpainting-ip-adapter'
+    | 'inference-control-net-ip-adapter'
+    | 'inference-control-net-reference'
+    | 'inference-control-net-texture'
+    | 'inference-img'
+    | 'inference-img-ip-adapter'
+    | 'inference-img-texture'
+    | 'inference-in-paint'
+    | 'inference-in-paint-ip-adapter'
+    | 'inference-reference'
+    | 'inference-reference-texture'
+    | 'inference-txt'
+    | 'inference-txt-ip-adapter'
+    | 'inference-txt-texture'
+    | 'patch'
+    | 'pixelization'
+    | 'reframe'
+    | 'restyle'
+    | 'segment'
+    | 'segmentation-image'
+    | 'segmentation-mask'
+    | 'skybox-3d'
+    | 'skybox-base-360'
+    | 'skybox-hdri'
+    | 'texture'
+    | 'texture:albedo'
+    | 'texture:ao'
+    | 'texture:edge'
+    | 'texture:height'
+    | 'texture:metallic'
+    | 'texture:normal'
+    | 'texture:smoothness'
+    | 'txt23d'
+    | 'txt2audio'
+    | 'txt2img'
+    | 'txt2video'
+    | 'unknown'
+    | 'uploaded'
+    | 'uploaded-3d'
+    | 'uploaded-audio'
+    | 'uploaded-avatar'
+    | 'uploaded-video'
+    | 'upscale'
+    | 'upscale-skybox'
+    | 'upscale-texture'
+    | 'upscale-video'
+    | 'vectorization'
+    | 'video23d'
+    | 'video2img'
+    | 'video2video'
+    | 'voice-clone';
 
-    /**
-     * The properties of the asset, content may depend on the kind of asset returned
-     */
-    properties: Asset.Properties;
+  /**
+   * The actual status
+   */
+  status: 'error' | 'pending' | 'success';
+
+  /**
+   * The associated tags (example: ["sci-fi", "landscape"])
+   */
+  tags: Array<string>;
+
+  /**
+   * The asset last update date as an ISO string (example:
+   * "2023-02-03T11:19:41.579Z")
+   */
+  updatedAt: string;
+
+  /**
+   * Signed URL to get the asset content
+   */
+  url: string;
+
+  /**
+   * Automatic captioning of the asset
+   */
+  automaticCaptioning?: string;
+
+  /**
+   * The description, it will contain in priority:
+   *
+   * - the manual description
+   * - the advanced captioning when the asset is used in training flow
+   * - the automatic captioning
+   */
+  description?: string;
+
+  /**
+   * The embedding of the asset when requested.
+   *
+   * Only available when an asset can be embedded (ie: not Detection maps)
+   */
+  embedding?: Array<number>;
+
+  /**
+   * The video asset's first frame.
+   *
+   * Contains the assetId and the url of the first frame.
+   */
+  firstFrame?: AssetListResponse.FirstFrame;
+
+  /**
+   * Whether the asset is hidden.
+   */
+  isHidden?: boolean;
+
+  /**
+   * The video asset's last frame.
+   *
+   * Contains the assetId and the url of the last frame.
+   */
+  lastFrame?: AssetListResponse.LastFrame;
+
+  /**
+   * The NSFW labels
+   */
+  nsfw?: Array<string>;
+
+  /**
+   * The original file url.
+   *
+   * Contains the url of the original file. without any conversion. Only available
+   * for some specific video, audio and threeD assets. Is only specified if the given
+   * asset data has been replaced with a new file during the creation of the asset.
+   */
+  originalFileUrl?: string;
+
+  /**
+   * The output index of the asset within a job This index is an positive integer
+   * that starts at 0 It is used to differentiate between multiple outputs of the
+   * same job If the job has only one output, this index is 0
+   */
+  outputIndex?: number;
+
+  /**
+   * The asset's preview.
+   *
+   * Contains the assetId and the url of the preview.
+   */
+  preview?: AssetListResponse.Preview;
+
+  /**
+   * The asset's thumbnail.
+   *
+   * Contains the assetId and the url of the thumbnail.
+   */
+  thumbnail?: AssetListResponse.Thumbnail;
+}
+
+export namespace AssetListResponse {
+  /**
+   * Metadata of the asset with some additional information
+   */
+  export interface Metadata {
+    kind: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
 
     /**
-     * source of the asset
+     * The type of the asset. Ex: 'inference-txt2img' will represent an asset generated
+     * from a text to image model
      */
-    source:
+    type:
+      | '3d-texture'
+      | '3d-texture-albedo'
+      | '3d-texture-metallic'
+      | '3d-texture-mtl'
+      | '3d-texture-normal'
+      | '3d-texture-roughness'
       | '3d23d'
-      | '3d23d:texture'
-      | '3d:texture'
-      | '3d:texture:albedo'
-      | '3d:texture:metallic'
-      | '3d:texture:mtl'
-      | '3d:texture:normal'
-      | '3d:texture:roughness'
+      | '3d23d-texture'
       | 'audio2audio'
       | 'background-removal'
       | 'canvas'
@@ -2461,23 +2649,23 @@ export namespace AssetListResponse {
       | 'img23d'
       | 'img2img'
       | 'img2video'
-      | 'inference-control-net'
-      | 'inference-control-net-img'
-      | 'inference-control-net-inpainting'
-      | 'inference-control-net-inpainting-ip-adapter'
-      | 'inference-control-net-ip-adapter'
-      | 'inference-control-net-reference'
-      | 'inference-control-net-texture'
-      | 'inference-img'
-      | 'inference-img-ip-adapter'
-      | 'inference-img-texture'
-      | 'inference-in-paint'
-      | 'inference-in-paint-ip-adapter'
+      | 'inference-controlnet'
+      | 'inference-controlnet-img2img'
+      | 'inference-controlnet-inpaint'
+      | 'inference-controlnet-inpaint-ip-adapter'
+      | 'inference-controlnet-ip-adapter'
+      | 'inference-controlnet-reference'
+      | 'inference-controlnet-texture'
+      | 'inference-img2img'
+      | 'inference-img2img-ip-adapter'
+      | 'inference-img2img-texture'
+      | 'inference-inpaint'
+      | 'inference-inpaint-ip-adapter'
       | 'inference-reference'
       | 'inference-reference-texture'
-      | 'inference-txt'
-      | 'inference-txt-ip-adapter'
-      | 'inference-txt-texture'
+      | 'inference-txt2img'
+      | 'inference-txt2img-ip-adapter'
+      | 'inference-txt2img-texture'
       | 'patch'
       | 'pixelization'
       | 'reframe'
@@ -2489,13 +2677,13 @@ export namespace AssetListResponse {
       | 'skybox-base-360'
       | 'skybox-hdri'
       | 'texture'
-      | 'texture:albedo'
-      | 'texture:ao'
-      | 'texture:edge'
-      | 'texture:height'
-      | 'texture:metallic'
-      | 'texture:normal'
-      | 'texture:smoothness'
+      | 'texture-albedo'
+      | 'texture-ao'
+      | 'texture-edge'
+      | 'texture-height'
+      | 'texture-metallic'
+      | 'texture-normal'
+      | 'texture-smoothness'
       | 'txt23d'
       | 'txt2audio'
       | 'txt2img'
@@ -2517,963 +2705,779 @@ export namespace AssetListResponse {
       | 'voice-clone';
 
     /**
-     * The actual status
+     * How angular is the surface? 0 is like a sphere, 1 is like a mechanical object
      */
-    status: 'error' | 'pending' | 'success';
+    angular?: number;
 
     /**
-     * The associated tags (example: ["sci-fi", "landscape"])
+     * The optional aspect ratio given for the generation, only applicable for some
+     * models
      */
-    tags: Array<string>;
+    aspectRatio?: string;
 
     /**
-     * The asset last update date as an ISO string (example:
-     * "2023-02-03T11:19:41.579Z")
+     * Int to set between 0 and 255 for the opacity of the background in the result
+     * images.
      */
-    updatedAt: string;
+    backgroundOpacity?: number;
 
     /**
-     * Signed URL to get the asset content
+     * The baseModelId that maybe changed at inference time
      */
-    url: string;
+    baseModelId?: string;
 
     /**
-     * Automatic captioning of the asset
+     * A bounding box around the object of interest, in the format [x1, y1, x2, y2].
      */
-    automaticCaptioning?: string;
+    bbox?: Array<number>;
 
     /**
-     * The description, it will contain in priority:
-     *
-     * - the manual description
-     * - the advanced captioning when the asset is used in training flow
-     * - the automatic captioning
+     * Remove small dark spots (i.e. “pepper”) and connect small bright cracks.
      */
-    description?: string;
+    betterQuality?: boolean;
 
     /**
-     * The embedding of the asset when requested.
-     *
-     * Only available when an asset can be embedded (ie: not Detection maps)
+     * The control image already processed by canny detector. Must reference an
+     * existing AssetId.
      */
-    embedding?: Array<number>;
+    cannyStructureImage?: string;
 
     /**
-     * The video asset's first frame.
-     *
-     * Contains the assetId and the url of the first frame.
+     * Activate clustering.
      */
-    firstFrame?: Asset.FirstFrame;
+    clustering?: boolean;
 
     /**
-     * Whether the asset is hidden.
+     * Ensure upscaled tile have the same color histogram as original tile.
      */
-    isHidden?: boolean;
+    colorCorrection?: boolean;
+
+    colorMode?: string;
+
+    colorPrecision?: number;
 
     /**
-     * The video asset's last frame.
-     *
-     * Contains the assetId and the url of the last frame.
+     * Flux Kontext LoRA to style the image. For Flux Kontext Prompt Editing.
      */
-    lastFrame?: Asset.LastFrame;
+    concepts?: Array<Metadata.Concept>;
+
+    contours?: Array<Array<Array<Array<number>>>>;
 
     /**
-     * The NSFW labels
+     * End step for control.
      */
-    nsfw?: Array<string>;
+    controlEnd?: number;
 
     /**
-     * The original file url.
-     *
-     * Contains the url of the original file. without any conversion. Only available
-     * for some specific video, audio and threeD assets. Is only specified if the given
-     * asset data has been replaced with a new file during the creation of the asset.
+     * The date when the asset was copied to a project
      */
-    originalFileUrl?: string;
+    copiedAt?: string;
+
+    cornerThreshold?: number;
 
     /**
-     * The output index of the asset within a job This index is an positive integer
-     * that starts at 0 It is used to differentiate between multiple outputs of the
-     * same job If the job has only one output, this index is 0
+     * Allow the generation of "hallucinations" during the upscale process, which adds
+     * additional details and deviates from the original image. Default: optimized for
+     * your preset and style.
      */
-    outputIndex?: number;
+    creativity?: number;
 
     /**
-     * The asset's preview.
-     *
-     * Contains the assetId and the url of the preview.
+     * Amount of decay in creativity over the upscale process. The lowest the value,
+     * the less the creativity will be preserved over the upscale process.
      */
-    preview?: Asset.Preview;
+    creativityDecay?: number;
 
     /**
-     * The asset's thumbnail.
-     *
-     * Contains the assetId and the url of the thumbnail.
+     * If true, use the default parameters
      */
-    thumbnail?: Asset.Thumbnail;
-  }
+    defaultParameters?: boolean;
 
-  export namespace Asset {
     /**
-     * Metadata of the asset with some additional information
+     * The depth fidelity if a depth image provided
      */
-    export interface Metadata {
-      kind: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
+    depthFidelity?: number;
 
-      /**
-       * The type of the asset. Ex: 'inference-txt2img' will represent an asset generated
-       * from a text to image model
-       */
-      type:
-        | '3d-texture'
-        | '3d-texture-albedo'
-        | '3d-texture-metallic'
-        | '3d-texture-mtl'
-        | '3d-texture-normal'
-        | '3d-texture-roughness'
-        | '3d23d'
-        | '3d23d-texture'
-        | 'audio2audio'
-        | 'background-removal'
-        | 'canvas'
-        | 'canvas-drawing'
-        | 'canvas-export'
-        | 'detection'
-        | 'generative-fill'
-        | 'image-prompt-editing'
-        | 'img23d'
-        | 'img2img'
-        | 'img2video'
-        | 'inference-controlnet'
-        | 'inference-controlnet-img2img'
-        | 'inference-controlnet-inpaint'
-        | 'inference-controlnet-inpaint-ip-adapter'
-        | 'inference-controlnet-ip-adapter'
-        | 'inference-controlnet-reference'
-        | 'inference-controlnet-texture'
-        | 'inference-img2img'
-        | 'inference-img2img-ip-adapter'
-        | 'inference-img2img-texture'
-        | 'inference-inpaint'
-        | 'inference-inpaint-ip-adapter'
-        | 'inference-reference'
-        | 'inference-reference-texture'
-        | 'inference-txt2img'
-        | 'inference-txt2img-ip-adapter'
-        | 'inference-txt2img-texture'
-        | 'patch'
-        | 'pixelization'
-        | 'reframe'
-        | 'restyle'
-        | 'segment'
-        | 'segmentation-image'
-        | 'segmentation-mask'
-        | 'skybox-3d'
-        | 'skybox-base-360'
-        | 'skybox-hdri'
-        | 'texture'
-        | 'texture-albedo'
-        | 'texture-ao'
-        | 'texture-edge'
-        | 'texture-height'
-        | 'texture-metallic'
-        | 'texture-normal'
-        | 'texture-smoothness'
-        | 'txt23d'
-        | 'txt2audio'
-        | 'txt2img'
-        | 'txt2video'
-        | 'unknown'
-        | 'uploaded'
-        | 'uploaded-3d'
-        | 'uploaded-audio'
-        | 'uploaded-avatar'
-        | 'uploaded-video'
-        | 'upscale'
-        | 'upscale-skybox'
-        | 'upscale-texture'
-        | 'upscale-video'
-        | 'vectorization'
-        | 'video23d'
-        | 'video2img'
-        | 'video2video'
-        | 'voice-clone';
-
-      /**
-       * How angular is the surface? 0 is like a sphere, 1 is like a mechanical object
-       */
-      angular?: number;
-
-      /**
-       * The optional aspect ratio given for the generation, only applicable for some
-       * models
-       */
-      aspectRatio?: string;
-
-      /**
-       * Int to set between 0 and 255 for the opacity of the background in the result
-       * images.
-       */
-      backgroundOpacity?: number;
-
-      /**
-       * The baseModelId that maybe changed at inference time
-       */
-      baseModelId?: string;
-
-      /**
-       * A bounding box around the object of interest, in the format [x1, y1, x2, y2].
-       */
-      bbox?: Array<number>;
-
-      /**
-       * Remove small dark spots (i.e. “pepper”) and connect small bright cracks.
-       */
-      betterQuality?: boolean;
-
-      /**
-       * The control image already processed by canny detector. Must reference an
-       * existing AssetId.
-       */
-      cannyStructureImage?: string;
-
-      /**
-       * Activate clustering.
-       */
-      clustering?: boolean;
-
-      /**
-       * Ensure upscaled tile have the same color histogram as original tile.
-       */
-      colorCorrection?: boolean;
-
-      colorMode?: string;
-
-      colorPrecision?: number;
-
-      /**
-       * Flux Kontext LoRA to style the image. For Flux Kontext Prompt Editing.
-       */
-      concepts?: Array<Metadata.Concept>;
-
-      contours?: Array<Array<Array<Array<number>>>>;
-
-      /**
-       * End step for control.
-       */
-      controlEnd?: number;
-
-      /**
-       * The date when the asset was copied to a project
-       */
-      copiedAt?: string;
-
-      cornerThreshold?: number;
-
-      /**
-       * Allow the generation of "hallucinations" during the upscale process, which adds
-       * additional details and deviates from the original image. Default: optimized for
-       * your preset and style.
-       */
-      creativity?: number;
-
-      /**
-       * Amount of decay in creativity over the upscale process. The lowest the value,
-       * the less the creativity will be preserved over the upscale process.
-       */
-      creativityDecay?: number;
-
-      /**
-       * If true, use the default parameters
-       */
-      defaultParameters?: boolean;
-
-      /**
-       * The depth fidelity if a depth image provided
-       */
-      depthFidelity?: number;
-
-      /**
-       * The control image processed by depth estimator. Must reference an existing
-       * AssetId.
-       */
-      depthImage?: string;
-
-      /**
-       * Amount of details to remove or add
-       */
-      detailsLevel?: number;
-
-      /**
-       * The number of pixels to dilate the result masks.
-       */
-      dilate?: number;
-
-      /**
-       * Contrast factor for Grayscale detector
-       */
-      factor?: number;
-
-      filterSpeckle?: number;
-
-      /**
-       * Determine the scale at which the upscale process works.
-       *
-       * - With a small value, the upscale works at the largest scale, resulting in fewer
-       *   added details and more coherent images. Ideal for portraits, for example.
-       * - With a large value, the upscale works at the smallest scale, resulting in more
-       *   added details and more hallucinations. Ideal for landscapes, for example.
-       *
-       * (info): A small value is slower and more expensive to run.
-       */
-      fractality?: number;
-
-      /**
-       * Apply extra control to the Skybox 360 geometry. The higher the value, the more
-       * the 360 geometry will influence the generated skybox image.
-       *
-       * Use with caution. Default is adapted to the other parameters.
-       */
-      geometryEnforcement?: number;
-
-      /**
-       * The guidance used to generate this asset
-       */
-      guidance?: number;
-
-      halfMode?: boolean;
-
-      hdr?: number;
-
-      height?: number;
-
-      /**
-       * High threshold for Canny detector
-       */
-      highThreshold?: number;
-
-      /**
-       * (deprecated) Horizontal expansion ratio.
-       */
-      horizontalExpansionRatio?: number;
+    /**
+     * The control image processed by depth estimator. Must reference an existing
+     * AssetId.
+     */
+    depthImage?: string;
 
-      /**
-       * The input image to process. Must reference an existing AssetId or be a data URL.
-       */
-      image?: string;
+    /**
+     * Amount of details to remove or add
+     */
+    detailsLevel?: number;
 
-      /**
-       * Strengthen the similarity to the original image during the upscale. Default:
-       * optimized for your preset and style.
-       */
-      imageFidelity?: number;
+    /**
+     * The number of pixels to dilate the result masks.
+     */
+    dilate?: number;
 
-      /**
-       * Preserve the seamless properties of skybox or texture images. Input has to be of
-       * same type (seamless).
-       */
-      imageType?: 'seamfull' | 'skybox' | 'texture';
+    /**
+     * Contrast factor for Grayscale detector
+     */
+    factor?: number;
 
-      /**
-       * The id of the Inference describing how this image was generated
-       */
-      inferenceId?: string;
+    filterSpeckle?: number;
 
-      /**
-       * When set to `high`, allows to better preserve details from the input images in
-       * the output. This is especially useful when using images that contain elements
-       * like faces or logos that require accurate preservation in the generated image.
-       *
-       * You can provide multiple input images that will all be preserved with high
-       * fidelity, but keep in mind that the first image will be preserved with richer
-       * textures and finer details, so if you include elements such as faces, consider
-       * placing them in the first image.
-       *
-       * Only available for the `gpt-image-1` model.
-       */
-      inputFidelity?: 'high' | 'low';
+    /**
+     * Determine the scale at which the upscale process works.
+     *
+     * - With a small value, the upscale works at the largest scale, resulting in fewer
+     *   added details and more coherent images. Ideal for portraits, for example.
+     * - With a large value, the upscale works at the smallest scale, resulting in more
+     *   added details and more hallucinations. Ideal for landscapes, for example.
+     *
+     * (info): A small value is slower and more expensive to run.
+     */
+    fractality?: number;
 
-      /**
-       * Location of the input image in the output.
-       */
-      inputLocation?: 'bottom' | 'left' | 'middle' | 'right' | 'top';
+    /**
+     * Apply extra control to the Skybox 360 geometry. The higher the value, the more
+     * the 360 geometry will influence the generated skybox image.
+     *
+     * Use with caution. Default is adapted to the other parameters.
+     */
+    geometryEnforcement?: number;
 
-      /**
-       * To invert the relief
-       */
-      invert?: boolean;
+    /**
+     * The guidance used to generate this asset
+     */
+    guidance?: number;
 
-      /**
-       * How polished is the surface? 0 is like a rough surface, 1 is like a mirror
-       */
-      keypointThreshold?: number;
+    halfMode?: boolean;
 
-      layerDifference?: number;
+    hdr?: number;
 
-      lengthThreshold?: number;
+    height?: number;
 
-      /**
-       * The ISO timestamp when the lock on the canvas will expire
-       */
-      lockExpiresAt?: string;
+    /**
+     * High threshold for Canny detector
+     */
+    highThreshold?: number;
 
-      /**
-       * Low threshold for Canny detector
-       */
-      lowThreshold?: number;
+    /**
+     * (deprecated) Horizontal expansion ratio.
+     */
+    horizontalExpansionRatio?: number;
 
-      /**
-       * The mask used for the asset generation or editing
-       */
-      mask?: string;
+    /**
+     * The input image to process. Must reference an existing AssetId or be a data URL.
+     */
+    image?: string;
 
-      maxIterations?: number;
+    /**
+     * Strengthen the similarity to the original image during the upscale. Default:
+     * optimized for your preset and style.
+     */
+    imageFidelity?: number;
 
-      /**
-       * Maximum threshold for Grayscale conversion
-       */
-      maxThreshold?: number;
+    /**
+     * Preserve the seamless properties of skybox or texture images. Input has to be of
+     * same type (seamless).
+     */
+    imageType?: 'seamfull' | 'skybox' | 'texture';
 
-      /**
-       * Minimum threshold for Grayscale conversion
-       */
-      minThreshold?: number;
+    /**
+     * The id of the Inference describing how this image was generated
+     */
+    inferenceId?: string;
 
-      /**
-       * Modality to detect
-       */
-      modality?:
-        | 'canny'
-        | 'depth'
-        | 'grayscale'
-        | 'lineart_anime'
-        | 'mlsd'
-        | 'normal'
-        | 'pose'
-        | 'scribble'
-        | 'segmentation'
-        | 'sketch';
+    /**
+     * When set to `high`, allows to better preserve details from the input images in
+     * the output. This is especially useful when using images that contain elements
+     * like faces or logos that require accurate preservation in the generated image.
+     *
+     * You can provide multiple input images that will all be preserved with high
+     * fidelity, but keep in mind that the first image will be preserved with richer
+     * textures and finer details, so if you include elements such as faces, consider
+     * placing them in the first image.
+     *
+     * Only available for the `gpt-image-1` model.
+     */
+    inputFidelity?: 'high' | 'low';
 
-      mode?: string;
+    /**
+     * Location of the input image in the output.
+     */
+    inputLocation?: 'bottom' | 'left' | 'middle' | 'right' | 'top';
 
-      /**
-       * The modelId used to generate this asset
-       */
-      modelId?: string;
+    /**
+     * To invert the relief
+     */
+    invert?: boolean;
 
-      /**
-       * The type of the generator used
-       */
-      modelType?:
-        | 'custom'
-        | 'elevenlabs-voice'
-        | 'flux.1'
-        | 'flux.1-composition'
-        | 'flux.1-kontext-dev'
-        | 'flux.1-kontext-lora'
-        | 'flux.1-krea-dev'
-        | 'flux.1-krea-lora'
-        | 'flux.1-lora'
-        | 'flux.1-pro'
-        | 'flux.1.1-pro-ultra'
-        | 'flux.2-dev-edit-lora'
-        | 'flux.2-dev-lora'
-        | 'flux.2-klein-4b-edit-lora'
-        | 'flux.2-klein-4b-lora'
-        | 'flux.2-klein-9b-edit-lora'
-        | 'flux.2-klein-9b-lora'
-        | 'flux.2-klein-base-4b-edit-lora'
-        | 'flux.2-klein-base-4b-lora'
-        | 'flux.2-klein-base-9b-edit-lora'
-        | 'flux.2-klein-base-9b-lora'
-        | 'flux1.1-pro'
-        | 'gpt-image-1'
-        | 'qwen-image-2512-lora'
-        | 'qwen-image-edit-2509-lora'
-        | 'qwen-image-edit-2511-lora'
-        | 'qwen-image-edit-lora'
-        | 'qwen-image-lora'
-        | 'sd-1_5'
-        | 'sd-1_5-composition'
-        | 'sd-1_5-lora'
-        | 'sd-xl'
-        | 'sd-xl-composition'
-        | 'sd-xl-lora'
-        | 'zimage-de-turbo-lora'
-        | 'zimage-lora'
-        | 'zimage-turbo-lora';
+    /**
+     * How polished is the surface? 0 is like a rough surface, 1 is like a mirror
+     */
+    keypointThreshold?: number;
 
-      name?: string;
+    layerDifference?: number;
 
-      nbMasks?: number;
+    lengthThreshold?: number;
 
-      /**
-       * The negative prompt used to generate this asset
-       */
-      negativePrompt?: string;
+    /**
+     * The ISO timestamp when the lock on the canvas will expire
+     */
+    lockExpiresAt?: string;
 
-      /**
-       * Controls the influence of the negative prompt. Default 0 means the negative
-       * prompt has no effect. Higher values increase negative prompt influence. Must
-       * be > 0 if negativePrompt is provided.
-       */
-      negativePromptStrength?: number;
+    /**
+     * Low threshold for Canny detector
+     */
+    lowThreshold?: number;
 
-      /**
-       * The number of denoising steps for each image generation.
-       */
-      numInferenceSteps?: number;
+    /**
+     * The mask used for the asset generation or editing
+     */
+    mask?: string;
 
-      /**
-       * The number of outputs to generate.
-       */
-      numOutputs?: number;
+    maxIterations?: number;
 
-      originalAssetId?: string;
+    /**
+     * Maximum threshold for Grayscale conversion
+     */
+    maxThreshold?: number;
 
-      outputIndex?: number;
+    /**
+     * Minimum threshold for Grayscale conversion
+     */
+    minThreshold?: number;
 
-      /**
-       * Overlap percentage for the output image.
-       */
-      overlapPercentage?: number;
+    /**
+     * Modality to detect
+     */
+    modality?:
+      | 'canny'
+      | 'depth'
+      | 'grayscale'
+      | 'lineart_anime'
+      | 'mlsd'
+      | 'normal'
+      | 'pose'
+      | 'scribble'
+      | 'segmentation'
+      | 'sketch';
 
-      /**
-       * Override the embeddings of the model. Only your prompt and negativePrompt will
-       * be used. Use with caution.
-       */
-      overrideEmbeddings?: boolean;
+    mode?: string;
 
-      parentId?: string;
+    /**
+     * The modelId used to generate this asset
+     */
+    modelId?: string;
 
-      parentJobId?: string;
+    /**
+     * The type of the generator used
+     */
+    modelType?:
+      | 'custom'
+      | 'elevenlabs-voice'
+      | 'flux.1'
+      | 'flux.1-composition'
+      | 'flux.1-kontext-dev'
+      | 'flux.1-kontext-lora'
+      | 'flux.1-krea-dev'
+      | 'flux.1-krea-lora'
+      | 'flux.1-lora'
+      | 'flux.1-pro'
+      | 'flux.1.1-pro-ultra'
+      | 'flux.2-dev-edit-lora'
+      | 'flux.2-dev-lora'
+      | 'flux.2-klein-4b-edit-lora'
+      | 'flux.2-klein-4b-lora'
+      | 'flux.2-klein-9b-edit-lora'
+      | 'flux.2-klein-9b-lora'
+      | 'flux.2-klein-base-4b-edit-lora'
+      | 'flux.2-klein-base-4b-lora'
+      | 'flux.2-klein-base-9b-edit-lora'
+      | 'flux.2-klein-base-9b-lora'
+      | 'flux1.1-pro'
+      | 'gpt-image-1'
+      | 'qwen-image-2512-lora'
+      | 'qwen-image-edit-2509-lora'
+      | 'qwen-image-edit-2511-lora'
+      | 'qwen-image-edit-lora'
+      | 'qwen-image-lora'
+      | 'sd-1_5'
+      | 'sd-1_5-composition'
+      | 'sd-1_5-lora'
+      | 'sd-xl'
+      | 'sd-xl-composition'
+      | 'sd-xl-lora'
+      | 'zimage-de-turbo-lora'
+      | 'zimage-lora'
+      | 'zimage-turbo-lora';
 
-      pathPrecision?: number;
+    name?: string;
 
-      /**
-       * List of points (label, x, y) in the image where label = 0 for background and 1
-       * for object.
-       */
-      points?: Array<Array<number>>;
+    nbMasks?: number;
 
-      /**
-       * How polished is the surface? 0 is like a rough surface, 1 is like a mirror
-       */
-      polished?: number;
+    /**
+     * The negative prompt used to generate this asset
+     */
+    negativePrompt?: string;
 
-      preset?: string;
+    /**
+     * Controls the influence of the negative prompt. Default 0 means the negative
+     * prompt has no effect. Higher values increase negative prompt influence. Must
+     * be > 0 if negativePrompt is provided.
+     */
+    negativePromptStrength?: number;
 
-      progressPercent?: number;
+    /**
+     * The number of denoising steps for each image generation.
+     */
+    numInferenceSteps?: number;
 
-      /**
-       * The prompt that guided the asset generation or editing
-       */
-      prompt?: string;
+    /**
+     * The number of outputs to generate.
+     */
+    numOutputs?: number;
 
-      /**
-       * Increase the fidelity to the prompt during upscale. Default: optimized for your
-       * preset and style.
-       */
-      promptFidelity?: number;
+    originalAssetId?: string;
 
-      /**
-       * How raised is the surface? 0 is flat like water, 1 is like a very rough rock
-       */
-      raised?: number;
+    outputIndex?: number;
 
-      /**
-       * The reference images used for the asset generation or editing
-       */
-      referenceImages?: Array<string>;
+    /**
+     * Overlap percentage for the output image.
+     */
+    overlapPercentage?: number;
 
-      /**
-       * Additional refinement steps before scaling.
-       *
-       * If scalingFactor == 1, the refinement process will be applied (1 +
-       * refinementSteps) times. If scalingFactor > 1, the refinement process will be
-       * applied refinementSteps times.
-       */
-      refinementSteps?: number;
+    /**
+     * Override the embeddings of the model. Only your prompt and negativePrompt will
+     * be used. Use with caution.
+     */
+    overrideEmbeddings?: boolean;
 
-      /**
-       * Remove background for Grayscale detector
-       */
-      removeBackground?: boolean;
+    parentId?: string;
 
-      /**
-       * Size proportion of the input image in the output.
-       */
-      resizeOption?: number;
+    parentJobId?: string;
 
-      /**
-       * Boolean to output the contours.
-       */
-      resultContours?: boolean;
+    pathPrecision?: number;
 
-      /**
-       * Boolean to able output the cut out object.
-       */
-      resultImage?: boolean;
+    /**
+     * List of points (label, x, y) in the image where label = 0 for background and 1
+     * for object.
+     */
+    points?: Array<Array<number>>;
 
-      /**
-       * Boolean to able return the masks (binary image) in the response.
-       */
-      resultMask?: boolean;
+    /**
+     * How polished is the surface? 0 is like a rough surface, 1 is like a mirror
+     */
+    polished?: number;
 
-      rootParentId?: string;
+    preset?: string;
 
-      /**
-       * Save a flipbook of the texture. Deactivated when the input texture is larger
-       * than 2048x2048px
-       */
-      saveFlipbook?: boolean;
+    progressPercent?: number;
 
-      /**
-       * Scaling factor (when `targetWidth` not specified)
-       */
-      scalingFactor?: number;
+    /**
+     * The prompt that guided the asset generation or editing
+     */
+    prompt?: string;
 
-      /**
-       * The scheduler used to generate this asset
-       */
-      scheduler?: string;
+    /**
+     * Increase the fidelity to the prompt during upscale. Default: optimized for your
+     * preset and style.
+     */
+    promptFidelity?: number;
 
-      /**
-       * The seed used to generate this asset. <!> Can be a string or a number in some
-       * cases <!>.
-       */
-      seed?: string;
+    /**
+     * How raised is the surface? 0 is flat like water, 1 is like a very rough rock
+     */
+    raised?: number;
 
-      /**
-       * Sharpen tiles.
-       */
-      sharpen?: boolean;
+    /**
+     * The reference images used for the asset generation or editing
+     */
+    referenceImages?: Array<string>;
 
-      /**
-       * How shiny is the surface? 0 is like a matte surface, 1 is like a diamond
-       */
-      shiny?: number;
+    /**
+     * Additional refinement steps before scaling.
+     *
+     * If scalingFactor == 1, the refinement process will be applied (1 +
+     * refinementSteps) times. If scalingFactor > 1, the refinement process will be
+     * applied refinementSteps times.
+     */
+    refinementSteps?: number;
 
-      size?: number;
+    /**
+     * Remove background for Grayscale detector
+     */
+    removeBackground?: boolean;
 
-      /**
-       * Activate sketch detection instead of canny.
-       */
-      sketch?: boolean;
+    /**
+     * Size proportion of the input image in the output.
+     */
+    resizeOption?: number;
 
-      sourceProjectId?: string;
+    /**
+     * Boolean to output the contours.
+     */
+    resultContours?: boolean;
 
-      spliceThreshold?: number;
+    /**
+     * Boolean to able output the cut out object.
+     */
+    resultImage?: boolean;
 
-      /**
-       * The strength
-       *
-       * Only available for the `flux-kontext` LoRA model.
-       */
-      strength?: number;
+    /**
+     * Boolean to able return the masks (binary image) in the response.
+     */
+    resultMask?: boolean;
 
-      /**
-       * Strength for the input image structure preservation
-       */
-      structureFidelity?: number;
+    rootParentId?: string;
 
-      /**
-       * The control image for structure. A canny detector will be applied to this image.
-       * Must reference an existing AssetId.
-       */
-      structureImage?: string;
+    /**
+     * Save a flipbook of the texture. Deactivated when the input texture is larger
+     * than 2048x2048px
+     */
+    saveFlipbook?: boolean;
 
-      style?:
-        | '3d-cartoon'
-        | '3d-rendered'
-        | 'anime'
-        | 'cartoon'
-        | 'cinematic'
-        | 'claymation'
-        | 'cloud-skydome'
-        | 'comic'
-        | 'cyberpunk'
-        | 'enchanted'
-        | 'fantasy'
-        | 'ink'
-        | 'manga'
-        | 'manga-color'
-        | 'minimalist'
-        | 'neon-tron'
-        | 'oil-painting'
-        | 'pastel'
-        | 'photo'
-        | 'photography'
-        | 'psychedelic'
-        | 'retro-fantasy'
-        | 'scifi-concept-art'
-        | 'space'
-        | 'standard'
-        | 'whimsical';
+    /**
+     * Scaling factor (when `targetWidth` not specified)
+     */
+    scalingFactor?: number;
 
-      /**
-       * The higher the value the more it will look like the style image(s)
-       */
-      styleFidelity?: number;
+    /**
+     * The scheduler used to generate this asset
+     */
+    scheduler?: string;
 
-      /**
-       * List of style images. Most of the time, only one image is enough. It must be
-       * existing AssetIds.
-       */
-      styleImages?: Array<string>;
+    /**
+     * The seed used to generate this asset. <!> Can be a string or a number in some
+     * cases <!>.
+     */
+    seed?: string;
 
-      /**
-       * Condition the influence of the style image(s). The higher the value, the more
-       * the style images will influence the upscaled image.
-       */
-      styleImagesFidelity?: number;
+    /**
+     * Sharpen tiles.
+     */
+    sharpen?: boolean;
 
-      /**
-       * The target height of the output image.
-       */
-      targetHeight?: number;
+    /**
+     * How shiny is the surface? 0 is like a matte surface, 1 is like a diamond
+     */
+    shiny?: number;
 
-      /**
-       * Target width for the upscaled image, take priority over scaling factor
-       */
-      targetWidth?: number;
+    size?: number;
 
-      /**
-       * A textual description / keywords describing the object of interest.
-       */
-      text?: string;
+    /**
+     * Activate sketch detection instead of canny.
+     */
+    sketch?: boolean;
 
-      /**
-       * The asset to convert in texture maps. Must reference an existing AssetId.
-       */
-      texture?: string;
+    sourceProjectId?: string;
 
-      /**
-       * The thumbnail of the canvas
-       */
-      thumbnail?: Metadata.Thumbnail;
+    spliceThreshold?: number;
 
-      /**
-       * If set to true, during the upscaling process, the model will match tiles of the
-       * source image with tiles of the style image(s). This will result in a more
-       * coherent restyle. Works best with style images that have a similar composition.
-       */
-      tileStyle?: boolean;
+    /**
+     * The strength
+     *
+     * Only available for the `flux-kontext` LoRA model.
+     */
+    strength?: number;
 
-      trainingImage?: boolean;
+    /**
+     * Strength for the input image structure preservation
+     */
+    structureFidelity?: number;
 
-      /**
-       * (deprecated) Vertical expansion ratio.
-       */
-      verticalExpansionRatio?: number;
+    /**
+     * The control image for structure. A canny detector will be applied to this image.
+     * Must reference an existing AssetId.
+     */
+    structureImage?: string;
 
-      /**
-       * The width of the rendered image.
-       */
-      width?: number;
-    }
+    style?:
+      | '3d-cartoon'
+      | '3d-rendered'
+      | 'anime'
+      | 'cartoon'
+      | 'cinematic'
+      | 'claymation'
+      | 'cloud-skydome'
+      | 'comic'
+      | 'cyberpunk'
+      | 'enchanted'
+      | 'fantasy'
+      | 'ink'
+      | 'manga'
+      | 'manga-color'
+      | 'minimalist'
+      | 'neon-tron'
+      | 'oil-painting'
+      | 'pastel'
+      | 'photo'
+      | 'photography'
+      | 'psychedelic'
+      | 'retro-fantasy'
+      | 'scifi-concept-art'
+      | 'space'
+      | 'standard'
+      | 'whimsical';
 
-    export namespace Metadata {
-      export interface Concept {
-        /**
-         * The model ID (example: "model_eyVcnFJcR92BxBkz7N6g5w")
-         */
-        modelId: string;
+    /**
+     * The higher the value the more it will look like the style image(s)
+     */
+    styleFidelity?: number;
 
-        /**
-         * The scale of the model (example: 1.0) For Flux Kontext Prompt Editing, the scale
-         * is between 0 and 2.
-         */
-        scale: number;
+    /**
+     * List of style images. Most of the time, only one image is enough. It must be
+     * existing AssetIds.
+     */
+    styleImages?: Array<string>;
 
-        /**
-         * The epoch of the model (example: "000001") Only available for Flux Lora Trained
-         * models
-         */
-        modelEpoch?: string;
-      }
+    /**
+     * Condition the influence of the style image(s). The higher the value, the more
+     * the style images will influence the upscaled image.
+     */
+    styleImagesFidelity?: number;
 
-      /**
-       * The thumbnail of the canvas
-       */
-      export interface Thumbnail {
-        /**
-         * The AssetId of the image used as a thumbnail for the canvas (example:
-         * "asset_GTrL3mq4SXWyMxkOHRxlpw")
-         */
-        assetId: string;
+    /**
+     * The target height of the output image.
+     */
+    targetHeight?: number;
 
-        /**
-         * The url of the image used as a thumbnail for the canvas
-         */
-        url: string;
-      }
-    }
+    /**
+     * Target width for the upscaled image, take priority over scaling factor
+     */
+    targetWidth?: number;
 
     /**
-     * The properties of the asset, content may depend on the kind of asset returned
+     * A textual description / keywords describing the object of interest.
      */
-    export interface Properties {
-      size: number;
+    text?: string;
 
-      /**
-       * Number of animation frames if animations exist
-       */
-      animationFrameCount?: number;
+    /**
+     * The asset to convert in texture maps. Must reference an existing AssetId.
+     */
+    texture?: string;
 
-      /**
-       * Bitrate of the media in bits per second
-       */
-      bitrate?: number;
+    /**
+     * The thumbnail of the canvas
+     */
+    thumbnail?: Metadata.Thumbnail;
 
-      /**
-       * Number of bones if skeleton exists
-       */
-      boneCount?: number;
+    /**
+     * If set to true, during the upscaling process, the model will match tiles of the
+     * source image with tiles of the style image(s). This will result in a more
+     * coherent restyle. Works best with style images that have a similar composition.
+     */
+    tileStyle?: boolean;
 
-      /**
-       * Number of channels of the audio
-       */
-      channels?: number;
+    trainingImage?: boolean;
 
-      /**
-       * Classification of the audio
-       */
-      classification?: 'effect' | 'interview' | 'music' | 'other' | 'sound' | 'speech' | 'text' | 'unknown';
+    /**
+     * (deprecated) Vertical expansion ratio.
+     */
+    verticalExpansionRatio?: number;
 
-      /**
-       * Codec name of the media
-       */
-      codecName?: string;
+    /**
+     * The width of the rendered image.
+     */
+    width?: number;
+  }
 
+  export namespace Metadata {
+    export interface Concept {
       /**
-       * Description of the audio
+       * The model ID (example: "model_eyVcnFJcR92BxBkz7N6g5w")
        */
-      description?: string;
+      modelId: string;
 
       /**
-       * Bounding box dimensions [width, height, depth]
+       * The scale of the model (example: 1.0) For Flux Kontext Prompt Editing, the scale
+       * is between 0 and 2.
        */
-      dimensions?: Array<number>;
+      scale: number;
 
       /**
-       * Duration of the media in seconds
+       * The epoch of the model (example: "000001") Only available for Flux Lora Trained
+       * models
        */
-      duration?: number;
+      modelEpoch?: string;
+    }
 
+    /**
+     * The thumbnail of the canvas
+     */
+    export interface Thumbnail {
       /**
-       * Number of faces/triangles in the mesh
+       * The AssetId of the image used as a thumbnail for the canvas (example:
+       * "asset_GTrL3mq4SXWyMxkOHRxlpw")
        */
-      faceCount?: number;
+      assetId: string;
 
       /**
-       * Format of the mesh file (e.g. 'glb', etc.)
+       * The url of the image used as a thumbnail for the canvas
        */
-      format?: string;
+      url: string;
+    }
+  }
 
-      /**
-       * Frame rate of the video in frames per second
-       */
-      frameRate?: number;
+  /**
+   * The properties of the asset, content may depend on the kind of asset returned
+   */
+  export interface Properties {
+    size: number;
 
-      /**
-       * Whether the mesh has animations
-       */
-      hasAnimations?: boolean;
+    /**
+     * Number of animation frames if animations exist
+     */
+    animationFrameCount?: number;
 
-      /**
-       * Whether the mesh has normal vectors
-       */
-      hasNormals?: boolean;
+    /**
+     * Bitrate of the media in bits per second
+     */
+    bitrate?: number;
 
-      /**
-       * Whether the mesh has bones/skeleton
-       */
-      hasSkeleton?: boolean;
+    /**
+     * Number of bones if skeleton exists
+     */
+    boneCount?: number;
 
-      /**
-       * Whether the mesh has UV coordinates
-       */
-      hasUVs?: boolean;
+    /**
+     * Number of channels of the audio
+     */
+    channels?: number;
 
-      height?: number;
+    /**
+     * Classification of the audio
+     */
+    classification?: 'effect' | 'interview' | 'music' | 'other' | 'sound' | 'speech' | 'text' | 'unknown';
 
-      /**
-       * Number of frames in the video
-       */
-      nbFrames?: number;
+    /**
+     * Codec name of the media
+     */
+    codecName?: string;
 
-      /**
-       * Sample rate of the media in Hz
-       */
-      sampleRate?: number;
+    /**
+     * Description of the audio
+     */
+    description?: string;
 
-      /**
-       * Transcription of the audio
-       */
-      transcription?: Properties.Transcription;
+    /**
+     * Bounding box dimensions [width, height, depth]
+     */
+    dimensions?: Array<number>;
 
-      /**
-       * Number of vertices in the mesh
-       */
-      vertexCount?: number;
+    /**
+     * Duration of the media in seconds
+     */
+    duration?: number;
 
-      width?: number;
-    }
+    /**
+     * Number of faces/triangles in the mesh
+     */
+    faceCount?: number;
 
-    export namespace Properties {
-      /**
-       * Transcription of the audio
-       */
-      export interface Transcription {
-        text: string;
-      }
-    }
+    /**
+     * Format of the mesh file (e.g. 'glb', etc.)
+     */
+    format?: string;
 
     /**
-     * The video asset's first frame.
-     *
-     * Contains the assetId and the url of the first frame.
+     * Frame rate of the video in frames per second
      */
-    export interface FirstFrame {
-      assetId: string;
+    frameRate?: number;
 
-      url: string;
-    }
+    /**
+     * Whether the mesh has animations
+     */
+    hasAnimations?: boolean;
 
     /**
-     * The video asset's last frame.
-     *
-     * Contains the assetId and the url of the last frame.
+     * Whether the mesh has normal vectors
      */
-    export interface LastFrame {
-      assetId: string;
+    hasNormals?: boolean;
 
-      url: string;
-    }
+    /**
+     * Whether the mesh has bones/skeleton
+     */
+    hasSkeleton?: boolean;
 
     /**
-     * The asset's preview.
-     *
-     * Contains the assetId and the url of the preview.
+     * Whether the mesh has UV coordinates
      */
-    export interface Preview {
-      assetId: string;
+    hasUVs?: boolean;
 
-      url: string;
-    }
+    height?: number;
 
     /**
-     * The asset's thumbnail.
-     *
-     * Contains the assetId and the url of the thumbnail.
+     * Number of frames in the video
      */
-    export interface Thumbnail {
-      assetId: string;
+    nbFrames?: number;
 
-      url: string;
+    /**
+     * Sample rate of the media in Hz
+     */
+    sampleRate?: number;
+
+    /**
+     * Transcription of the audio
+     */
+    transcription?: Properties.Transcription;
+
+    /**
+     * Number of vertices in the mesh
+     */
+    vertexCount?: number;
+
+    width?: number;
+  }
+
+  export namespace Properties {
+    /**
+     * Transcription of the audio
+     */
+    export interface Transcription {
+      text: string;
     }
   }
+
+  /**
+   * The video asset's first frame.
+   *
+   * Contains the assetId and the url of the first frame.
+   */
+  export interface FirstFrame {
+    assetId: string;
+
+    url: string;
+  }
+
+  /**
+   * The video asset's last frame.
+   *
+   * Contains the assetId and the url of the last frame.
+   */
+  export interface LastFrame {
+    assetId: string;
+
+    url: string;
+  }
+
+  /**
+   * The asset's preview.
+   *
+   * Contains the assetId and the url of the preview.
+   */
+  export interface Preview {
+    assetId: string;
+
+    url: string;
+  }
+
+  /**
+   * The asset's thumbnail.
+   *
+   * Contains the assetId and the url of the thumbnail.
+   */
+  export interface Thumbnail {
+    assetId: string;
+
+    url: string;
+  }
 }
 
 export type AssetDeleteMultipleResponse = unknown;
@@ -5703,24 +5707,13 @@ export namespace AssetGetBulkResponse {
 }
 
 export interface AssetListSnapshotsResponse {
-  snapshots: Array<AssetListSnapshotsResponse.Snapshot>;
-
-  /**
-   * A token to query the next page of snapshots
-   */
-  nextPaginationToken?: string;
-}
-
-export namespace AssetListSnapshotsResponse {
-  export interface Snapshot {
-    authorId: string;
+  authorId: string;
 
-    hash: string;
+  hash: string;
 
-    rawData: string;
+  rawData: string;
 
-    takenAt: number;
-  }
+  takenAt: number;
 }
 
 export interface AssetLockResponse {
@@ -10078,7 +10071,7 @@ export interface AssetUpdateParams {
   thumbnail?: string;
 }
 
-export interface AssetListParams {
+export interface AssetListParams extends AssetsCursorParams {
   /**
    * List assets generated by a specific author (the user that created the asset)
    */
@@ -10120,11 +10113,6 @@ export interface AssetListParams {
    */
   pageSize?: number;
 
-  /**
-   * A token you received in a previous request to query the next page of items
-   */
-  paginationToken?: string;
-
   /**
    * List all the children assets that were generated from a specific parent asset
    */
@@ -10395,17 +10383,12 @@ export interface AssetGetBulkParams {
   assetIds?: Array<string>;
 }
 
-export interface AssetListSnapshotsParams {
+export interface AssetListSnapshotsParams extends SnapshotsCursorParams {
   /**
    * The number of items to return in the response. The default value is 10, maximum
    * value is 100, minimum value is 10
    */
   pageSize?: number;
-
-  /**
-   * A token you received in a previous request to query the next page of items
-   */
-  paginationToken?: string;
 }
 
 export interface AssetLockParams {
@@ -10519,6 +10502,8 @@ export declare namespace Assets {
     type AssetUnlockResponse as AssetUnlockResponse,
     type AssetUpdateTagsResponse as AssetUpdateTagsResponse,
     type AssetUploadResponse as AssetUploadResponse,
+    type AssetListResponsesAssetsCursor as AssetListResponsesAssetsCursor,
+    type AssetListSnapshotsResponsesSnapshotsCursor as AssetListSnapshotsResponsesSnapshotsCursor,
     type AssetRetrieveParams as AssetRetrieveParams,
     type AssetUpdateParams as AssetUpdateParams,
     type AssetListParams as AssetListParams,