@scenario-labs/sdk 3.2.0 → 3.3.1

package/src/resources/generate.ts

@@ -4,6 +4,7 @@ import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
+import { omitUndefined } from '../internal/utils/values';
 
 export class Generate extends APIResource {
   /**
@@ -11,7 +12,11 @@ export class Generate extends APIResource {
    */
   caption(params: GenerateCaptionParams, options?: RequestOptions): APIPromise<GenerateCaptionResponse> {
     const { dryRun, projectId, ...body } = params;
-    return this._client.post('/generate/caption', { query: { dryRun, projectId }, body, ...options });
+    return this._client.post('/generate/caption', {
+      body,
+      ...options,
+      query: { dryRun, projectId, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -22,7 +27,11 @@ export class Generate extends APIResource {
     options?: RequestOptions,
   ): APIPromise<GenerateDescribeStyleResponse> {
     const { dryRun, projectId, ...body } = params;
-    return this._client.post('/generate/describe-style', { query: { dryRun, projectId }, body, ...options });
+    return this._client.post('/generate/describe-style', {
+      body,
+      ...options,
+      query: { dryRun, projectId, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -32,9 +41,9 @@ export class Generate extends APIResource {
   detect(params: GenerateDetectParams, options?: RequestOptions): APIPromise<GenerateDetectResponse> {
     const { dryRun, originalAssets, projectId, ...body } = params;
     return this._client.post('/generate/detect', {
-      query: { dryRun, originalAssets, projectId },
       body,
       ...options,
+      query: { dryRun, originalAssets, projectId, ...omitUndefined(options?.query) },
     });
   }
 
@@ -44,9 +53,34 @@ export class Generate extends APIResource {
   embed(params: GenerateEmbedParams, options?: RequestOptions): APIPromise<GenerateEmbedResponse> {
     const { dryRun, originalAssets, projectId, ...body } = params;
     return this._client.post('/generate/embed', {
-      query: { dryRun, originalAssets, projectId },
       body,
       ...options,
+      query: { dryRun, originalAssets, projectId, ...omitUndefined(options?.query) },
+    });
+  }
+
+  /**
+   * Check prompts and/or existing assets against the team's enabled IP-detection
+   * filters, without generating anything. Advisory only: the call never blocks and
+   * nothing is stored. The payload is analyzed as ONE input set, so the answer is a
+   * single merged verdict — call the route once per item to know which item trips a
+   * filter. Videos are analyzed through their extracted frames; audio and 3d assets
+   * are returned in `skippedAssetIds` and are never checked. Available on the
+   * Enterprise plan only; a team with no enabled filter gets `evaluatedFilters: 0`
+   * and is charged nothing. Billed on the provider tokens the check sends — the
+   * prompt plus every analyzed image, once per enabled filter — with a 1 CU minimum,
+   * reported under `ipDetection.creativeUnitsCharged` and surfaced in
+   * `GET /v1/usages` as `ip-detection`.
+   */
+  ipDetection(
+    params: GenerateIPDetectionParams,
+    options?: RequestOptions,
+  ): APIPromise<GenerateIPDetectionResponse> {
+    const { dryRun, projectId, ...body } = params;
+    return this._client.post('/generate/ip-detection', {
+      body,
+      ...options,
+      query: { dryRun, projectId, ...omitUndefined(options?.query) },
     });
   }
 
@@ -55,7 +89,11 @@ export class Generate extends APIResource {
    */
   patch(params: GeneratePatchParams, options?: RequestOptions): APIPromise<GeneratePatchResponse> {
     const { originalAssets, projectId, ...body } = params;
-    return this._client.post('/generate/patch', { query: { originalAssets, projectId }, body, ...options });
+    return this._client.post('/generate/patch', {
+      body,
+      ...options,
+      query: { originalAssets, projectId, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -63,7 +101,30 @@ export class Generate extends APIResource {
    */
   prompt(params: GeneratePromptParams, options?: RequestOptions): APIPromise<GeneratePromptResponse> {
     const { dryRun, projectId, ...body } = params;
-    return this._client.post('/generate/prompt', { query: { dryRun, projectId }, body, ...options });
+    return this._client.post('/generate/prompt', {
+      body,
+      ...options,
+      query: { dryRun, projectId, ...omitUndefined(options?.query) },
+    });
+  }
+
+  /**
+   * Verify an image against the applicable brand/style/campaign briefs and generic
+   * AI-quality checks; returns a combined score, verdict, reasons, and suggested
+   * fixes. The verdict is stored on the asset: pass an asset id to re-score it in
+   * place (for example after the brief changed), or a data URL to upload the image
+   * as an asset (deduplicated on content) and score it.
+   */
+  qualityGate(
+    params: GenerateQualityGateParams,
+    options?: RequestOptions,
+  ): APIPromise<GenerateQualityGateResponse> {
+    const { dryRun, originalAssets, projectId, ...body } = params;
+    return this._client.post('/generate/quality-gate', {
+      body,
+      ...options,
+      query: { dryRun, originalAssets, projectId, ...omitUndefined(options?.query) },
+    });
   }
 
   /**
@@ -78,9 +139,9 @@ export class Generate extends APIResource {
   ): APIPromise<GenerateRunModelResponse> {
     const { body, dryRun, ipDetection, projectId } = params;
     return this._client.post(path`/generate/custom/${modelID}`, {
-      query: { dryRun, ipDetection, projectId },
       body: body,
       ...options,
+      query: { dryRun, ipDetection, projectId, ...omitUndefined(options?.query) },
     });
   }
 
@@ -92,7 +153,11 @@ export class Generate extends APIResource {
     options?: RequestOptions,
   ): APIPromise<GenerateTranslateResponse> {
     const { dryRun, projectId, ...body } = params;
-    return this._client.post('/generate/translate', { query: { dryRun, projectId }, body, ...options });
+    return this._client.post('/generate/translate', {
+      body,
+      ...options,
+      query: { dryRun, projectId, ...omitUndefined(options?.query) },
+    });
   }
 }
 
@@ -321,6 +386,7 @@ export namespace GenerateCaptionResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -351,14 +417,15 @@ export namespace GenerateCaptionResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -638,8 +705,7 @@ export namespace GenerateCaptionResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -869,8 +935,7 @@ export namespace GenerateCaptionResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -927,8 +992,7 @@ export namespace GenerateCaptionResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -939,12 +1003,9 @@ export namespace GenerateCaptionResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -962,6 +1023,26 @@ export namespace GenerateCaptionResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -1002,8 +1083,7 @@ export namespace GenerateCaptionResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -1014,12 +1094,9 @@ export namespace GenerateCaptionResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -1037,6 +1114,26 @@ export namespace GenerateCaptionResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -1513,6 +1610,7 @@ export namespace GenerateDescribeStyleResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -1543,14 +1641,15 @@ export namespace GenerateDescribeStyleResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -1830,8 +1929,7 @@ export namespace GenerateDescribeStyleResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -2061,8 +2159,7 @@ export namespace GenerateDescribeStyleResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -2119,8 +2216,7 @@ export namespace GenerateDescribeStyleResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -2131,12 +2227,9 @@ export namespace GenerateDescribeStyleResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -2154,6 +2247,26 @@ export namespace GenerateDescribeStyleResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -2194,8 +2307,7 @@ export namespace GenerateDescribeStyleResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -2206,12 +2318,9 @@ export namespace GenerateDescribeStyleResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -2229,6 +2338,26 @@ export namespace GenerateDescribeStyleResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -2697,6 +2826,7 @@ export namespace GenerateDetectResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -2727,14 +2857,15 @@ export namespace GenerateDetectResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -3014,8 +3145,7 @@ export namespace GenerateDetectResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -3245,8 +3375,7 @@ export namespace GenerateDetectResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -3303,8 +3432,7 @@ export namespace GenerateDetectResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -3315,12 +3443,9 @@ export namespace GenerateDetectResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -3338,6 +3463,26 @@ export namespace GenerateDetectResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -3378,8 +3523,7 @@ export namespace GenerateDetectResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -3390,12 +3534,9 @@ export namespace GenerateDetectResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -3413,6 +3554,26 @@ export namespace GenerateDetectResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -3773,6 +3934,7 @@ export namespace GenerateDetectResponse {
       | 'application/x-zip-compressed'
       | 'application/x.autodesk.fbx'
       | 'application/zip'
+      | 'audio/flac'
       | 'audio/m4a'
       | 'audio/mpeg'
       | 'audio/ogg'
@@ -3803,6 +3965,7 @@ export namespace GenerateDetectResponse {
       | 'model/vnd.collada+xml'
       | 'model/vnd.ms-package.3dmanufacturing-3dmodel+xml'
       | 'model/x-3d-vox'
+      | 'model/x-blender'
       | 'model/x-fbx'
       | 'model/x-maya-ascii'
       | 'model/x-maya-binary'
@@ -4040,6 +4203,12 @@ export namespace GenerateDetectResponse {
        */
       factor?: number;
 
+      /**
+       * The name its parent's files reference it by (an OBJ's MTL, an MTL's texture),
+       * kept as delivered.
+       */
+      fileName?: string;
+
       filterSpeckle?: number;
 
       /**
@@ -4129,6 +4298,11 @@ export namespace GenerateDetectResponse {
        */
       invert?: boolean;
 
+      /**
+       * Its own references (an OBJ's `mtllib`, an MTL's maps) were kept as delivered.
+       */
+      keepsFileNames?: boolean;
+
       /**
        * How polished is the surface? 0 is like a rough surface, 1 is like a mirror
        */
@@ -5257,6 +5431,7 @@ export namespace GenerateEmbedResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -5287,14 +5462,15 @@ export namespace GenerateEmbedResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -5574,8 +5750,7 @@ export namespace GenerateEmbedResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -5805,8 +5980,7 @@ export namespace GenerateEmbedResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -5863,8 +6037,7 @@ export namespace GenerateEmbedResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -5875,12 +6048,9 @@ export namespace GenerateEmbedResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -5898,6 +6068,26 @@ export namespace GenerateEmbedResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -5938,8 +6128,7 @@ export namespace GenerateEmbedResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -5950,12 +6139,9 @@ export namespace GenerateEmbedResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -5973,6 +6159,26 @@ export namespace GenerateEmbedResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -6227,6 +6433,117 @@ export namespace GenerateEmbedResponse {
   }
 }
 
+/**
+ * Response of POST /generate/ip-detection.
+ */
+export interface GenerateIPDetectionResponse {
+  /**
+   * Merged verdict for the whole input set. `action` is always `allowed` or
+   * `flagged` — this route is advisory and blocks nothing — while
+   * `creativeUnitsCharged` and `analyzedImagesCount` report what was billed and what
+   * was actually analyzed.
+   */
+  ipDetection: GenerateIPDetectionResponse.IPDetection;
+
+  /**
+   * Input asset ids excluded from image analysis — audio and 3d assets, or a video
+   * with no extractable frame. Their content was NOT checked.
+   */
+  skippedAssetIds: Array<string>;
+}
+
+export namespace GenerateIPDetectionResponse {
+  /**
+   * Merged verdict for the whole input set. `action` is always `allowed` or
+   * `flagged` — this route is advisory and blocks nothing — while
+   * `creativeUnitsCharged` and `analyzedImagesCount` report what was billed and what
+   * was actually analyzed.
+   */
+  export interface IPDetection {
+    /**
+     * Whether and how detection affected the request.
+     */
+    action: 'allowed' | 'blocked' | 'flagged';
+
+    /**
+     * Number of images the detectors actually analyzed — a video counts as each of its
+     * extracted frames, and an image that could not be read is excluded (and not
+     * billed). Each of them is priced once per enabled filter.
+     */
+    analyzedImagesCount: number;
+
+    /**
+     * IP-detection CU fee, separate from creativeUnitsCost: it follows the provider
+     * tokens the run sends — the prompt plus every analyzed image, once per enabled
+     * filter — with a 1 CU minimum per run.
+     */
+    creativeUnitsCharged: number;
+
+    /**
+     * Number of enabled filters evaluated for this request.
+     */
+    evaluatedFilters: number;
+
+    /**
+     * Per-filter verdicts gathered for this request.
+     */
+    findings: Array<IPDetection.Finding>;
+
+    /**
+     * Whether a filter considered the inputs an IP risk. Independent of `action`: a
+     * request blocked because a detector errored is `blocked` and NOT flagged.
+     */
+    flagged: boolean;
+
+    /**
+     * True if one or more detectors errored while evaluating this request.
+     */
+    hasDetectorError?: boolean;
+  }
+
+  export namespace IPDetection {
+    /**
+     * A single filter's verdict.
+     */
+    export interface Finding {
+      /**
+       * Category of the filter that produced this verdict.
+       */
+      category: 'artist-style' | 'brand-trademark' | 'celebrity-likeness' | 'custom' | 'fictional-character';
+
+      /**
+       * Confidence score from 0 (low) to 1 (high).
+       */
+      confidence: number;
+
+      /**
+       * Identifier of the filter that produced this verdict.
+       */
+      filterId: string;
+
+      /**
+       * Display name of the filter that produced this verdict.
+       */
+      filterName: string;
+
+      /**
+       * Whether this filter considered the request an IP risk.
+       */
+      flagged: boolean;
+
+      /**
+       * Short, user-facing explanation of the verdict.
+       */
+      reason: string;
+
+      /**
+       * Named entities the filter recognized (e.g. characters, brands, people).
+       */
+      entities?: Array<string>;
+    }
+  }
+}
+
 export interface GeneratePatchResponse {
   job: GeneratePatchResponse.Job;
 
@@ -6441,6 +6758,7 @@ export namespace GeneratePatchResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -6471,14 +6789,15 @@ export namespace GeneratePatchResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -6758,8 +7077,7 @@ export namespace GeneratePatchResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -6989,8 +7307,7 @@ export namespace GeneratePatchResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -7047,8 +7364,7 @@ export namespace GeneratePatchResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -7059,12 +7375,9 @@ export namespace GeneratePatchResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -7082,6 +7395,26 @@ export namespace GeneratePatchResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -7122,8 +7455,7 @@ export namespace GeneratePatchResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -7134,12 +7466,9 @@ export namespace GeneratePatchResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -7157,6 +7486,26 @@ export namespace GeneratePatchResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -7517,6 +7866,7 @@ export namespace GeneratePatchResponse {
       | 'application/x-zip-compressed'
       | 'application/x.autodesk.fbx'
       | 'application/zip'
+      | 'audio/flac'
       | 'audio/m4a'
       | 'audio/mpeg'
       | 'audio/ogg'
@@ -7547,6 +7897,7 @@ export namespace GeneratePatchResponse {
       | 'model/vnd.collada+xml'
       | 'model/vnd.ms-package.3dmanufacturing-3dmodel+xml'
       | 'model/x-3d-vox'
+      | 'model/x-blender'
       | 'model/x-fbx'
       | 'model/x-maya-ascii'
       | 'model/x-maya-binary'
@@ -7784,6 +8135,12 @@ export namespace GeneratePatchResponse {
        */
       factor?: number;
 
+      /**
+       * The name its parent's files reference it by (an OBJ's MTL, an MTL's texture),
+       * kept as delivered.
+       */
+      fileName?: string;
+
       filterSpeckle?: number;
 
       /**
@@ -7873,6 +8230,11 @@ export namespace GeneratePatchResponse {
        */
       invert?: boolean;
 
+      /**
+       * Its own references (an OBJ's `mtllib`, an MTL's maps) were kept as delivered.
+       */
+      keepsFileNames?: boolean;
+
       /**
        * How polished is the surface? 0 is like a rough surface, 1 is like a mirror
        */
@@ -9010,6 +9372,7 @@ export namespace GeneratePromptResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -9040,14 +9403,15 @@ export namespace GeneratePromptResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -9327,8 +9691,7 @@ export namespace GeneratePromptResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -9558,8 +9921,7 @@ export namespace GeneratePromptResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -9616,8 +9978,7 @@ export namespace GeneratePromptResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -9628,12 +9989,9 @@ export namespace GeneratePromptResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -9651,6 +10009,26 @@ export namespace GeneratePromptResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -9691,8 +10069,7 @@ export namespace GeneratePromptResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -9703,12 +10080,9 @@ export namespace GeneratePromptResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -9726,6 +10100,26 @@ export namespace GeneratePromptResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -10004,8 +10398,1648 @@ export namespace GeneratePromptResponse {
   }
 }
 
-export interface GenerateRunModelResponse {
-  job: GenerateRunModelResponse.Job;
+export interface GenerateQualityGateResponse {
+  /**
+   * Always-on generic AI-quality dimension
+   */
+  aiQuality: GenerateQualityGateResponse.AIQuality;
+
+  /**
+   * Briefs that contributed to this verdict
+   */
+  appliedBriefs: Array<GenerateQualityGateResponse.AppliedBrief>;
+
+  asset: GenerateQualityGateResponse.Asset;
+
+  /**
+   * 0–100 combined score
+   */
+  overallScore: number;
+
+  /**
+   * pass / warn / fail: the worse of overallScore and aiQuality.score, each read
+   * against sensitivity
+   */
+  verdict: 'fail' | 'pass' | 'warn';
+
+  /**
+   * Brief-compliance dimension; omitted when no brief applied
+   */
+  briefCompliance?: GenerateQualityGateResponse.BriefCompliance;
+
+  /**
+   * Compute Units cost per billing action for this request, after discount. Values
+   * sum to `creativeUnitsCost`. Only Compute-Units-consuming actions with a non-zero
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
+   */
+  costDetails?: GenerateQualityGateResponse.CostDetails;
+
+  /**
+   * The Compute Units cost for the request billed
+   */
+  creativeUnitsCost?: number;
+
+  /**
+   * The Compute Units discount for the request billed
+   */
+  creativeUnitsDiscount?: number;
+
+  /**
+   * IP detection findings, when detection ran for this request.
+   */
+  ipDetection?: GenerateQualityGateResponse.IPDetection;
+
+  /**
+   * Sensitivity used to derive the verdict
+   */
+  sensitivity?: 'high' | 'low' | 'medium';
+}
+
+export namespace GenerateQualityGateResponse {
+  /**
+   * Always-on generic AI-quality dimension
+   */
+  export interface AIQuality {
+    /**
+     * Why the image scored as it did
+     */
+    reasons: Array<string>;
+
+    /**
+     * 0–100; higher is better (more compliant / less AI-looking)
+     */
+    score: number;
+
+    /**
+     * Actionable suggestions to improve the score
+     */
+    suggestions: Array<string>;
+  }
+
+  /**
+   * Identifies a brief that contributed to a verdict.
+   */
+  export interface AppliedBrief {
+    /**
+     * The brief's id
+     */
+    id: string;
+
+    /**
+     * The brief's scope
+     */
+    level: 'project' | 'team';
+  }
+
+  export interface Asset {
+    /**
+     * The asset ID (example: "asset_GTrL3mq4SXWyMxkOHRxlpw")
+     */
+    id: string;
+
+    /**
+     * The author user ID (example: "dcf121faaa1a0a0bbbd9ca1b73d62aea")
+     */
+    authorId: string;
+
+    /**
+     * A list of CollectionId this asset belongs to
+     */
+    collectionIds: Array<string>;
+
+    /**
+     * The asset creation date as an ISO string (example: "2023-02-03T11:19:41.579Z")
+     */
+    createdAt: string;
+
+    /**
+     * List of edit capabilities
+     */
+    editCapabilities: Array<
+      | 'DETECTION'
+      | 'GENERATIVE_FILL'
+      | 'PIXELATE'
+      | 'PROMPT_EDITING'
+      | 'REFINE'
+      | 'REFRAME'
+      | 'REMOVE_BACKGROUND'
+      | 'SEGMENTATION'
+      | 'UPSCALE'
+      | 'UPSCALE_360'
+      | 'VECTORIZATION'
+    >;
+
+    /**
+     * The kind of asset
+     */
+    kind: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
+
+    /**
+     * Metadata of the asset with some additional information
+     */
+    metadata: Asset.Metadata;
+
+    /**
+     * The mime type of the asset (example: "image/png")
+     */
+    mimeType: string;
+
+    /**
+     * The owner (project) ID (example: "proj_23tlk332lkht3kl2" or
+     * "team_dlkhgs23tlk3hlkth32lkht3kl2" for old teams)
+     */
+    ownerId: string;
+
+    /**
+     * The privacy of the asset
+     */
+    privacy: 'private' | 'public' | 'unlisted';
+
+    /**
+     * The properties of the asset, content may depend on the kind of asset returned
+     */
+    properties: Asset.Properties;
+
+    /**
+     * 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'
+      | 'audio2txt'
+      | 'audio2video'
+      | 'background-removal'
+      | 'canvas'
+      | 'canvas-drawing'
+      | 'canvas-export'
+      | 'detection'
+      | 'generative-fill'
+      | 'image-prompt-editing'
+      | 'img23d'
+      | 'img2img'
+      | 'img2splat'
+      | 'img2txt'
+      | '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'
+      | 'txt2txt'
+      | 'txt2video'
+      | 'unknown'
+      | 'uploaded'
+      | 'uploaded-3d'
+      | 'uploaded-audio'
+      | 'uploaded-avatar'
+      | 'uploaded-text'
+      | 'uploaded-video'
+      | 'upscale'
+      | 'upscale-skybox'
+      | 'upscale-texture'
+      | 'upscale-video'
+      | 'vectorization'
+      | 'video23d'
+      | 'video2audio'
+      | 'video2img'
+      | 'video2video'
+      | 'voice-clone';
+
+    /**
+     * 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?: Asset.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?: Asset.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 mime type of the original file url.
+     *
+     * The original file is stored under a key that carries no extension, so this is
+     * the only way to know which format `originalFileUrl` serves (e.g. an HDRi skybox
+     * exposes a JPEG preview as `url` and its `.exr` or `.hdr` file as the original).
+     * Omitted when the stored format could not be determined.
+     */
+    originalMimeType?:
+      | 'application/gzip'
+      | 'application/json'
+      | 'application/octet-stream'
+      | 'application/pdf'
+      | 'application/safetensors'
+      | 'application/vnd.autodesk.fbx'
+      | 'application/x-authorware-bin'
+      | 'application/x-zip-compressed'
+      | 'application/x.autodesk.fbx'
+      | 'application/zip'
+      | 'audio/flac'
+      | 'audio/m4a'
+      | 'audio/mpeg'
+      | 'audio/ogg'
+      | 'audio/wav'
+      | 'image/aces'
+      | 'image/avif'
+      | 'image/bmp'
+      | 'image/gif'
+      | 'image/heic'
+      | 'image/jpeg'
+      | 'image/png'
+      | 'image/svg+xml'
+      | 'image/tiff'
+      | 'image/vnd.radiance'
+      | 'image/webp'
+      | 'image/x-exr'
+      | 'model/glb'
+      | 'model/gltf+json'
+      | 'model/gltf-binary'
+      | 'model/ksplat'
+      | 'model/mtl'
+      | 'model/obj'
+      | 'model/ply'
+      | 'model/sog'
+      | 'model/splat'
+      | 'model/spz'
+      | 'model/stl'
+      | 'model/vnd.collada+xml'
+      | 'model/vnd.ms-package.3dmanufacturing-3dmodel+xml'
+      | 'model/x-3d-vox'
+      | 'model/x-blender'
+      | 'model/x-fbx'
+      | 'model/x-maya-ascii'
+      | 'model/x-maya-binary'
+      | 'model/x3d+xml'
+      | 'text/plain'
+      | 'video/mp4'
+      | 'video/quicktime'
+      | 'video/webm';
+
+    /**
+     * 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?: Asset.Preview;
+
+    /**
+     * Quality Gate result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withQualityGateDetails=true`.
+     */
+    qualityGate?: Asset.QualityGate;
+
+    /**
+     * The asset's thumbnail.
+     *
+     * Contains the assetId and the url of the thumbnail.
+     */
+    thumbnail?: Asset.Thumbnail;
+  }
+
+  export namespace Asset {
+    /**
+     * Metadata of the asset with some additional information
+     */
+    export interface Metadata {
+      kind: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
+
+      /**
+       * 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'
+        | 'audio2txt'
+        | 'audio2video'
+        | 'background-removal'
+        | 'canvas'
+        | 'canvas-drawing'
+        | 'canvas-export'
+        | 'detection'
+        | 'generative-fill'
+        | 'image-prompt-editing'
+        | 'img23d'
+        | 'img2img'
+        | 'img2splat'
+        | 'img2txt'
+        | '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'
+        | 'txt2txt'
+        | 'txt2video'
+        | 'unknown'
+        | 'uploaded'
+        | 'uploaded-3d'
+        | 'uploaded-audio'
+        | 'uploaded-avatar'
+        | 'uploaded-text'
+        | 'uploaded-video'
+        | 'upscale'
+        | 'upscale-skybox'
+        | 'upscale-texture'
+        | 'upscale-video'
+        | 'vectorization'
+        | 'video23d'
+        | 'video2audio'
+        | '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;
+
+      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>;
+
+      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;
+
+      dilate?: number;
+
+      /**
+       * Contrast factor for Grayscale detector
+       */
+      factor?: number;
+
+      /**
+       * The name its parent's files reference it by (an OBJ's MTL, an MTL's texture),
+       * kept as delivered.
+       */
+      fileName?: string;
+
+      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 input image to process. Must reference an existing AssetId or be a data URL.
+       */
+      image?: string;
+
+      /**
+       * Strengthen the similarity to the original image during the upscale. Default:
+       * optimized for your preset and style.
+       */
+      imageFidelity?: number;
+
+      /**
+       * Preserve the seamless properties of skybox or texture images. Input has to be of
+       * same type (seamless).
+       */
+      imageType?: 'seamfull' | 'skybox' | 'texture';
+
+      /**
+       * The id of the Inference describing how this image was generated
+       */
+      inferenceId?: string;
+
+      /**
+       * 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';
+
+      /**
+       * Location of the input image in the output.
+       */
+      inputLocation?: 'bottom' | 'left' | 'middle' | 'right' | 'top';
+
+      /**
+       * To invert the relief
+       */
+      invert?: boolean;
+
+      /**
+       * Its own references (an OBJ's `mtllib`, an MTL's maps) were kept as delivered.
+       */
+      keepsFileNames?: boolean;
+
+      /**
+       * How polished is the surface? 0 is like a rough surface, 1 is like a mirror
+       */
+      keypointThreshold?: number;
+
+      layerDifference?: number;
+
+      lengthThreshold?: number;
+
+      /**
+       * The ISO timestamp when the lock on the canvas will expire
+       */
+      lockExpiresAt?: string;
+
+      /**
+       * Low threshold for Canny detector
+       */
+      lowThreshold?: number;
+
+      /**
+       * The mask used for the asset generation or editing
+       */
+      mask?: string;
+
+      maxIterations?: number;
+
+      /**
+       * Maximum threshold for Grayscale conversion
+       */
+      maxThreshold?: number;
+
+      /**
+       * Minimum threshold for Grayscale conversion
+       */
+      minThreshold?: number;
+
+      /**
+       * Modality to detect
+       */
+      modality?:
+        | 'canny'
+        | 'depth'
+        | 'grayscale'
+        | 'lineart_anime'
+        | 'mlsd'
+        | 'normal'
+        | 'pose'
+        | 'scribble'
+        | 'segmentation'
+        | 'sketch';
+
+      mode?: string;
+
+      /**
+       * The modelId used to generate this asset
+       */
+      modelId?: 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'
+        | 'zimage-de-turbo-lora'
+        | 'zimage-lora'
+        | 'zimage-turbo-lora';
+
+      name?: string;
+
+      nbMasks?: number;
+
+      /**
+       * The negative prompt used to generate this asset
+       */
+      negativePrompt?: 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;
+
+      /**
+       * The number of denoising steps for each image generation.
+       */
+      numInferenceSteps?: number;
+
+      /**
+       * The number of outputs to generate.
+       */
+      numOutputs?: number;
+
+      originalAssetId?: string;
+
+      outputIndex?: number;
+
+      /**
+       * Overlap percentage for the output image.
+       */
+      overlapPercentage?: number;
+
+      /**
+       * Override the embeddings of the model. Only your prompt and negativePrompt will
+       * be used. Use with caution.
+       */
+      overrideEmbeddings?: boolean;
+
+      parentId?: string;
+
+      parentJobId?: string;
+
+      pathPrecision?: number;
+
+      /**
+       * List of points (label, x, y) in the image where label = 0 for background and 1
+       * for object.
+       */
+      points?: Array<Array<number>>;
+
+      /**
+       * How polished is the surface? 0 is like a rough surface, 1 is like a mirror
+       */
+      polished?: number;
+
+      preset?: string;
+
+      progressPercent?: number;
+
+      /**
+       * The prompt that guided the asset generation or editing
+       */
+      prompt?: string;
+
+      /**
+       * Increase the fidelity to the prompt during upscale. Default: optimized for your
+       * preset and style.
+       */
+      promptFidelity?: number;
+
+      /**
+       * How raised is the surface? 0 is flat like water, 1 is like a very rough rock
+       */
+      raised?: number;
+
+      /**
+       * The reference images used for the asset generation or editing
+       */
+      referenceImages?: Array<string>;
+
+      /**
+       * 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;
+
+      /**
+       * Remove background for Grayscale detector
+       */
+      removeBackground?: boolean;
+
+      /**
+       * Size proportion of the input image in the output.
+       */
+      resizeOption?: number;
+
+      /**
+       * Boolean to output the contours.
+       */
+      resultContours?: boolean;
+
+      /**
+       * Boolean to return the source image with the mask applied as alpha channel (RGBA
+       * PNG, transparent background) instead of the binary mask. Mutually exclusive with
+       * `resultMask` — passing both as `true` returns a 400 error. Note:
+       * `backgroundOpacity` is no longer honored — alpha is binary (0/255) only.
+       */
+      resultImage?: boolean;
+
+      /**
+       * Boolean to return the binary masks in the response. Mutually exclusive with
+       * `resultImage` — passing both as `true` returns a 400 error.
+       */
+      resultMask?: boolean;
+
+      rootParentId?: string;
+
+      /**
+       * Save a flipbook of the texture. Deactivated when the input texture is larger
+       * than 2048x2048px
+       */
+      saveFlipbook?: boolean;
+
+      /**
+       * Scaling factor (when `targetWidth` not specified)
+       */
+      scalingFactor?: number;
+
+      /**
+       * The scheduler used to generate this asset
+       */
+      scheduler?: string;
+
+      /**
+       * The seed used to generate this asset. <!> Can be a string or a number in some
+       * cases <!>.
+       */
+      seed?: string;
+
+      /**
+       * Sharpen tiles.
+       */
+      sharpen?: boolean;
+
+      /**
+       * How shiny is the surface? 0 is like a matte surface, 1 is like a diamond
+       */
+      shiny?: number;
+
+      size?: number;
+
+      /**
+       * Activate sketch detection instead of canny.
+       */
+      sketch?: boolean;
+
+      sourceProjectId?: string;
+
+      spliceThreshold?: number;
+
+      /**
+       * The strength
+       *
+       * Only available for the `flux-kontext` LoRA model.
+       */
+      strength?: number;
+
+      /**
+       * Strength for the input image structure preservation
+       */
+      structureFidelity?: number;
+
+      /**
+       * The control image for structure. A canny detector will be applied to this image.
+       * Must reference an existing AssetId.
+       */
+      structureImage?: string;
+
+      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';
+
+      /**
+       * The higher the value the more it will look like the style image(s)
+       */
+      styleFidelity?: number;
+
+      /**
+       * List of style images. Most of the time, only one image is enough. It must be
+       * existing AssetIds.
+       */
+      styleImages?: Array<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 target height of the output image.
+       */
+      targetHeight?: number;
+
+      /**
+       * Target width for the upscaled image, take priority over scaling factor
+       */
+      targetWidth?: number;
+
+      /**
+       * A textual description / keywords describing the object of interest.
+       */
+      text?: string;
+
+      /**
+       * The asset to convert in texture maps. Must reference an existing AssetId.
+       */
+      texture?: string;
+
+      /**
+       * The thumbnail of the canvas
+       */
+      thumbnail?: Metadata.Thumbnail;
+
+      /**
+       * 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;
+
+      trainingImage?: boolean;
+
+      /**
+       * (deprecated) Vertical expansion ratio.
+       */
+      verticalExpansionRatio?: number;
+
+      /**
+       * The width of the rendered image.
+       */
+      width?: number;
+    }
+
+    export namespace Metadata {
+      export interface Concept {
+        /**
+         * The model ID (example: "model_eyVcnFJcR92BxBkz7N6g5w")
+         */
+        modelId: string;
+
+        /**
+         * The scale of the model (example: 1.0) For Flux Kontext Prompt Editing, the scale
+         * is between 0 and 2.
+         */
+        scale: number;
+
+        /**
+         * The epoch of the model (example: "000001") Only available for Flux Lora Trained
+         * models
+         */
+        modelEpoch?: string;
+      }
+
+      /**
+       * 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 url of the image used as a thumbnail for the canvas
+         */
+        url: string;
+      }
+    }
+
+    /**
+     * The properties of the asset, content may depend on the kind of asset returned
+     */
+    export interface Properties {
+      size: number;
+
+      /**
+       * Number of animation frames if animations exist
+       */
+      animationFrameCount?: number;
+
+      /**
+       * Bitrate of the media in bits per second
+       */
+      bitrate?: number;
+
+      /**
+       * Number of bones if skeleton exists
+       */
+      boneCount?: number;
+
+      /**
+       * Recommended preview camera mode emitted by the generator (gsplat route); passed
+       * through to mesh-rendering verbatim.
+       */
+      cameraMode?: 'aerial' | 'interior' | 'turntable';
+
+      /**
+       * Recommended preview camera path emitted by the generator (gsplat route); passed
+       * through to mesh-rendering verbatim.
+       */
+      cameraTrajectory?: Array<Properties.CameraTrajectory>;
+
+      /**
+       * Number of channels of the audio
+       */
+      channels?: number;
+
+      /**
+       * Number of Unicode code points in the text. Code-point-aware (so a non-BMP emoji
+       * counts as 1) but not full grapheme-cluster aware (a ZWJ sequence still counts as
+       * several).
+       */
+      charCount?: number;
+
+      /**
+       * Classification of the audio
+       */
+      classification?: 'effect' | 'interview' | 'music' | 'other' | 'sound' | 'speech' | 'text' | 'unknown';
+
+      /**
+       * Codec name of the media
+       */
+      codecName?: string;
+
+      /**
+       * Description of the audio
+       */
+      description?: string;
+
+      /**
+       * Bounding box dimensions [width, height, depth]
+       */
+      dimensions?: Array<number>;
+
+      /**
+       * Duration of the media in seconds
+       */
+      duration?: number;
+
+      /**
+       * Number of faces/triangles in the mesh
+       */
+      faceCount?: number;
+
+      /**
+       * Format of the mesh file (e.g. 'glb', etc.)
+       */
+      format?: string;
+
+      /**
+       * Frame rate of the video in frames per second
+       */
+      frameRate?: number;
+
+      /**
+       * Whether the mesh has animations
+       */
+      hasAnimations?: boolean;
+
+      /**
+       * True when `preview` holds the entire content unmodified — consumers can use it
+       * directly without fetching `asset.url`. False or undefined means the content
+       * exceeds the preview budget and consumers must fetch the full body from S3 to
+       * read past the preview.
+       */
+      hasFullPreview?: boolean;
+
+      /**
+       * Whether the mesh has normal vectors
+       */
+      hasNormals?: boolean;
+
+      /**
+       * Whether the mesh has bones/skeleton
+       */
+      hasSkeleton?: boolean;
+
+      /**
+       * Whether the mesh has UV coordinates
+       */
+      hasUVs?: boolean;
+
+      height?: number;
+
+      /**
+       * Number of frames in the video
+       */
+      nbFrames?: number;
+
+      /**
+       * Leading slice of the content used for inline UI display and as a search
+       * shortcut. Capped at TEXT_PREVIEW_MAX_BYTES (UTF-8) and always cut on a
+       * code-point boundary so no character is split. Number of characters in the
+       * preview varies by script (around 1024 for ASCII, ~340 for CJK, ~256 for
+       * emoji-heavy text at the default 1 KB budget).
+       */
+      preview?: 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;
+
+      /**
+       * Number of whitespace-separated words in the text
+       */
+      wordCount?: number;
+    }
+
+    export namespace Properties {
+      /**
+       * One explicit camera keyframe for the splat route. Several are interpolated over
+       * the requested frames into an orbit/fly-through; a single keyframe renders a
+       * static view. Overrides {@link SplatCameraMode} when provided.
+       */
+      export interface CameraTrajectory {
+        /**
+         * Camera eye position in the splat's world frame.
+         */
+        position: Array<number>;
+
+        /**
+         * Look-at point in the splat's world frame.
+         */
+        target: Array<number>;
+
+        /**
+         * Vertical field of view in degrees (defaults to 50 in the renderer).
+         */
+        fov?: number;
+      }
+
+      /**
+       * 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;
+    }
+
+    /**
+     * Quality Gate result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withQualityGateDetails=true`.
+     */
+    export interface QualityGate {
+      /**
+       * ISO-8601 timestamp of when scoring ran
+       */
+      computedAt: string;
+
+      /**
+       * Whether scoring succeeded or errored
+       */
+      status: 'error' | 'scored';
+
+      /**
+       * Rubric/model version that produced this result
+       */
+      version: string;
+
+      /**
+       * Generic AI-quality sub-score
+       */
+      aiQualityScore?: number;
+
+      /**
+       * Ids of briefs that contributed
+       */
+      appliedBriefIds?: Array<string>;
+
+      /**
+       * Brief-compliance sub-score (omitted when no brief applied)
+       */
+      briefComplianceScore?: number;
+
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withQualityGateDetails=true` by the
+       * project that owns it — the brief-compliance text paraphrases that project's
+       * brief, so a cross-project read of a public asset gets the summary alone. Also
+       * omitted when the archived verdict is unavailable (asset scored by an older
+       * version, or an unreadable archive).
+       */
+      details?: QualityGate.Details;
+
+      /**
+       * Error message when status is 'error' (truncated)
+       */
+      error?: string;
+
+      /**
+       * 0–100 composite score (present when status is 'scored')
+       */
+      overallScore?: number;
+
+      /**
+       * Sensitivity used for the verdict
+       */
+      sensitivity?: 'high' | 'low' | 'medium';
+
+      /**
+       * pass / warn / fail (present when status is 'scored')
+       */
+      verdict?: 'fail' | 'pass' | 'warn';
+    }
+
+    export namespace QualityGate {
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withQualityGateDetails=true` by the
+       * project that owns it — the brief-compliance text paraphrases that project's
+       * brief, so a cross-project read of a public asset gets the summary alone. Also
+       * omitted when the archived verdict is unavailable (asset scored by an older
+       * version, or an unreadable archive).
+       */
+      export interface Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        aiQuality: Details.AIQuality;
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        briefCompliance?: Details.BriefCompliance;
+      }
+
+      export namespace Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        export interface AIQuality {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        export interface BriefCompliance {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+      }
+    }
+
+    /**
+     * The asset's thumbnail.
+     *
+     * Contains the assetId and the url of the thumbnail.
+     */
+    export interface Thumbnail {
+      assetId: string;
+
+      url: string;
+    }
+  }
+
+  /**
+   * Brief-compliance dimension; omitted when no brief applied
+   */
+  export interface BriefCompliance {
+    /**
+     * Why the image scored as it did
+     */
+    reasons: Array<string>;
+
+    /**
+     * 0–100; higher is better (more compliant / less AI-looking)
+     */
+    score: number;
+
+    /**
+     * Actionable suggestions to improve the score
+     */
+    suggestions: Array<string>;
+  }
+
+  /**
+   * Compute Units cost per billing action for this request, after discount. Values
+   * sum to `creativeUnitsCost`. Only Compute-Units-consuming actions with a non-zero
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
+   */
+  export interface CostDetails {
+    'assistant-message'?: number;
+
+    caption?: number;
+
+    'custom-generation'?: number;
+
+    'describe-style'?: number;
+
+    detection?: number;
+
+    embed?: number;
+
+    'image-prompt-editing'?: number;
+
+    'inference-images'?: number;
+
+    'ip-detection'?: number;
+
+    pixelate?: number;
+
+    prompt?: number;
+
+    'quality-gate'?: number;
+
+    'remove-background'?: number;
+
+    repaint?: number;
+
+    restyle?: number;
+
+    segmentation?: number;
+
+    'skybox-base-360'?: number;
+
+    'skybox-upscale-360'?: number;
+
+    texture?: number;
+
+    'train-model'?: number;
+
+    translate?: number;
+
+    upscale?: number;
+
+    vectorization?: number;
+  }
+
+  /**
+   * IP detection findings, when detection ran for this request.
+   */
+  export interface IPDetection {
+    /**
+     * Whether and how detection affected the request.
+     */
+    action: 'allowed' | 'blocked' | 'flagged';
+
+    /**
+     * Number of images the detectors actually analyzed — a video counts as each of its
+     * extracted frames, and an image that could not be read is excluded (and not
+     * billed). Each of them is priced once per enabled filter.
+     */
+    analyzedImagesCount: number;
+
+    /**
+     * IP-detection CU fee, separate from creativeUnitsCost: it follows the provider
+     * tokens the run sends — the prompt plus every analyzed image, once per enabled
+     * filter — with a 1 CU minimum per run.
+     */
+    creativeUnitsCharged: number;
+
+    /**
+     * Number of enabled filters evaluated for this request.
+     */
+    evaluatedFilters: number;
+
+    /**
+     * Per-filter verdicts gathered for this request.
+     */
+    findings: Array<IPDetection.Finding>;
+
+    /**
+     * Whether a filter considered the inputs an IP risk. Independent of `action`: a
+     * request blocked because a detector errored is `blocked` and NOT flagged.
+     */
+    flagged: boolean;
+
+    /**
+     * True if one or more detectors errored while evaluating this request.
+     */
+    hasDetectorError?: boolean;
+  }
+
+  export namespace IPDetection {
+    /**
+     * A single filter's verdict.
+     */
+    export interface Finding {
+      /**
+       * Category of the filter that produced this verdict.
+       */
+      category: 'artist-style' | 'brand-trademark' | 'celebrity-likeness' | 'custom' | 'fictional-character';
+
+      /**
+       * Confidence score from 0 (low) to 1 (high).
+       */
+      confidence: number;
+
+      /**
+       * Identifier of the filter that produced this verdict.
+       */
+      filterId: string;
+
+      /**
+       * Display name of the filter that produced this verdict.
+       */
+      filterName: string;
+
+      /**
+       * Whether this filter considered the request an IP risk.
+       */
+      flagged: boolean;
+
+      /**
+       * Short, user-facing explanation of the verdict.
+       */
+      reason: string;
+
+      /**
+       * Named entities the filter recognized (e.g. characters, brands, people).
+       */
+      entities?: Array<string>;
+    }
+  }
+}
+
+export interface GenerateRunModelResponse {
+  job: GenerateRunModelResponse.Job;
 
   /**
    * Compute Units cost per billing action for this request, after discount. Values
@@ -10216,6 +12250,7 @@ export namespace GenerateRunModelResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -10246,14 +12281,15 @@ export namespace GenerateRunModelResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -10533,8 +12569,7 @@ export namespace GenerateRunModelResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -10764,8 +12799,7 @@ export namespace GenerateRunModelResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -10822,8 +12856,7 @@ export namespace GenerateRunModelResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -10834,12 +12867,9 @@ export namespace GenerateRunModelResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -10857,6 +12887,26 @@ export namespace GenerateRunModelResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -10897,8 +12947,7 @@ export namespace GenerateRunModelResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -10909,12 +12958,9 @@ export namespace GenerateRunModelResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -10932,6 +12978,26 @@ export namespace GenerateRunModelResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -11408,6 +13474,7 @@ export namespace GenerateTranslateResponse {
           | 'remove-background'
           | 'transform'
           | 'user-approval'
+          | 'user-selection'
           | 'workflow';
 
         /**
@@ -11438,14 +13505,15 @@ export namespace GenerateTranslateResponse {
         includeOutputsInWorkflowJob?: true;
 
         /**
-         * The inputs of the node.
+         * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+         * bound how many items the user may pick (defaults: 1 and 100); conditional
+         * connections may be present as additional inputs.
          */
         inputs?: Array<Flow.Input>;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Statically-configured items for a List node, or the frozen candidate list of a
+         * UserSelection node. The values can be strings, numbers, or asset IDs.
          */
         items?: Array<string>;
 
@@ -11725,8 +13793,7 @@ export namespace GenerateTranslateResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -11956,8 +14023,7 @@ export namespace GenerateTranslateResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -12014,8 +14080,7 @@ export namespace GenerateTranslateResponse {
              * - \`ifNotDefined\`: Input is required when another specified input is not
              *   defined
              * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -12026,12 +14091,9 @@ export namespace GenerateTranslateResponse {
               always?: boolean;
 
               /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -12049,6 +14111,26 @@ export namespace GenerateTranslateResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -12089,8 +14171,7 @@ export namespace GenerateTranslateResponse {
            * - \`ifNotDefined\`: Input is required when another specified input is not
            *   defined
            * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
+           * - \`conditional\`: Input is required when other inputs have specific values
            *
            * By default, the input is not required.
            */
@@ -12101,12 +14182,9 @@ export namespace GenerateTranslateResponse {
             always?: boolean;
 
             /**
-             * Makes this input required when another input has a specific value:
-             *
-             * - Key: name of the input to check
-             * - Value: operation and allowed values that trigger the requirement
+             * Makes this input required when other inputs have one of the listed values
              */
-            conditionalValues?: unknown;
+            conditional?: Required.Conditional;
 
             /**
              * Makes this input required when another input is defined:
@@ -12124,6 +14202,26 @@ export namespace GenerateTranslateResponse {
              */
             ifNotDefined?: unknown;
           }
+
+          export namespace Required {
+            /**
+             * Makes this input required when other inputs have one of the listed values
+             */
+            export interface Conditional {
+              /**
+               * The conditions to check:
+               *
+               * - Key: name of the input to check
+               * - Value: values of that input that satisfy the condition
+               */
+              values: unknown;
+
+              /**
+               * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+               */
+              operator?: 'and' | 'or';
+            }
+          }
         }
 
         /**
@@ -12653,6 +14751,34 @@ export interface GenerateEmbedParams {
   projectId?: string;
 }
 
+export interface GenerateIPDetectionParams {
+  /**
+   * Query param: Estimate the operation instead of running it: the call returns a
+   * 269 response carrying the creative units cost. `api` estimates at the API tier.
+   */
+  dryRun?: 'true' | 'api';
+
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
+  /**
+   * Body param: Asset ids to check. Videos are analyzed through their extracted
+   * first/last frames; audio and 3d assets are not analyzed and come back in
+   * `skippedAssetIds`.
+   */
+  assetIds?: Array<string>;
+
+  /**
+   * Body param: Prompts to check, analyzed as one text of 250 000 characters in
+   * total at most — as much as the longest prompt any model accepts. At least one
+   * prompt or one analyzable asset id is required.
+   */
+  prompts?: Array<string>;
+}
+
 export interface GeneratePatchParams {
   /**
    * Body param: The input image as a data URL (example:
@@ -12870,6 +14996,40 @@ export interface GeneratePromptParams {
   topP?: number;
 }
 
+export interface GenerateQualityGateParams {
+  /**
+   * Body param: Image to verify: an asset id ("asset\_...") or a data URL. A data
+   * URL is uploaded into the project as an asset (deduplicated on content, so the
+   * same bytes always resolve to the same asset), and the verdict is stored on that
+   * asset — re-verifying an already-scored asset replaces its result.
+   */
+  image: string;
+
+  /**
+   * Query param: Estimate the operation instead of running it: the call returns a
+   * 269 response carrying the creative units cost. `api` estimates at the API tier.
+   */
+  dryRun?: 'true' | 'api';
+
+  /**
+   * Query param: If set to true, returns the original asset without transformation
+   */
+  originalAssets?: boolean;
+
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
+  /**
+   * Body param: Threshold strictness for this call. Overrides the scope's stored
+   * sensitivity when set; otherwise the resolved scope setting (or "medium") is
+   * used.
+   */
+  sensitivity?: 'high' | 'low' | 'medium';
+}
+
 export interface GenerateRunModelParams {
   /**
    * Body param: The request body for the custom generation must be retrieve from GET
@@ -12971,16 +15131,20 @@ export declare namespace Generate {
     type GenerateDescribeStyleResponse as GenerateDescribeStyleResponse,
     type GenerateDetectResponse as GenerateDetectResponse,
     type GenerateEmbedResponse as GenerateEmbedResponse,
+    type GenerateIPDetectionResponse as GenerateIPDetectionResponse,
     type GeneratePatchResponse as GeneratePatchResponse,
     type GeneratePromptResponse as GeneratePromptResponse,
+    type GenerateQualityGateResponse as GenerateQualityGateResponse,
     type GenerateRunModelResponse as GenerateRunModelResponse,
     type GenerateTranslateResponse as GenerateTranslateResponse,
     type GenerateCaptionParams as GenerateCaptionParams,
     type GenerateDescribeStyleParams as GenerateDescribeStyleParams,
     type GenerateDetectParams as GenerateDetectParams,
     type GenerateEmbedParams as GenerateEmbedParams,
+    type GenerateIPDetectionParams as GenerateIPDetectionParams,
     type GeneratePatchParams as GeneratePatchParams,
     type GeneratePromptParams as GeneratePromptParams,
+    type GenerateQualityGateParams as GenerateQualityGateParams,
     type GenerateRunModelParams as GenerateRunModelParams,
     type GenerateTranslateParams as GenerateTranslateParams,
   };