@scenario-labs/sdk 2.7.0 → 3.0.0

package/src/resources/generate.ts

@@ -10,8 +10,8 @@ export class Generate extends APIResource {
    * Caption image(s)
    */
   caption(params: GenerateCaptionParams, options?: RequestOptions): APIPromise<GenerateCaptionResponse> {
-    const { dryRun, ...body } = params;
-    return this._client.post('/generate/caption', { query: { dryRun }, body, ...options });
+    const { dryRun, projectId, ...body } = params;
+    return this._client.post('/generate/caption', { query: { dryRun, projectId }, body, ...options });
   }
 
   /**
@@ -21,8 +21,8 @@ export class Generate extends APIResource {
     params: GenerateDescribeStyleParams,
     options?: RequestOptions,
   ): APIPromise<GenerateDescribeStyleResponse> {
-    const { dryRun, ...body } = params;
-    return this._client.post('/generate/describe-style', { query: { dryRun }, body, ...options });
+    const { dryRun, projectId, ...body } = params;
+    return this._client.post('/generate/describe-style', { query: { dryRun, projectId }, body, ...options });
   }
 
   /**
@@ -30,32 +30,44 @@ export class Generate extends APIResource {
    * images into mode maps.
    */
   detect(params: GenerateDetectParams, options?: RequestOptions): APIPromise<GenerateDetectResponse> {
-    const { dryRun, originalAssets, ...body } = params;
-    return this._client.post('/generate/detect', { query: { dryRun, originalAssets }, body, ...options });
+    const { dryRun, originalAssets, projectId, ...body } = params;
+    return this._client.post('/generate/detect', {
+      query: { dryRun, originalAssets, projectId },
+      body,
+      ...options,
+    });
   }
 
   /**
    * Get embeddings from text
    */
   embed(params: GenerateEmbedParams, options?: RequestOptions): APIPromise<GenerateEmbedResponse> {
-    const { dryRun, originalAssets, ...body } = params;
-    return this._client.post('/generate/embed', { query: { dryRun, originalAssets }, body, ...options });
+    const { dryRun, originalAssets, projectId, ...body } = params;
+    return this._client.post('/generate/embed', {
+      query: { dryRun, originalAssets, projectId },
+      body,
+      ...options,
+    });
   }
 
   /**
    * Patch an asset with an image.
    */
   patch(params: GeneratePatchParams, options?: RequestOptions): APIPromise<GeneratePatchResponse> {
-    const { dryRun, originalAssets, ...body } = params;
-    return this._client.post('/generate/patch', { query: { dryRun, originalAssets }, body, ...options });
+    const { dryRun, originalAssets, projectId, ...body } = params;
+    return this._client.post('/generate/patch', {
+      query: { dryRun, originalAssets, projectId },
+      body,
+      ...options,
+    });
   }
 
   /**
    * Generate, complete or invent new prompts.
    */
   prompt(params: GeneratePromptParams, options?: RequestOptions): APIPromise<GeneratePromptResponse> {
-    const { dryRun, ...body } = params;
-    return this._client.post('/generate/prompt', { query: { dryRun }, body, ...options });
+    const { dryRun, projectId, ...body } = params;
+    return this._client.post('/generate/prompt', { query: { dryRun, projectId }, body, ...options });
   }
 
   /**
@@ -68,9 +80,9 @@ export class Generate extends APIResource {
     params: GenerateRunModelParams,
     options?: RequestOptions,
   ): APIPromise<GenerateRunModelResponse> {
-    const { body, dryRun, ipDetection } = params;
+    const { body, dryRun, ipDetection, projectId } = params;
     return this._client.post(path`/generate/custom/${modelID}`, {
-      query: { dryRun, ipDetection },
+      query: { dryRun, ipDetection, projectId },
       body: body,
       ...options,
     });
@@ -83,8 +95,8 @@ export class Generate extends APIResource {
     params: GenerateTranslateParams,
     options?: RequestOptions,
   ): APIPromise<GenerateTranslateResponse> {
-    const { dryRun, ...body } = params;
-    return this._client.post('/generate/translate', { query: { dryRun }, body, ...options });
+    const { dryRun, projectId, ...body } = params;
+    return this._client.post('/generate/translate', { query: { dryRun, projectId }, body, ...options });
   }
 }
 
@@ -96,6 +108,14 @@ export interface GenerateCaptionResponse {
 
   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
    */
@@ -1068,6 +1088,27 @@ export namespace GenerateCaptionResponse {
 
       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.
@@ -1075,6 +1116,87 @@ export namespace GenerateCaptionResponse {
        */
       disableRefund?: boolean;
     }
+
+    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`.
+       *
+       * `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.
+       */
+      export 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.
+   */
+  export interface CostDetails {
+    'assistant-message'?: number;
+
+    caption?: number;
+
+    'custom-generation'?: number;
+
+    'describe-style'?: number;
+
+    detection?: number;
+
+    embed?: number;
+
+    'image-prompt-editing'?: number;
+
+    'inference-images'?: number;
+
+    'ip-detection'?: number;
+
+    pixelate?: number;
+
+    prompt?: number;
+
+    '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;
   }
 
   /**
@@ -1169,6 +1291,14 @@ export interface GenerateDescribeStyleResponse {
    */
   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
    */
@@ -2133,6 +2263,27 @@ export namespace GenerateDescribeStyleResponse {
 
       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.
@@ -2140,6 +2291,87 @@ export namespace GenerateDescribeStyleResponse {
        */
       disableRefund?: boolean;
     }
+
+    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`.
+       *
+       * `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.
+       */
+      export 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.
+   */
+  export interface CostDetails {
+    'assistant-message'?: number;
+
+    caption?: number;
+
+    'custom-generation'?: number;
+
+    'describe-style'?: number;
+
+    detection?: number;
+
+    embed?: number;
+
+    'image-prompt-editing'?: number;
+
+    'inference-images'?: number;
+
+    'ip-detection'?: number;
+
+    pixelate?: number;
+
+    prompt?: number;
+
+    '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;
   }
 
   /**
@@ -2226,6 +2458,14 @@ export interface GenerateDetectResponse {
 
   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
    */
@@ -3190,6 +3430,27 @@ export namespace GenerateDetectResponse {
 
       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.
@@ -3197,6 +3458,33 @@ export namespace GenerateDetectResponse {
        */
       disableRefund?: boolean;
     }
+
+    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`.
+       *
+       * `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.
+       */
+      export interface CuCostDetails {
+        'ip-detection'?: number;
+
+        'slop-detection'?: number;
+      }
+    }
   }
 
   export interface Asset {
@@ -3442,6 +3730,14 @@ export namespace GenerateDetectResponse {
      */
     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.
      *
@@ -4358,6 +4654,140 @@ export namespace GenerateDetectResponse {
       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`.
+     */
+    export 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';
+    }
+
+    export 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).
+       */
+      export interface Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        aiQuality: Details.AIQuality;
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        briefCompliance?: Details.BriefCompliance;
+      }
+
+      export namespace Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        export interface AIQuality {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        export interface BriefCompliance {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+      }
+    }
+
     /**
      * The asset's thumbnail.
      *
@@ -4370,6 +4800,60 @@ 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.
+   */
+  export interface CostDetails {
+    'assistant-message'?: number;
+
+    caption?: number;
+
+    'custom-generation'?: number;
+
+    'describe-style'?: number;
+
+    detection?: number;
+
+    embed?: number;
+
+    'image-prompt-editing'?: number;
+
+    'inference-images'?: number;
+
+    'ip-detection'?: number;
+
+    pixelate?: number;
+
+    prompt?: number;
+
+    '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.
    */
@@ -4459,6 +4943,14 @@ export interface GenerateEmbedResponse {
 
   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
    */
@@ -5423,6 +5915,27 @@ export namespace GenerateEmbedResponse {
 
       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.
@@ -5430,26 +5943,107 @@ export namespace GenerateEmbedResponse {
        */
       disableRefund?: boolean;
     }
+
+    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`.
+       *
+       * `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.
+       */
+      export interface CuCostDetails {
+        'ip-detection'?: number;
+
+        'slop-detection'?: number;
+      }
+    }
   }
 
   /**
-   * IP detection findings, when detection ran for this request.
+   * 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.
    */
-  export interface IPDetection {
-    /**
-     * Whether and how detection affected the request.
-     */
-    action: 'allowed' | 'blocked' | 'flagged';
+  export interface CostDetails {
+    'assistant-message'?: number;
 
-    /**
-     * IP-detection CU fee, separate from creativeUnitsCost: a fixed base fee plus a
-     * per-image fee for each analyzed input image.
-     */
-    creativeUnitsCharged: number;
+    caption?: number;
 
-    /**
-     * Number of enabled filters evaluated for this request.
-     */
+    '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.
+   */
+  export interface IPDetection {
+    /**
+     * Whether and how detection affected the request.
+     */
+    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.
+     */
+    creativeUnitsCharged: number;
+
+    /**
+     * Number of enabled filters evaluated for this request.
+     */
     evaluatedFilters: number;
 
     /**
@@ -5516,6 +6110,14 @@ export interface GeneratePatchResponse {
 
   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
    */
@@ -6480,6 +7082,27 @@ export namespace GeneratePatchResponse {
 
       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.
@@ -6487,6 +7110,33 @@ export namespace GeneratePatchResponse {
        */
       disableRefund?: boolean;
     }
+
+    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`.
+       *
+       * `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.
+       */
+      export interface CuCostDetails {
+        'ip-detection'?: number;
+
+        'slop-detection'?: number;
+      }
+    }
   }
 
   export interface Asset {
@@ -6732,6 +7382,14 @@ export namespace GeneratePatchResponse {
      */
     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.
      *
@@ -7648,6 +8306,140 @@ export namespace GeneratePatchResponse {
       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`.
+     */
+    export 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';
+    }
+
+    export 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).
+       */
+      export interface Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        aiQuality: Details.AIQuality;
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        briefCompliance?: Details.BriefCompliance;
+      }
+
+      export namespace Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        export interface AIQuality {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        export interface BriefCompliance {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+      }
+    }
+
     /**
      * The asset's thumbnail.
      *
@@ -7660,6 +8452,60 @@ 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.
+   */
+  export interface CostDetails {
+    'assistant-message'?: number;
+
+    caption?: number;
+
+    'custom-generation'?: number;
+
+    'describe-style'?: number;
+
+    detection?: number;
+
+    embed?: number;
+
+    'image-prompt-editing'?: number;
+
+    'inference-images'?: number;
+
+    'ip-detection'?: number;
+
+    pixelate?: number;
+
+    prompt?: number;
+
+    '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.
    */
@@ -7753,6 +8599,14 @@ export interface GeneratePromptResponse {
    */
   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
    */
@@ -8722,6 +9576,27 @@ export namespace GeneratePromptResponse {
 
       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.
@@ -8729,6 +9604,33 @@ export namespace GeneratePromptResponse {
        */
       disableRefund?: boolean;
     }
+
+    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`.
+       *
+       * `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.
+       */
+      export interface CuCostDetails {
+        'ip-detection'?: number;
+
+        'slop-detection'?: number;
+      }
+    }
   }
 
   /**
@@ -8755,6 +9657,60 @@ export 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.
+   */
+  export interface CostDetails {
+    'assistant-message'?: number;
+
+    caption?: number;
+
+    'custom-generation'?: number;
+
+    'describe-style'?: number;
+
+    detection?: number;
+
+    embed?: number;
+
+    'image-prompt-editing'?: number;
+
+    'inference-images'?: number;
+
+    'ip-detection'?: number;
+
+    pixelate?: number;
+
+    prompt?: number;
+
+    '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.
    */
@@ -8837,6 +9793,14 @@ export 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
    */
@@ -9801,6 +10765,27 @@ export namespace GenerateRunModelResponse {
 
       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.
@@ -9808,6 +10793,87 @@ export namespace GenerateRunModelResponse {
        */
       disableRefund?: boolean;
     }
+
+    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`.
+       *
+       * `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.
+       */
+      export 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.
+   */
+  export interface CostDetails {
+    'assistant-message'?: number;
+
+    caption?: number;
+
+    'custom-generation'?: number;
+
+    'describe-style'?: number;
+
+    detection?: number;
+
+    embed?: number;
+
+    'image-prompt-editing'?: number;
+
+    'inference-images'?: number;
+
+    'ip-detection'?: number;
+
+    pixelate?: number;
+
+    prompt?: number;
+
+    '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;
   }
 
   /**
@@ -9902,6 +10968,14 @@ export interface GenerateTranslateResponse {
    */
   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
    */
@@ -10866,6 +11940,27 @@ export namespace GenerateTranslateResponse {
 
       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.
@@ -10873,6 +11968,87 @@ export namespace GenerateTranslateResponse {
        */
       disableRefund?: boolean;
     }
+
+    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`.
+       *
+       * `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.
+       */
+      export 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.
+   */
+  export interface CostDetails {
+    'assistant-message'?: number;
+
+    caption?: number;
+
+    'custom-generation'?: number;
+
+    'describe-style'?: number;
+
+    detection?: number;
+
+    embed?: number;
+
+    'image-prompt-editing'?: number;
+
+    'inference-images'?: number;
+
+    'ip-detection'?: number;
+
+    pixelate?: number;
+
+    prompt?: number;
+
+    '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;
   }
 
   /**
@@ -10980,6 +12156,11 @@ export interface GenerateCaptionParams {
    */
   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.
@@ -11045,6 +12226,11 @@ export interface GenerateDescribeStyleParams {
    */
   dryRun?: unknown;
 
+  /**
+   * Query param
+   */
+  projectId?: unknown;
+
   /**
    * Body param: The asset ids used to condition the generation.
    */
@@ -11147,6 +12333,11 @@ export interface GenerateDetectParams {
    */
   originalAssets?: boolean;
 
+  /**
+   * Query param
+   */
+  projectId?: unknown;
+
   /**
    * Body param: Contrast factor for Grayscale detector
    */
@@ -11199,6 +12390,11 @@ export interface GenerateEmbedParams {
    * Query param: If set to true, returns the original asset without transformation
    */
   originalAssets?: boolean;
+
+  /**
+   * Query param
+   */
+  projectId?: unknown;
 }
 
 export interface GeneratePatchParams {
@@ -11219,6 +12415,11 @@ export interface GeneratePatchParams {
    */
   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)
@@ -11314,6 +12515,11 @@ export interface GeneratePromptParams {
    */
   dryRun?: unknown;
 
+  /**
+   * Query param
+   */
+  projectId?: unknown;
+
   /**
    * Body param: The asset ids used to condition the generation.
    *
@@ -11428,6 +12634,12 @@ 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 {
@@ -11441,6 +12653,11 @@ export interface GenerateTranslateParams {
    */
   dryRun?: unknown;
 
+  /**
+   * Query param
+   */
+  projectId?: unknown;
+
   /**
    * Body param: Whether we try to ensure IP removal for new prompt generation.
    */