@scenario-labs/sdk 2.7.0 → 3.1.0

package/src/resources/uploads.ts

@@ -10,15 +10,20 @@ export class Uploads extends APIResource {
    * Create a temporary upload URL for a file. Support multipart uploads. Return a
    * list of URLs for each part of the file.
    */
-  create(body: UploadCreateParams, options?: RequestOptions): APIPromise<UploadCreateResponse> {
-    return this._client.post('/uploads', { body, ...options });
+  create(params: UploadCreateParams, options?: RequestOptions): APIPromise<UploadCreateResponse> {
+    const { projectId, ...body } = params;
+    return this._client.post('/uploads', { query: { projectId }, body, ...options });
   }
 
   /**
    * Get the details of an existing upload
    */
-  retrieve(uploadID: string, options?: RequestOptions): APIPromise<UploadRetrieveResponse> {
-    return this._client.get(path`/uploads/${uploadID}`, options);
+  retrieve(
+    uploadID: string,
+    query: UploadRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<UploadRetrieveResponse> {
+    return this._client.get(path`/uploads/${uploadID}`, { query, ...options });
   }
 
   /**
@@ -26,10 +31,11 @@ export class Uploads extends APIResource {
    */
   triggerAction(
     uploadID: string,
-    body: UploadTriggerActionParams,
+    params: UploadTriggerActionParams,
     options?: RequestOptions,
   ): APIPromise<UploadTriggerActionResponse> {
-    return this._client.post(path`/uploads/${uploadID}/action`, { body, ...options });
+    const { projectId, ...body } = params;
+    return this._client.post(path`/uploads/${uploadID}/action`, { query: { projectId }, body, ...options });
   }
 }
 
@@ -275,53 +281,62 @@ export namespace UploadTriggerActionResponse {
 
 export interface UploadCreateParams {
   /**
-   * Asset extra options. Only available for kinds which produce an asset. (Not
-   * available for model kind)
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
+  /**
+   * Body param: Asset extra options. Only available for kinds which produce an
+   * asset. (Not available for model kind)
    */
   assetOptions?: UploadCreateParams.AssetOptions;
 
   /**
-   * The civitai.com url of the model (example:
+   * Body param: The civitai.com url of the model (example:
    * "https://civitai.com/models/370194/translucent-subsurface-scattering-test?modelVersionId=413566").
    */
   civitaiModelUrl?: string;
 
   /**
-   * Required for multipart upload. The MIME type of the file (example: "image/jpeg")
+   * Body param: Required for multipart upload. The MIME type of the file (example:
+   * "image/jpeg")
    */
   contentType?: string;
 
   /**
-   * Required for multipart upload. The original file name of the image (example:
-   * "low-res-image.jpg"). It will be ignored if assetId is provided.
+   * Body param: Required for multipart upload. The original file name of the image
+   * (example: "low-res-image.jpg"). It will be ignored if assetId is provided.
    */
   fileName?: string;
 
   /**
-   * Required for multipart upload. The size of the file in bytes
+   * Body param: Required for multipart upload. The size of the file in bytes
    */
   fileSize?: number;
 
   /**
-   * The huggingface.co modelName (example: "black-forest-labs/FLUX.1-dev"). No need
-   * to setup other fields if you setup huggingFaceModelName
+   * Body param: The huggingface.co modelName (example:
+   * "black-forest-labs/FLUX.1-dev"). No need to setup other fields if you setup
+   * huggingFaceModelName
    */
   huggingFaceModelName?: string;
 
   /**
-   * Required for multipart upload and url. The purpose of the file once validated
-   * (example: "model")
+   * Body param: Required for multipart upload and url. The purpose of the file once
+   * validated (example: "model")
    */
   kind?: '3d' | 'asset' | 'audio' | 'avatar' | 'image' | 'model' | 'text' | 'video';
 
   /**
-   * Required for multipart upload. The number of parts the file will be uploaded in
+   * Body param: Required for multipart upload. The number of parts the file will be
+   * uploaded in
    */
   parts?: number;
 
   /**
-   * The url where to download the file. If you setup url you MUST setup kind as
-   * well.
+   * Body param: The url where to download the file. If you setup url you MUST setup
+   * kind as well.
    */
   url?: string;
 }
@@ -349,12 +364,21 @@ export namespace UploadCreateParams {
   }
 }
 
+export interface UploadRetrieveParams {
+  projectId?: unknown;
+}
+
 export interface UploadTriggerActionParams {
   /**
-   * The action to perform on an upload, currently only "upload-complete" is
-   * supported
+   * Body param: The action to perform on an upload, currently only "upload-complete"
+   * is supported
    */
   action: 'complete';
+
+  /**
+   * Query param
+   */
+  projectId?: unknown;
 }
 
 export declare namespace Uploads {
@@ -363,6 +387,7 @@ export declare namespace Uploads {
     type UploadRetrieveResponse as UploadRetrieveResponse,
     type UploadTriggerActionResponse as UploadTriggerActionResponse,
     type UploadCreateParams as UploadCreateParams,
+    type UploadRetrieveParams as UploadRetrieveParams,
     type UploadTriggerActionParams as UploadTriggerActionParams,
   };
 }

package/src/resources/usages.ts

@@ -31,6 +31,8 @@ export interface UsageListResponse {
 
   nsfwUsages?: Array<UsageListResponse.NsfwUsage>;
 
+  slopUsages?: Array<UsageListResponse.SlopUsage>;
+
   usages?: Array<UsageListResponse.Usage>;
 }
 
@@ -277,6 +279,12 @@ export namespace UsageListResponse {
      * The Compute Units consumption for the user
      */
     value: number;
+
+    /**
+     * Compute Units consumed per billing action, when a breakdown is available
+     * (example: `{ "slop-detection": 12 }`). Values are included in `value`.
+     */
+    costDetails?: unknown;
   }
 
   export interface Entities {
@@ -652,12 +660,12 @@ export namespace UsageListResponse {
           /**
            * 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).
@@ -1747,6 +1755,43 @@ export namespace UsageListResponse {
     }
   }
 
+  /**
+   * A SlopGuard verdict series: one per bucket (total | pass | warn | fail).
+   */
+  export interface SlopUsage {
+    /**
+     * The data points
+     */
+    points: Array<SlopUsage.Point>;
+
+    /**
+     * The verdict bucket: "total", "pass", "warn", or "fail"
+     */
+    verdict: string;
+  }
+
+  export namespace SlopUsage {
+    /**
+     * One time-bucket point in a SlopGuard verdict series.
+     */
+    export interface Point {
+      /**
+       * Distinct scored assets in this bucket for this verdict
+       */
+      count: number;
+
+      /**
+       * Of `count`, the number of assets generated via an API key.
+       */
+      countApiKey: number;
+
+      /**
+       * The UTC ISO date of the point
+       */
+      time: string;
+    }
+  }
+
   export interface Usage {
     /**
      * Granularity for points (example: "1d", "1h", "1m", "15m")
@@ -1840,13 +1885,13 @@ export interface UsageListParams {
 
   /**
    * When set, points whose numeric fields are all zero are removed from `usages`,
-   * `modelUsages`, `assetUsages` and `nsfwUsages`. The parent entry (model, kind,
-   * label, usageName) is preserved with `points: []` so callers still see every row.
-   * Useful on wide windows × fine granularities × many models, where the zero-fill
-   * can push the response past the 6 MB API Gateway sync limit. The bare
-   * `?dropZeroPoints` form, plus any value (`true`, `1`, `yes`, `on`, …) enables it;
-   * absent or explicit falsy literals (`false`, `0`, `no`, `off`) disable it.
-   * Default disabled for backwards compatibility.
+   * `modelUsages`, `assetUsages`, `nsfwUsages` and `slopUsages`. The parent entry
+   * (model, kind, label, usageName) is preserved with `points: []` so callers still
+   * see every row. Useful on wide windows × fine granularities × many models, where
+   * the zero-fill can push the response past the 6 MB API Gateway sync limit. The
+   * bare `?dropZeroPoints` form, plus any value (`true`, `1`, `yes`, `on`, …)
+   * enables it; absent or explicit falsy literals (`false`, `0`, `no`, `off`)
+   * disable it. Default disabled for backwards compatibility.
    */
   dropZeroPoints?: boolean;
 
@@ -1868,6 +1913,12 @@ export interface UsageListParams {
    */
   startDate?: string;
 
+  /**
+   * The teamId used for ownership resource management. Either to assert ownership or
+   * to set the owner of the resource(s)
+   */
+  teamId?: string;
+
   /**
    * The time range of the usage. If not provided, use default timeRange. If
    * startDate and endDate provided, timeRange is ignored.
@@ -1877,10 +1928,12 @@ export interface UsageListParams {
   /**
    * The type of the usage data. Can be one or more comma separated values. Can be
    * any of the following values: usages, activity, consumption, model-usages,
-   * asset-usages, nsfw-usages. Default is all types. If bad type or empty, all types
-   * will be returned.
+   * asset-usages, nsfw-usages, slop-usages. Default is all types. If bad type or
+   * empty, all types will be returned.
    */
-  type?: Array<'usages' | 'activity' | 'consumption' | 'model-usages' | 'asset-usages' | 'nsfw-usages'>;
+  type?: Array<
+    'usages' | 'activity' | 'consumption' | 'model-usages' | 'asset-usages' | 'nsfw-usages' | 'slop-usages'
+  >;
 
   /**
    * The unique identifier of the user for the usage. If not provided, returns all