@scenario-labs/sdk 2.7.0 → 3.1.0

package/resources/generate.d.ts

@@ -44,6 +44,13 @@ export interface GenerateCaptionResponse {
      */
     captions: Array<string>;
     job: GenerateCaptionResponse.Job;
+    /**
+     * 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.
+     */
+    costDetails?: GenerateCaptionResponse.CostDetails;
     /**
      * The Compute Units cost for the request billed
      */
@@ -746,6 +753,26 @@ export declare namespace GenerateCaptionResponse {
         interface Billing {
             cuCost: number;
             cuDiscount: number;
+            /**
+             * 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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            cuCostDetails?: Billing.CuCostDetails;
             /**
              * When true, the credits charged for this job are not automatically refunded if
              * the generation fails, because the model used does not support refund-on-failure.
@@ -753,6 +780,62 @@ export declare namespace GenerateCaptionResponse {
              */
             disableRefund?: boolean;
         }
+        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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            interface CuCostDetails {
+                'ip-detection'?: number;
+                'slop-detection'?: number;
+            }
+        }
+    }
+    /**
+     * 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.
+     */
+    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;
+        'remove-background'?: number;
+        repaint?: number;
+        restyle?: number;
+        segmentation?: number;
+        'skybox-base-360'?: number;
+        'skybox-upscale-360'?: number;
+        'slop-detection'?: number;
+        texture?: number;
+        'train-model'?: number;
+        translate?: number;
+        upscale?: number;
+        vectorization?: number;
     }
     /**
      * IP detection findings, when detection ran for this request.
@@ -830,6 +913,13 @@ export interface GenerateDescribeStyleResponse {
      * A short synthesis that describes the given asset(s) or asset(s) model.
      */
     synthesis: 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
+     * `slop-detection`) — including on dryRun estimates.
+     */
+    costDetails?: GenerateDescribeStyleResponse.CostDetails;
     /**
      * The Compute Units cost for the request billed
      */
@@ -1525,6 +1615,26 @@ export declare namespace GenerateDescribeStyleResponse {
         interface Billing {
             cuCost: number;
             cuDiscount: number;
+            /**
+             * 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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            cuCostDetails?: Billing.CuCostDetails;
             /**
              * When true, the credits charged for this job are not automatically refunded if
              * the generation fails, because the model used does not support refund-on-failure.
@@ -1532,6 +1642,62 @@ export declare namespace GenerateDescribeStyleResponse {
              */
             disableRefund?: boolean;
         }
+        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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            interface CuCostDetails {
+                'ip-detection'?: number;
+                'slop-detection'?: number;
+            }
+        }
+    }
+    /**
+     * 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.
+     */
+    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;
+        'remove-background'?: number;
+        repaint?: number;
+        restyle?: number;
+        segmentation?: number;
+        'skybox-base-360'?: number;
+        'skybox-upscale-360'?: number;
+        'slop-detection'?: number;
+        texture?: number;
+        'train-model'?: number;
+        translate?: number;
+        upscale?: number;
+        vectorization?: number;
     }
     /**
      * IP detection findings, when detection ran for this request.
@@ -1602,6 +1768,13 @@ export declare namespace GenerateDescribeStyleResponse {
 export interface GenerateDetectResponse {
     job: GenerateDetectResponse.Job;
     asset?: GenerateDetectResponse.Asset;
+    /**
+     * 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.
+     */
+    costDetails?: GenerateDetectResponse.CostDetails;
     /**
      * The Compute Units cost for the request billed
      */
@@ -2297,6 +2470,26 @@ export declare namespace GenerateDetectResponse {
         interface Billing {
             cuCost: number;
             cuDiscount: number;
+            /**
+             * 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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            cuCostDetails?: Billing.CuCostDetails;
             /**
              * When true, the credits charged for this job are not automatically refunded if
              * the generation fails, because the model used does not support refund-on-failure.
@@ -2304,6 +2497,31 @@ export declare namespace GenerateDetectResponse {
              */
             disableRefund?: boolean;
         }
+        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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            interface CuCostDetails {
+                'ip-detection'?: number;
+                'slop-detection'?: number;
+            }
+        }
     }
     interface Asset {
         /**
@@ -2430,6 +2648,13 @@ export declare namespace GenerateDetectResponse {
          * Contains the assetId and the url of the preview.
          */
         preview?: Asset.Preview;
+        /**
+         * SlopGuard detection result, computed asynchronously after generation.
+         *
+         * `details` (the per-dimension reasons and suggestions) is returned only when the
+         * asset is read with `withSlopGuardDetails=true`.
+         */
+        slopGuard?: Asset.SlopGuard;
         /**
          * The asset's thumbnail.
          *
@@ -3001,11 +3226,11 @@ export declare namespace GenerateDetectResponse {
                 /**
                  * Camera eye position in the splat's world frame.
                  */
-                position: Array<unknown>;
+                position: Array<number>;
                 /**
                  * Look-at point in the splat's world frame.
                  */
-                target: Array<unknown>;
+                target: Array<number>;
                 /**
                  * Vertical field of view in degrees (defaults to 50 in the renderer).
                  */
@@ -3045,6 +3270,121 @@ export declare namespace GenerateDetectResponse {
             assetId: string;
             url: string;
         }
+        /**
+         * SlopGuard detection result, computed asynchronously after generation.
+         *
+         * `details` (the per-dimension reasons and suggestions) is returned only when the
+         * asset is read with `withSlopGuardDetails=true`.
+         */
+        interface SlopGuard {
+            /**
+             * 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 `withSlopGuardDetails=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;
+            /**
+             * 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';
+        }
+        namespace SlopGuard {
+            /**
+             * Per-dimension reasons and suggestions, as produced by the detector.
+             *
+             * Returned only when the asset is read with `withSlopGuardDetails=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).
+             */
+            interface Details {
+                /**
+                 * Always-on generic AI-quality dimension
+                 */
+                aiQuality: Details.AIQuality;
+                /**
+                 * Brief-compliance dimension; omitted when no brief applied
+                 */
+                briefCompliance?: Details.BriefCompliance;
+            }
+            namespace Details {
+                /**
+                 * Always-on generic AI-quality dimension
+                 */
+                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
+                 */
+                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.
          *
@@ -3055,6 +3395,37 @@ export declare namespace GenerateDetectResponse {
             url: 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
+     * `slop-detection`) — including on dryRun estimates.
+     */
+    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;
+        'remove-background'?: number;
+        repaint?: number;
+        restyle?: number;
+        segmentation?: number;
+        'skybox-base-360'?: number;
+        'skybox-upscale-360'?: number;
+        'slop-detection'?: number;
+        texture?: number;
+        'train-model'?: number;
+        translate?: number;
+        upscale?: number;
+        vectorization?: number;
+    }
     /**
      * IP detection findings, when detection ran for this request.
      */
@@ -3129,6 +3500,13 @@ export interface GenerateEmbedResponse {
      */
     embedding: Array<number>;
     job: GenerateEmbedResponse.Job;
+    /**
+     * 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.
+     */
+    costDetails?: GenerateEmbedResponse.CostDetails;
     /**
      * The Compute Units cost for the request billed
      */
@@ -3824,6 +4202,26 @@ export declare namespace GenerateEmbedResponse {
         interface Billing {
             cuCost: number;
             cuDiscount: number;
+            /**
+             * 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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            cuCostDetails?: Billing.CuCostDetails;
             /**
              * When true, the credits charged for this job are not automatically refunded if
              * the generation fails, because the model used does not support refund-on-failure.
@@ -3831,6 +4229,62 @@ export declare namespace GenerateEmbedResponse {
              */
             disableRefund?: boolean;
         }
+        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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            interface CuCostDetails {
+                'ip-detection'?: number;
+                'slop-detection'?: number;
+            }
+        }
+    }
+    /**
+     * 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.
+     */
+    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;
+        'remove-background'?: number;
+        repaint?: number;
+        restyle?: number;
+        segmentation?: number;
+        'skybox-base-360'?: number;
+        'skybox-upscale-360'?: number;
+        'slop-detection'?: number;
+        texture?: number;
+        'train-model'?: number;
+        translate?: number;
+        upscale?: number;
+        vectorization?: number;
     }
     /**
      * IP detection findings, when detection ran for this request.
@@ -3901,6 +4355,13 @@ export declare namespace GenerateEmbedResponse {
 export interface GeneratePatchResponse {
     job: GeneratePatchResponse.Job;
     asset?: GeneratePatchResponse.Asset;
+    /**
+     * 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.
+     */
+    costDetails?: GeneratePatchResponse.CostDetails;
     /**
      * The Compute Units cost for the request billed
      */
@@ -4596,6 +5057,26 @@ export declare namespace GeneratePatchResponse {
         interface Billing {
             cuCost: number;
             cuDiscount: number;
+            /**
+             * 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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            cuCostDetails?: Billing.CuCostDetails;
             /**
              * When true, the credits charged for this job are not automatically refunded if
              * the generation fails, because the model used does not support refund-on-failure.
@@ -4603,6 +5084,31 @@ export declare namespace GeneratePatchResponse {
              */
             disableRefund?: boolean;
         }
+        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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            interface CuCostDetails {
+                'ip-detection'?: number;
+                'slop-detection'?: number;
+            }
+        }
     }
     interface Asset {
         /**
@@ -4729,6 +5235,13 @@ export declare namespace GeneratePatchResponse {
          * Contains the assetId and the url of the preview.
          */
         preview?: Asset.Preview;
+        /**
+         * SlopGuard detection result, computed asynchronously after generation.
+         *
+         * `details` (the per-dimension reasons and suggestions) is returned only when the
+         * asset is read with `withSlopGuardDetails=true`.
+         */
+        slopGuard?: Asset.SlopGuard;
         /**
          * The asset's thumbnail.
          *
@@ -5300,11 +5813,11 @@ export declare namespace GeneratePatchResponse {
                 /**
                  * Camera eye position in the splat's world frame.
                  */
-                position: Array<unknown>;
+                position: Array<number>;
                 /**
                  * Look-at point in the splat's world frame.
                  */
-                target: Array<unknown>;
+                target: Array<number>;
                 /**
                  * Vertical field of view in degrees (defaults to 50 in the renderer).
                  */
@@ -5344,6 +5857,121 @@ export declare namespace GeneratePatchResponse {
             assetId: string;
             url: string;
         }
+        /**
+         * SlopGuard detection result, computed asynchronously after generation.
+         *
+         * `details` (the per-dimension reasons and suggestions) is returned only when the
+         * asset is read with `withSlopGuardDetails=true`.
+         */
+        interface SlopGuard {
+            /**
+             * 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 `withSlopGuardDetails=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;
+            /**
+             * 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';
+        }
+        namespace SlopGuard {
+            /**
+             * Per-dimension reasons and suggestions, as produced by the detector.
+             *
+             * Returned only when the asset is read with `withSlopGuardDetails=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).
+             */
+            interface Details {
+                /**
+                 * Always-on generic AI-quality dimension
+                 */
+                aiQuality: Details.AIQuality;
+                /**
+                 * Brief-compliance dimension; omitted when no brief applied
+                 */
+                briefCompliance?: Details.BriefCompliance;
+            }
+            namespace Details {
+                /**
+                 * Always-on generic AI-quality dimension
+                 */
+                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
+                 */
+                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.
          *
@@ -5354,6 +5982,37 @@ export declare namespace GeneratePatchResponse {
             url: 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
+     * `slop-detection`) — including on dryRun estimates.
+     */
+    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;
+        'remove-background'?: number;
+        repaint?: number;
+        restyle?: number;
+        segmentation?: number;
+        'skybox-base-360'?: number;
+        'skybox-upscale-360'?: number;
+        'slop-detection'?: number;
+        texture?: number;
+        'train-model'?: number;
+        translate?: number;
+        upscale?: number;
+        vectorization?: number;
+    }
     /**
      * IP detection findings, when detection ran for this request.
      */
@@ -5431,6 +6090,13 @@ export interface GeneratePromptResponse {
      * the prompt text of `calls[i]`.
      */
     calls?: Array<GeneratePromptResponse.Call>;
+    /**
+     * 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.
+     */
+    costDetails?: GeneratePromptResponse.CostDetails;
     /**
      * The Compute Units cost for the request billed
      */
@@ -6130,6 +6796,26 @@ export declare namespace GeneratePromptResponse {
         interface Billing {
             cuCost: number;
             cuDiscount: number;
+            /**
+             * 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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            cuCostDetails?: Billing.CuCostDetails;
             /**
              * When true, the credits charged for this job are not automatically refunded if
              * the generation fails, because the model used does not support refund-on-failure.
@@ -6137,6 +6823,31 @@ export declare namespace GeneratePromptResponse {
              */
             disableRefund?: boolean;
         }
+        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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            interface CuCostDetails {
+                'ip-detection'?: number;
+                'slop-detection'?: number;
+            }
+        }
     }
     /**
      * A complete, ready-to-run model call proposed by Prompt Spark v3.
@@ -6159,6 +6870,37 @@ export declare namespace GeneratePromptResponse {
          */
         rationale?: 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
+     * `slop-detection`) — including on dryRun estimates.
+     */
+    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;
+        'remove-background'?: number;
+        repaint?: number;
+        restyle?: number;
+        segmentation?: number;
+        'skybox-base-360'?: number;
+        'skybox-upscale-360'?: number;
+        'slop-detection'?: number;
+        texture?: number;
+        'train-model'?: number;
+        translate?: number;
+        upscale?: number;
+        vectorization?: number;
+    }
     /**
      * IP detection findings, when detection ran for this request.
      */
@@ -6227,6 +6969,13 @@ export declare namespace GeneratePromptResponse {
 }
 export interface GenerateRunModelResponse {
     job: GenerateRunModelResponse.Job;
+    /**
+     * 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.
+     */
+    costDetails?: GenerateRunModelResponse.CostDetails;
     /**
      * The Compute Units cost for the request billed
      */
@@ -6922,6 +7671,26 @@ export declare namespace GenerateRunModelResponse {
         interface Billing {
             cuCost: number;
             cuDiscount: number;
+            /**
+             * 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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            cuCostDetails?: Billing.CuCostDetails;
             /**
              * When true, the credits charged for this job are not automatically refunded if
              * the generation fails, because the model used does not support refund-on-failure.
@@ -6929,6 +7698,62 @@ export declare namespace GenerateRunModelResponse {
              */
             disableRefund?: boolean;
         }
+        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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            interface CuCostDetails {
+                'ip-detection'?: number;
+                'slop-detection'?: number;
+            }
+        }
+    }
+    /**
+     * 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.
+     */
+    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;
+        'remove-background'?: number;
+        repaint?: number;
+        restyle?: number;
+        segmentation?: number;
+        'skybox-base-360'?: number;
+        'skybox-upscale-360'?: number;
+        'slop-detection'?: number;
+        texture?: number;
+        'train-model'?: number;
+        translate?: number;
+        upscale?: number;
+        vectorization?: number;
     }
     /**
      * IP detection findings, when detection ran for this request.
@@ -7006,6 +7831,13 @@ export interface GenerateTranslateResponse {
      * The translated prompt.
      */
     translation: 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
+     * `slop-detection`) — including on dryRun estimates.
+     */
+    costDetails?: GenerateTranslateResponse.CostDetails;
     /**
      * The Compute Units cost for the request billed
      */
@@ -7701,6 +8533,26 @@ export declare namespace GenerateTranslateResponse {
         interface Billing {
             cuCost: number;
             cuDiscount: number;
+            /**
+             * 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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            cuCostDetails?: Billing.CuCostDetails;
             /**
              * When true, the credits charged for this job are not automatically refunded if
              * the generation fails, because the model used does not support refund-on-failure.
@@ -7708,6 +8560,62 @@ export declare namespace GenerateTranslateResponse {
              */
             disableRefund?: boolean;
         }
+        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`.
+             *
+             * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+             * values here.
+             *
+             * Two caveats when displaying it:
+             *
+             * - These are a remaining refundable balance, not a receipt: a job that failed or
+             *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+             *   still shows the main action's original charge.
+             * - `ip-detection` is part of the shape but is never populated today: that fee is
+             *   charged outside the job and reported once, as
+             *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+             *   it.
+             *
+             * Absent when the job paid for no add-on.
+             */
+            interface CuCostDetails {
+                'ip-detection'?: number;
+                'slop-detection'?: number;
+            }
+        }
+    }
+    /**
+     * 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.
+     */
+    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;
+        'remove-background'?: number;
+        repaint?: number;
+        restyle?: number;
+        segmentation?: number;
+        'skybox-base-360'?: number;
+        'skybox-upscale-360'?: number;
+        'slop-detection'?: number;
+        texture?: number;
+        'train-model'?: number;
+        translate?: number;
+        upscale?: number;
+        vectorization?: number;
     }
     /**
      * IP detection findings, when detection ran for this request.
@@ -7799,6 +8707,10 @@ export interface GenerateCaptionParams {
      * Query param
      */
     dryRun?: unknown;
+    /**
+     * Query param
+     */
+    projectId?: unknown;
     /**
      * Body param: The assetIds to generate captions. Results are returned in the same
      * order as the given assetIds. Deprecated, use `images` parameter instead.
@@ -7855,6 +8767,10 @@ export interface GenerateDescribeStyleParams {
      * Query param
      */
     dryRun?: unknown;
+    /**
+     * Query param
+     */
+    projectId?: unknown;
     /**
      * Body param: The asset ids used to condition the generation.
      */
@@ -7935,6 +8851,10 @@ export interface GenerateDetectParams {
      * Query param: If set to true, returns the original asset without transformation
      */
     originalAssets?: boolean;
+    /**
+     * Query param
+     */
+    projectId?: unknown;
     /**
      * Body param: Contrast factor for Grayscale detector
      */
@@ -7978,6 +8898,10 @@ export interface GenerateEmbedParams {
      * Query param: If set to true, returns the original asset without transformation
      */
     originalAssets?: boolean;
+    /**
+     * Query param
+     */
+    projectId?: unknown;
 }
 export interface GeneratePatchParams {
     /**
@@ -7994,6 +8918,10 @@ export interface GeneratePatchParams {
      * Query param: If set to true, returns the original asset without transformation
      */
     originalAssets?: boolean;
+    /**
+     * Query param
+     */
+    projectId?: unknown;
     /**
      * Body param: Whether to allow the merged image to extend the size of the original
      * (when x or y are negative or merged image is bigger)
@@ -8072,6 +9000,10 @@ export interface GeneratePromptParams {
      * Query param
      */
     dryRun?: unknown;
+    /**
+     * Query param
+     */
+    projectId?: unknown;
     /**
      * Body param: The asset ids used to condition the generation.
      *
@@ -8174,6 +9106,11 @@ export interface GenerateRunModelParams {
      * generating.
      */
     ipDetection?: 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;
 }
 export interface GenerateTranslateParams {
     /**
@@ -8184,6 +9121,10 @@ export interface GenerateTranslateParams {
      * Query param
      */
     dryRun?: unknown;
+    /**
+     * Query param
+     */
+    projectId?: unknown;
     /**
      * Body param: Whether we try to ensure IP removal for new prompt generation.
      */