@scenario-labs/sdk 3.1.0 → 3.2.0

package/src/resources/generate.ts

@@ -54,12 +54,8 @@ export class Generate extends APIResource {
    * Patch an asset with an image.
    */
   patch(params: GeneratePatchParams, options?: RequestOptions): APIPromise<GeneratePatchResponse> {
-    const { dryRun, originalAssets, projectId, ...body } = params;
-    return this._client.post('/generate/patch', {
-      query: { dryRun, originalAssets, projectId },
-      body,
-      ...options,
-    });
+    const { originalAssets, projectId, ...body } = params;
+    return this._client.post('/generate/patch', { query: { originalAssets, projectId }, body, ...options });
   }
 
   /**
@@ -111,8 +107,8 @@ export interface GenerateCaptionResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   costDetails?: GenerateCaptionResponse.CostDetails;
 
@@ -511,7 +507,9 @@ export namespace GenerateCaptionResponse {
            * The asset kind of the input. Only taken into account for \`file\` and
            * \`file_array\` input types. If model provides multiple kinds, the input will be
            * not able to create the asset on the flight on API side with dataurl without
-           * data:kind, prefix
+           * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+           * a model does not declare one, \`image\` is returned, which is the kind used at
+           * generation time.
            */
           kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -539,8 +537,9 @@ export namespace GenerateCaptionResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           maxLength?: number;
 
@@ -557,8 +556,9 @@ export namespace GenerateCaptionResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           minLength?: number;
 
@@ -738,7 +738,9 @@ export namespace GenerateCaptionResponse {
              * The asset kind of the input. Only taken into account for \`file\` and
              * \`file_array\` input types. If model provides multiple kinds, the input will be
              * not able to create the asset on the flight on API side with dataurl without
-             * data:kind, prefix
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
              */
             kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -766,8 +768,9 @@ export namespace GenerateCaptionResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             maxLength?: number;
 
@@ -784,8 +787,9 @@ export namespace GenerateCaptionResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             minLength?: number;
 
@@ -1090,7 +1094,7 @@ export namespace GenerateCaptionResponse {
 
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -1120,7 +1124,7 @@ export namespace GenerateCaptionResponse {
     export namespace Billing {
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -1140,7 +1144,7 @@ export namespace GenerateCaptionResponse {
       export interface CuCostDetails {
         'ip-detection'?: number;
 
-        'slop-detection'?: number;
+        'quality-gate'?: number;
       }
     }
   }
@@ -1148,8 +1152,8 @@ export namespace GenerateCaptionResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   export interface CostDetails {
     'assistant-message'?: number;
@@ -1174,6 +1178,8 @@ export namespace GenerateCaptionResponse {
 
     prompt?: number;
 
+    'quality-gate'?: number;
+
     'remove-background'?: number;
 
     repaint?: number;
@@ -1186,8 +1192,6 @@ export namespace GenerateCaptionResponse {
 
     'skybox-upscale-360'?: number;
 
-    'slop-detection'?: number;
-
     texture?: number;
 
     'train-model'?: number;
@@ -1209,8 +1213,16 @@ export namespace GenerateCaptionResponse {
     action: 'allowed' | 'blocked' | 'flagged';
 
     /**
-     * IP-detection CU fee, separate from creativeUnitsCost: a fixed base fee plus a
-     * per-image fee for each analyzed input image.
+     * 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;
 
@@ -1225,7 +1237,8 @@ export namespace GenerateCaptionResponse {
     findings: Array<IPDetection.Finding>;
 
     /**
-     * Convenience flag; always true when action is not 'allowed'.
+     * 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;
 
@@ -1294,8 +1307,8 @@ export interface GenerateDescribeStyleResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   costDetails?: GenerateDescribeStyleResponse.CostDetails;
 
@@ -1686,7 +1699,9 @@ export namespace GenerateDescribeStyleResponse {
            * The asset kind of the input. Only taken into account for \`file\` and
            * \`file_array\` input types. If model provides multiple kinds, the input will be
            * not able to create the asset on the flight on API side with dataurl without
-           * data:kind, prefix
+           * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+           * a model does not declare one, \`image\` is returned, which is the kind used at
+           * generation time.
            */
           kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -1714,8 +1729,9 @@ export namespace GenerateDescribeStyleResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           maxLength?: number;
 
@@ -1732,8 +1748,9 @@ export namespace GenerateDescribeStyleResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           minLength?: number;
 
@@ -1913,7 +1930,9 @@ export namespace GenerateDescribeStyleResponse {
              * The asset kind of the input. Only taken into account for \`file\` and
              * \`file_array\` input types. If model provides multiple kinds, the input will be
              * not able to create the asset on the flight on API side with dataurl without
-             * data:kind, prefix
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
              */
             kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -1941,8 +1960,9 @@ export namespace GenerateDescribeStyleResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             maxLength?: number;
 
@@ -1959,8 +1979,9 @@ export namespace GenerateDescribeStyleResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             minLength?: number;
 
@@ -2265,7 +2286,7 @@ export namespace GenerateDescribeStyleResponse {
 
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -2295,7 +2316,7 @@ export namespace GenerateDescribeStyleResponse {
     export namespace Billing {
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -2315,7 +2336,7 @@ export namespace GenerateDescribeStyleResponse {
       export interface CuCostDetails {
         'ip-detection'?: number;
 
-        'slop-detection'?: number;
+        'quality-gate'?: number;
       }
     }
   }
@@ -2323,8 +2344,8 @@ export namespace GenerateDescribeStyleResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   export interface CostDetails {
     'assistant-message'?: number;
@@ -2349,6 +2370,8 @@ export namespace GenerateDescribeStyleResponse {
 
     prompt?: number;
 
+    'quality-gate'?: number;
+
     'remove-background'?: number;
 
     repaint?: number;
@@ -2361,8 +2384,6 @@ export namespace GenerateDescribeStyleResponse {
 
     'skybox-upscale-360'?: number;
 
-    'slop-detection'?: number;
-
     texture?: number;
 
     'train-model'?: number;
@@ -2384,8 +2405,16 @@ export namespace GenerateDescribeStyleResponse {
     action: 'allowed' | 'blocked' | 'flagged';
 
     /**
-     * IP-detection CU fee, separate from creativeUnitsCost: a fixed base fee plus a
-     * per-image fee for each analyzed input image.
+     * 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;
 
@@ -2400,7 +2429,8 @@ export namespace GenerateDescribeStyleResponse {
     findings: Array<IPDetection.Finding>;
 
     /**
-     * Convenience flag; always true when action is not 'allowed'.
+     * 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;
 
@@ -2461,8 +2491,8 @@ export interface GenerateDetectResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   costDetails?: GenerateDetectResponse.CostDetails;
 
@@ -2853,7 +2883,9 @@ export namespace GenerateDetectResponse {
            * The asset kind of the input. Only taken into account for \`file\` and
            * \`file_array\` input types. If model provides multiple kinds, the input will be
            * not able to create the asset on the flight on API side with dataurl without
-           * data:kind, prefix
+           * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+           * a model does not declare one, \`image\` is returned, which is the kind used at
+           * generation time.
            */
           kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -2881,8 +2913,9 @@ export namespace GenerateDetectResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           maxLength?: number;
 
@@ -2899,8 +2932,9 @@ export namespace GenerateDetectResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           minLength?: number;
 
@@ -3080,7 +3114,9 @@ export namespace GenerateDetectResponse {
              * The asset kind of the input. Only taken into account for \`file\` and
              * \`file_array\` input types. If model provides multiple kinds, the input will be
              * not able to create the asset on the flight on API side with dataurl without
-             * data:kind, prefix
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
              */
             kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -3108,8 +3144,9 @@ export namespace GenerateDetectResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             maxLength?: number;
 
@@ -3126,8 +3163,9 @@ export namespace GenerateDetectResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             minLength?: number;
 
@@ -3432,7 +3470,7 @@ export namespace GenerateDetectResponse {
 
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -3462,7 +3500,7 @@ export namespace GenerateDetectResponse {
     export namespace Billing {
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -3482,7 +3520,7 @@ export namespace GenerateDetectResponse {
       export interface CuCostDetails {
         'ip-detection'?: number;
 
-        'slop-detection'?: number;
+        'quality-gate'?: number;
       }
     }
   }
@@ -3716,6 +3754,64 @@ export namespace GenerateDetectResponse {
      */
     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/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-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
@@ -3731,12 +3827,12 @@ export namespace GenerateDetectResponse {
     preview?: Asset.Preview;
 
     /**
-     * SlopGuard detection result, computed asynchronously after generation.
+     * Quality Gate result, computed asynchronously after generation.
      *
      * `details` (the per-dimension reasons and suggestions) is returned only when the
-     * asset is read with `withSlopGuardDetails=true`.
+     * asset is read with `withQualityGateDetails=true`.
      */
-    slopGuard?: Asset.SlopGuard;
+    qualityGate?: Asset.QualityGate;
 
     /**
      * The asset's thumbnail.
@@ -4655,12 +4751,12 @@ export namespace GenerateDetectResponse {
     }
 
     /**
-     * SlopGuard detection result, computed asynchronously after generation.
+     * Quality Gate result, computed asynchronously after generation.
      *
      * `details` (the per-dimension reasons and suggestions) is returned only when the
-     * asset is read with `withSlopGuardDetails=true`.
+     * asset is read with `withQualityGateDetails=true`.
      */
-    export interface SlopGuard {
+    export interface QualityGate {
       /**
        * ISO-8601 timestamp of when scoring ran
        */
@@ -4694,13 +4790,13 @@ export namespace GenerateDetectResponse {
       /**
        * Per-dimension reasons and suggestions, as produced by the detector.
        *
-       * Returned only when the asset is read with `withSlopGuardDetails=true` by the
+       * 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?: SlopGuard.Details;
+      details?: QualityGate.Details;
 
       /**
        * Error message when status is 'error' (truncated)
@@ -4723,11 +4819,11 @@ export namespace GenerateDetectResponse {
       verdict?: 'fail' | 'pass' | 'warn';
     }
 
-    export namespace SlopGuard {
+    export namespace QualityGate {
       /**
        * Per-dimension reasons and suggestions, as produced by the detector.
        *
-       * Returned only when the asset is read with `withSlopGuardDetails=true` by the
+       * 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
@@ -4803,8 +4899,8 @@ export namespace GenerateDetectResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   export interface CostDetails {
     'assistant-message'?: number;
@@ -4829,6 +4925,8 @@ export namespace GenerateDetectResponse {
 
     prompt?: number;
 
+    'quality-gate'?: number;
+
     'remove-background'?: number;
 
     repaint?: number;
@@ -4841,8 +4939,6 @@ export namespace GenerateDetectResponse {
 
     'skybox-upscale-360'?: number;
 
-    'slop-detection'?: number;
-
     texture?: number;
 
     'train-model'?: number;
@@ -4864,8 +4960,16 @@ export namespace GenerateDetectResponse {
     action: 'allowed' | 'blocked' | 'flagged';
 
     /**
-     * IP-detection CU fee, separate from creativeUnitsCost: a fixed base fee plus a
-     * per-image fee for each analyzed input image.
+     * 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;
 
@@ -4880,7 +4984,8 @@ export namespace GenerateDetectResponse {
     findings: Array<IPDetection.Finding>;
 
     /**
-     * Convenience flag; always true when action is not 'allowed'.
+     * 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;
 
@@ -4946,8 +5051,8 @@ export interface GenerateEmbedResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   costDetails?: GenerateEmbedResponse.CostDetails;
 
@@ -5338,7 +5443,9 @@ export namespace GenerateEmbedResponse {
            * The asset kind of the input. Only taken into account for \`file\` and
            * \`file_array\` input types. If model provides multiple kinds, the input will be
            * not able to create the asset on the flight on API side with dataurl without
-           * data:kind, prefix
+           * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+           * a model does not declare one, \`image\` is returned, which is the kind used at
+           * generation time.
            */
           kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -5366,8 +5473,9 @@ export namespace GenerateEmbedResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           maxLength?: number;
 
@@ -5384,8 +5492,9 @@ export namespace GenerateEmbedResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           minLength?: number;
 
@@ -5565,7 +5674,9 @@ export namespace GenerateEmbedResponse {
              * The asset kind of the input. Only taken into account for \`file\` and
              * \`file_array\` input types. If model provides multiple kinds, the input will be
              * not able to create the asset on the flight on API side with dataurl without
-             * data:kind, prefix
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
              */
             kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -5593,8 +5704,9 @@ export namespace GenerateEmbedResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             maxLength?: number;
 
@@ -5611,8 +5723,9 @@ export namespace GenerateEmbedResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             minLength?: number;
 
@@ -5917,7 +6030,7 @@ export namespace GenerateEmbedResponse {
 
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -5947,7 +6060,7 @@ export namespace GenerateEmbedResponse {
     export namespace Billing {
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -5967,7 +6080,7 @@ export namespace GenerateEmbedResponse {
       export interface CuCostDetails {
         'ip-detection'?: number;
 
-        'slop-detection'?: number;
+        'quality-gate'?: number;
       }
     }
   }
@@ -5975,8 +6088,8 @@ export namespace GenerateEmbedResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   export interface CostDetails {
     'assistant-message'?: number;
@@ -6001,6 +6114,8 @@ export namespace GenerateEmbedResponse {
 
     prompt?: number;
 
+    'quality-gate'?: number;
+
     'remove-background'?: number;
 
     repaint?: number;
@@ -6013,8 +6128,6 @@ export namespace GenerateEmbedResponse {
 
     'skybox-upscale-360'?: number;
 
-    'slop-detection'?: number;
-
     texture?: number;
 
     'train-model'?: number;
@@ -6036,8 +6149,16 @@ export namespace GenerateEmbedResponse {
     action: 'allowed' | 'blocked' | 'flagged';
 
     /**
-     * IP-detection CU fee, separate from creativeUnitsCost: a fixed base fee plus a
-     * per-image fee for each analyzed input image.
+     * 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;
 
@@ -6052,7 +6173,8 @@ export namespace GenerateEmbedResponse {
     findings: Array<IPDetection.Finding>;
 
     /**
-     * Convenience flag; always true when action is not 'allowed'.
+     * 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;
 
@@ -6113,8 +6235,8 @@ export interface GeneratePatchResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   costDetails?: GeneratePatchResponse.CostDetails;
 
@@ -6505,7 +6627,9 @@ export namespace GeneratePatchResponse {
            * The asset kind of the input. Only taken into account for \`file\` and
            * \`file_array\` input types. If model provides multiple kinds, the input will be
            * not able to create the asset on the flight on API side with dataurl without
-           * data:kind, prefix
+           * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+           * a model does not declare one, \`image\` is returned, which is the kind used at
+           * generation time.
            */
           kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -6533,8 +6657,9 @@ export namespace GeneratePatchResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           maxLength?: number;
 
@@ -6551,8 +6676,9 @@ export namespace GeneratePatchResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           minLength?: number;
 
@@ -6732,7 +6858,9 @@ export namespace GeneratePatchResponse {
              * The asset kind of the input. Only taken into account for \`file\` and
              * \`file_array\` input types. If model provides multiple kinds, the input will be
              * not able to create the asset on the flight on API side with dataurl without
-             * data:kind, prefix
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
              */
             kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -6760,8 +6888,9 @@ export namespace GeneratePatchResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             maxLength?: number;
 
@@ -6778,8 +6907,9 @@ export namespace GeneratePatchResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             minLength?: number;
 
@@ -7084,7 +7214,7 @@ export namespace GeneratePatchResponse {
 
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -7114,7 +7244,7 @@ export namespace GeneratePatchResponse {
     export namespace Billing {
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -7134,7 +7264,7 @@ export namespace GeneratePatchResponse {
       export interface CuCostDetails {
         'ip-detection'?: number;
 
-        'slop-detection'?: number;
+        'quality-gate'?: number;
       }
     }
   }
@@ -7368,6 +7498,64 @@ export namespace GeneratePatchResponse {
      */
     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/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-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
@@ -7383,12 +7571,12 @@ export namespace GeneratePatchResponse {
     preview?: Asset.Preview;
 
     /**
-     * SlopGuard detection result, computed asynchronously after generation.
+     * Quality Gate result, computed asynchronously after generation.
      *
      * `details` (the per-dimension reasons and suggestions) is returned only when the
-     * asset is read with `withSlopGuardDetails=true`.
+     * asset is read with `withQualityGateDetails=true`.
      */
-    slopGuard?: Asset.SlopGuard;
+    qualityGate?: Asset.QualityGate;
 
     /**
      * The asset's thumbnail.
@@ -8307,12 +8495,12 @@ export namespace GeneratePatchResponse {
     }
 
     /**
-     * SlopGuard detection result, computed asynchronously after generation.
+     * Quality Gate result, computed asynchronously after generation.
      *
      * `details` (the per-dimension reasons and suggestions) is returned only when the
-     * asset is read with `withSlopGuardDetails=true`.
+     * asset is read with `withQualityGateDetails=true`.
      */
-    export interface SlopGuard {
+    export interface QualityGate {
       /**
        * ISO-8601 timestamp of when scoring ran
        */
@@ -8346,13 +8534,13 @@ export namespace GeneratePatchResponse {
       /**
        * Per-dimension reasons and suggestions, as produced by the detector.
        *
-       * Returned only when the asset is read with `withSlopGuardDetails=true` by the
+       * 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?: SlopGuard.Details;
+      details?: QualityGate.Details;
 
       /**
        * Error message when status is 'error' (truncated)
@@ -8375,11 +8563,11 @@ export namespace GeneratePatchResponse {
       verdict?: 'fail' | 'pass' | 'warn';
     }
 
-    export namespace SlopGuard {
+    export namespace QualityGate {
       /**
        * Per-dimension reasons and suggestions, as produced by the detector.
        *
-       * Returned only when the asset is read with `withSlopGuardDetails=true` by the
+       * 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
@@ -8455,8 +8643,8 @@ export namespace GeneratePatchResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   export interface CostDetails {
     'assistant-message'?: number;
@@ -8481,6 +8669,8 @@ export namespace GeneratePatchResponse {
 
     prompt?: number;
 
+    'quality-gate'?: number;
+
     'remove-background'?: number;
 
     repaint?: number;
@@ -8493,8 +8683,6 @@ export namespace GeneratePatchResponse {
 
     'skybox-upscale-360'?: number;
 
-    'slop-detection'?: number;
-
     texture?: number;
 
     'train-model'?: number;
@@ -8516,8 +8704,16 @@ export namespace GeneratePatchResponse {
     action: 'allowed' | 'blocked' | 'flagged';
 
     /**
-     * IP-detection CU fee, separate from creativeUnitsCost: a fixed base fee plus a
-     * per-image fee for each analyzed input image.
+     * 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;
 
@@ -8532,7 +8728,8 @@ export namespace GeneratePatchResponse {
     findings: Array<IPDetection.Finding>;
 
     /**
-     * Convenience flag; always true when action is not 'allowed'.
+     * 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;
 
@@ -8602,8 +8799,8 @@ export interface GeneratePromptResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   costDetails?: GeneratePromptResponse.CostDetails;
 
@@ -8999,7 +9196,9 @@ export namespace GeneratePromptResponse {
            * The asset kind of the input. Only taken into account for \`file\` and
            * \`file_array\` input types. If model provides multiple kinds, the input will be
            * not able to create the asset on the flight on API side with dataurl without
-           * data:kind, prefix
+           * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+           * a model does not declare one, \`image\` is returned, which is the kind used at
+           * generation time.
            */
           kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -9027,8 +9226,9 @@ export namespace GeneratePromptResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           maxLength?: number;
 
@@ -9045,8 +9245,9 @@ export namespace GeneratePromptResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           minLength?: number;
 
@@ -9226,7 +9427,9 @@ export namespace GeneratePromptResponse {
              * The asset kind of the input. Only taken into account for \`file\` and
              * \`file_array\` input types. If model provides multiple kinds, the input will be
              * not able to create the asset on the flight on API side with dataurl without
-             * data:kind, prefix
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
              */
             kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -9254,8 +9457,9 @@ export namespace GeneratePromptResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             maxLength?: number;
 
@@ -9272,8 +9476,9 @@ export namespace GeneratePromptResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             minLength?: number;
 
@@ -9578,7 +9783,7 @@ export namespace GeneratePromptResponse {
 
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -9608,7 +9813,7 @@ export namespace GeneratePromptResponse {
     export namespace Billing {
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -9628,7 +9833,7 @@ export namespace GeneratePromptResponse {
       export interface CuCostDetails {
         'ip-detection'?: number;
 
-        'slop-detection'?: number;
+        'quality-gate'?: number;
       }
     }
   }
@@ -9660,8 +9865,8 @@ export namespace GeneratePromptResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   export interface CostDetails {
     'assistant-message'?: number;
@@ -9686,6 +9891,8 @@ export namespace GeneratePromptResponse {
 
     prompt?: number;
 
+    'quality-gate'?: number;
+
     'remove-background'?: number;
 
     repaint?: number;
@@ -9698,8 +9905,6 @@ export namespace GeneratePromptResponse {
 
     'skybox-upscale-360'?: number;
 
-    'slop-detection'?: number;
-
     texture?: number;
 
     'train-model'?: number;
@@ -9721,8 +9926,16 @@ export namespace GeneratePromptResponse {
     action: 'allowed' | 'blocked' | 'flagged';
 
     /**
-     * IP-detection CU fee, separate from creativeUnitsCost: a fixed base fee plus a
-     * per-image fee for each analyzed input image.
+     * 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;
 
@@ -9737,7 +9950,8 @@ export namespace GeneratePromptResponse {
     findings: Array<IPDetection.Finding>;
 
     /**
-     * Convenience flag; always true when action is not 'allowed'.
+     * 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;
 
@@ -9796,8 +10010,8 @@ export interface GenerateRunModelResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   costDetails?: GenerateRunModelResponse.CostDetails;
 
@@ -10188,7 +10402,9 @@ export namespace GenerateRunModelResponse {
            * The asset kind of the input. Only taken into account for \`file\` and
            * \`file_array\` input types. If model provides multiple kinds, the input will be
            * not able to create the asset on the flight on API side with dataurl without
-           * data:kind, prefix
+           * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+           * a model does not declare one, \`image\` is returned, which is the kind used at
+           * generation time.
            */
           kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -10216,8 +10432,9 @@ export namespace GenerateRunModelResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           maxLength?: number;
 
@@ -10234,8 +10451,9 @@ export namespace GenerateRunModelResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           minLength?: number;
 
@@ -10415,7 +10633,9 @@ export namespace GenerateRunModelResponse {
              * The asset kind of the input. Only taken into account for \`file\` and
              * \`file_array\` input types. If model provides multiple kinds, the input will be
              * not able to create the asset on the flight on API side with dataurl without
-             * data:kind, prefix
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
              */
             kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -10443,8 +10663,9 @@ export namespace GenerateRunModelResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             maxLength?: number;
 
@@ -10461,8 +10682,9 @@ export namespace GenerateRunModelResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             minLength?: number;
 
@@ -10767,7 +10989,7 @@ export namespace GenerateRunModelResponse {
 
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -10797,7 +11019,7 @@ export namespace GenerateRunModelResponse {
     export namespace Billing {
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -10817,7 +11039,7 @@ export namespace GenerateRunModelResponse {
       export interface CuCostDetails {
         'ip-detection'?: number;
 
-        'slop-detection'?: number;
+        'quality-gate'?: number;
       }
     }
   }
@@ -10825,8 +11047,8 @@ export namespace GenerateRunModelResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   export interface CostDetails {
     'assistant-message'?: number;
@@ -10851,6 +11073,8 @@ export namespace GenerateRunModelResponse {
 
     prompt?: number;
 
+    'quality-gate'?: number;
+
     'remove-background'?: number;
 
     repaint?: number;
@@ -10863,8 +11087,6 @@ export namespace GenerateRunModelResponse {
 
     'skybox-upscale-360'?: number;
 
-    'slop-detection'?: number;
-
     texture?: number;
 
     'train-model'?: number;
@@ -10886,8 +11108,16 @@ export namespace GenerateRunModelResponse {
     action: 'allowed' | 'blocked' | 'flagged';
 
     /**
-     * IP-detection CU fee, separate from creativeUnitsCost: a fixed base fee plus a
-     * per-image fee for each analyzed input image.
+     * 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;
 
@@ -10902,7 +11132,8 @@ export namespace GenerateRunModelResponse {
     findings: Array<IPDetection.Finding>;
 
     /**
-     * Convenience flag; always true when action is not 'allowed'.
+     * 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;
 
@@ -10971,8 +11202,8 @@ export interface GenerateTranslateResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   costDetails?: GenerateTranslateResponse.CostDetails;
 
@@ -11363,7 +11594,9 @@ export namespace GenerateTranslateResponse {
            * The asset kind of the input. Only taken into account for \`file\` and
            * \`file_array\` input types. If model provides multiple kinds, the input will be
            * not able to create the asset on the flight on API side with dataurl without
-           * data:kind, prefix
+           * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+           * a model does not declare one, \`image\` is returned, which is the kind used at
+           * generation time.
            */
           kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -11391,8 +11624,9 @@ export namespace GenerateTranslateResponse {
           maxDuration?: number;
 
           /**
-           * The maximum allowed length for \`string\` inputs. Also applies to each item in
-           * \`string_array\`.
+           * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           maxLength?: number;
 
@@ -11409,8 +11643,9 @@ export namespace GenerateTranslateResponse {
           min?: number;
 
           /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
+           * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+           * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+           * ITEMS instead — the length of each item is not constrained.
            */
           minLength?: number;
 
@@ -11590,7 +11825,9 @@ export namespace GenerateTranslateResponse {
              * The asset kind of the input. Only taken into account for \`file\` and
              * \`file_array\` input types. If model provides multiple kinds, the input will be
              * not able to create the asset on the flight on API side with dataurl without
-             * data:kind, prefix
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
              */
             kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -11618,8 +11855,9 @@ export namespace GenerateTranslateResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             maxLength?: number;
 
@@ -11636,8 +11874,9 @@ export namespace GenerateTranslateResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             minLength?: number;
 
@@ -11942,7 +12181,7 @@ export namespace GenerateTranslateResponse {
 
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -11972,7 +12211,7 @@ export namespace GenerateTranslateResponse {
     export namespace Billing {
       /**
        * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-       * top of the generation itself, such as `slop-detection`.
+       * top of the generation itself, such as `quality-gate`.
        *
        * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
        * values here.
@@ -11992,7 +12231,7 @@ export namespace GenerateTranslateResponse {
       export interface CuCostDetails {
         'ip-detection'?: number;
 
-        'slop-detection'?: number;
+        'quality-gate'?: number;
       }
     }
   }
@@ -12000,8 +12239,8 @@ export namespace GenerateTranslateResponse {
   /**
    * 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
-   * `slop-detection`) — including on dryRun estimates.
+   * charge appear. Lets clients split the total (e.g. generation vs `quality-gate`)
+   * — including on dryRun estimates.
    */
   export interface CostDetails {
     'assistant-message'?: number;
@@ -12026,6 +12265,8 @@ export namespace GenerateTranslateResponse {
 
     prompt?: number;
 
+    'quality-gate'?: number;
+
     'remove-background'?: number;
 
     repaint?: number;
@@ -12038,8 +12279,6 @@ export namespace GenerateTranslateResponse {
 
     'skybox-upscale-360'?: number;
 
-    'slop-detection'?: number;
-
     texture?: number;
 
     'train-model'?: number;
@@ -12061,8 +12300,16 @@ export namespace GenerateTranslateResponse {
     action: 'allowed' | 'blocked' | 'flagged';
 
     /**
-     * IP-detection CU fee, separate from creativeUnitsCost: a fixed base fee plus a
-     * per-image fee for each analyzed input image.
+     * 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;
 
@@ -12077,7 +12324,8 @@ export namespace GenerateTranslateResponse {
     findings: Array<IPDetection.Finding>;
 
     /**
-     * Convenience flag; always true when action is not 'allowed'.
+     * 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;
 
@@ -12152,14 +12400,16 @@ export interface GenerateCaptionParams {
   images: Array<string>;
 
   /**
-   * Query param
+   * 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?: unknown;
+  dryRun?: 'true' | 'api';
 
   /**
-   * Query param
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId?: unknown;
+  projectId?: string;
 
   /**
    * Body param: The assetIds to generate captions. Results are returned in the same
@@ -12222,14 +12472,16 @@ export interface GenerateCaptionParams {
 
 export interface GenerateDescribeStyleParams {
   /**
-   * Query param
+   * 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?: unknown;
+  dryRun?: 'true' | 'api';
 
   /**
-   * Query param
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId?: unknown;
+  projectId?: string;
 
   /**
    * Body param: The asset ids used to condition the generation.
@@ -12324,9 +12576,10 @@ export interface GenerateDetectParams {
     | 'sketch';
 
   /**
-   * Query param
+   * 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?: unknown;
+  dryRun?: 'true' | 'api';
 
   /**
    * Query param: If set to true, returns the original asset without transformation
@@ -12334,9 +12587,10 @@ export interface GenerateDetectParams {
   originalAssets?: boolean;
 
   /**
-   * Query param
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId?: unknown;
+  projectId?: string;
 
   /**
    * Body param: Contrast factor for Grayscale detector
@@ -12382,9 +12636,10 @@ export interface GenerateEmbedParams {
   text: string;
 
   /**
-   * Query param
+   * 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?: unknown;
+  dryRun?: 'true' | 'api';
 
   /**
    * Query param: If set to true, returns the original asset without transformation
@@ -12392,9 +12647,10 @@ export interface GenerateEmbedParams {
   originalAssets?: boolean;
 
   /**
-   * Query param
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId?: unknown;
+  projectId?: string;
 }
 
 export interface GeneratePatchParams {
@@ -12405,20 +12661,16 @@ export interface GeneratePatchParams {
    */
   image: string;
 
-  /**
-   * Query param
-   */
-  dryRun?: unknown;
-
   /**
    * Query param: If set to true, returns the original asset without transformation
    */
   originalAssets?: boolean;
 
   /**
-   * Query param
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId?: unknown;
+  projectId?: string;
 
   /**
    * Body param: Whether to allow the merged image to extend the size of the original
@@ -12511,14 +12763,16 @@ export interface GeneratePromptParams {
   mode: 'completion' | 'contextual' | 'contextual-v2' | 'image-editing' | 'inventive' | 'structured';
 
   /**
-   * Query param
+   * 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?: unknown;
+  dryRun?: 'true' | 'api';
 
   /**
-   * Query param
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId?: unknown;
+  projectId?: string;
 
   /**
    * Body param: The asset ids used to condition the generation.
@@ -12624,14 +12878,17 @@ export interface GenerateRunModelParams {
   body: unknown;
 
   /**
-   * Query param
+   * 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?: unknown;
+  dryRun?: 'true' | 'api';
 
   /**
    * Query param: Set to "true" to run an IP-detection preflight on this request.
    * Combine with ?dryRun=true for an advisory check that returns findings without
-   * generating.
+   * generating — note the detection fee is charged even then. Ignored (no detection,
+   * no fee) for a team without the Enterprise plan. To check prompts or assets
+   * without a generation, use POST /generate/ip-detection.
    */
   ipDetection?: boolean;
 
@@ -12649,14 +12906,16 @@ export interface GenerateTranslateParams {
   prompt: string;
 
   /**
-   * Query param
+   * 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?: unknown;
+  dryRun?: 'true' | 'api';
 
   /**
-   * Query param
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
    */
-  projectId?: unknown;
+  projectId?: string;
 
   /**
    * Body param: Whether we try to ensure IP removal for new prompt generation.