@scenario-labs/sdk 0.1.3 → 0.3.0

package/resources/usages.d.mts

@@ -11,9 +11,11 @@ export declare class Usages extends APIResource {
 }
 export interface UsageListResponse {
     activity?: Array<UsageListResponse.Activity>;
+    assetUsages?: Array<UsageListResponse.AssetUsage>;
     consumption?: Array<UsageListResponse.Consumption>;
     entities?: UsageListResponse.Entities;
     modelUsages?: Array<UsageListResponse.ModelUsage>;
+    nsfwUsages?: Array<UsageListResponse.NsfwUsage>;
     usages?: Array<UsageListResponse.Usage>;
 }
 export declare namespace UsageListResponse {
@@ -29,7 +31,7 @@ export declare namespace UsageListResponse {
         /**
          * The action name
          */
-        action: 'asset' | 'asset-privacy' | 'background-removal' | 'captioning' | 'collection' | 'collection-assets' | 'collection-models' | 'controlnet' | 'controlnet-img2img' | 'controlnet-inpaint' | 'controlnet-ip-adapter' | 'controlnet-texture' | 'copy-asset' | 'copy-model' | 'creative-unit-cost' | 'creative-unit-discount' | 'custom' | 'delete-asset' | 'delete-collection' | 'delete-collection-assets' | 'delete-collection-models' | 'delete-inference-image' | 'delete-model' | 'delete-model-preset' | 'delete-oscu-auto-refill' | 'delete-project-member' | 'delete-subscription' | 'delete-team-api-key' | 'delete-team-invitations' | 'delete-team-member' | 'delete-training-images' | 'describe-style' | 'detection' | 'download-assets' | 'download-model' | 'embed' | 'generative-fill' | 'image-prompt-editing' | 'images-generation' | 'img2img' | 'img2img-ip-adapter' | 'img2img-texture' | 'inference' | 'inpaint' | 'inpaint-ip-adapter' | 'model' | 'model-preset' | 'models-training' | 'oscu' | 'patch' | 'pixelate' | 'project' | 'project-member' | 'reframe' | 'repaint' | 'restyle' | 'segmentation' | 'skybox-base-360' | 'skybox-upscale-360' | 'start-train' | 'subscription' | 'subscription-seats' | 'tag-asset' | 'tag-model' | 'team-api-key' | 'team-member' | 'texture' | 'train-succeeded' | 'training-images-to-model' | 'transfer-model' | 'txt2img' | 'txt2img-ip-adapter' | 'update-asset' | 'update-collection' | 'update-model' | 'update-model-description' | 'update-model-examples' | 'update-oscu-auto-refill' | 'update-project' | 'update-subscription' | 'update-team' | 'update-team-member' | 'upscale' | 'vectorization';
+        action: 'asset' | 'asset-privacy' | 'assistant-message' | 'background-removal' | 'byok-remove-project-provider' | 'byok-remove-provider' | 'byok-set-project-provider' | 'byok-set-provider' | 'captioning' | 'collection' | 'collection-assets' | 'collection-models' | 'controlnet' | 'controlnet-img2img' | 'controlnet-inpaint' | 'controlnet-ip-adapter' | 'controlnet-texture' | 'copy-asset' | 'copy-model' | 'creative-unit-cost' | 'creative-unit-discount' | 'custom' | 'custom-asset-created' | 'delete-asset' | 'delete-collection' | 'delete-collection-assets' | 'delete-collection-models' | 'delete-inference-image' | 'delete-model' | 'delete-model-preset' | 'delete-oscu-auto-refill' | 'delete-project-member' | 'delete-subscription' | 'delete-team-api-key' | 'delete-team-invitations' | 'delete-team-member' | 'delete-training-images' | 'describe-style' | 'detection' | 'disable-project-model' | 'disable-team-model' | 'download-assets' | 'download-model' | 'embed' | 'enable-project-model' | 'enable-team-model' | 'generative-fill' | 'image-prompt-editing' | 'images-generation' | 'img2img' | 'img2img-ip-adapter' | 'img2img-texture' | 'inference' | 'inpaint' | 'inpaint-ip-adapter' | 'model' | 'model-preset' | 'models-training' | 'oscu' | 'patch' | 'pixelate' | 'project' | 'project-member' | 'reframe' | 'repaint' | 'restyle' | 'segmentation' | 'skybox-base-360' | 'skybox-upscale-360' | 'start-train' | 'subscription' | 'subscription-seats' | 'tag-asset' | 'tag-model' | 'team-api-key' | 'team-member' | 'texture' | 'train-succeeded' | 'training-images-to-model' | 'transfer-model' | 'txt2img' | 'txt2img-ip-adapter' | 'update-asset' | 'update-collection' | 'update-model' | 'update-model-description' | 'update-model-examples' | 'update-oscu-auto-refill' | 'update-project' | 'update-subscription' | 'update-team' | 'update-team-member' | 'upscale' | 'vectorization';
         /**
          * The additional data of the action
          */
@@ -60,6 +62,11 @@ export declare namespace UsageListResponse {
              * The asset for this action
              */
             assetId?: string;
+            /**
+             * The BYOK provider information for this action Only set if the action is a BYOK
+             * action (byok-set-provider or byok-remove-provider)
+             */
+            byokProvider?: Data.ByokProvider;
             /**
              * The collection for this action
              */
@@ -77,6 +84,39 @@ export declare namespace UsageListResponse {
              */
             modelId?: string;
         }
+        namespace Data {
+            /**
+             * The BYOK provider information for this action Only set if the action is a BYOK
+             * action (byok-set-provider or byok-remove-provider)
+             */
+            interface ByokProvider {
+                id: string;
+                displayName: string;
+            }
+        }
+    }
+    interface AssetUsage {
+        kind: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
+        /**
+         * The data points
+         */
+        points: Array<AssetUsage.Point>;
+    }
+    namespace AssetUsage {
+        interface Point {
+            /**
+             * Number of assets created
+             */
+            count: number;
+            /**
+             * Number of assets created via an API key
+             */
+            countApiKey: number;
+            /**
+             * The UTC ISO date of the point
+             */
+            time: string;
+        }
     }
     /**
      * Consumption entries sorted in descending order by consumption value.
@@ -84,6 +124,14 @@ export declare namespace UsageListResponse {
      * There is no limit on the number of entries
      */
     interface Consumption {
+        /**
+         * The Creative Units discount for the user
+         */
+        discount: number;
+        /**
+         * The total consumption for the user (value + discount)
+         */
+        total: number;
         /**
          * The unique identifier of the user
          */
@@ -121,7 +169,7 @@ export declare namespace UsageListResponse {
             /**
              * The source of the asset
              */
-            source: '3d23d' | '3d23d:texture' | '3d:texture' | '3d:texture:albedo' | '3d:texture:metallic' | '3d:texture:mtl' | '3d:texture:normal' | '3d:texture:roughness' | 'audio2audio' | 'background-removal' | 'canvas' | 'canvas-drawing' | 'canvas-export' | 'detection' | 'generative-fill' | 'image-prompt-editing' | 'img23d' | 'img2img' | 'img2video' | 'inference-control-net' | 'inference-control-net-img' | 'inference-control-net-inpainting' | 'inference-control-net-inpainting-ip-adapter' | 'inference-control-net-ip-adapter' | 'inference-control-net-reference' | 'inference-control-net-texture' | 'inference-img' | 'inference-img-ip-adapter' | 'inference-img-texture' | 'inference-in-paint' | 'inference-in-paint-ip-adapter' | 'inference-reference' | 'inference-reference-texture' | 'inference-txt' | 'inference-txt-ip-adapter' | 'inference-txt-texture' | 'patch' | 'pixelization' | 'reframe' | 'restyle' | 'segment' | 'segmentation-image' | 'segmentation-mask' | 'skybox-3d' | 'skybox-base-360' | 'skybox-hdri' | 'texture' | 'texture:albedo' | 'texture:ao' | 'texture:edge' | 'texture:height' | 'texture:metallic' | 'texture:normal' | 'texture:smoothness' | 'txt23d' | 'txt2audio' | 'txt2img' | 'txt2video' | 'unknown' | 'uploaded' | 'uploaded-3d' | 'uploaded-audio' | 'uploaded-avatar' | 'uploaded-video' | 'upscale' | 'upscale-skybox' | 'upscale-texture' | 'upscale-video' | 'vectorization' | 'video2img' | 'video2video';
+            source: '3d23d' | '3d23d:texture' | '3d:texture' | '3d:texture:albedo' | '3d:texture:metallic' | '3d:texture:mtl' | '3d:texture:normal' | '3d:texture:roughness' | 'audio2audio' | 'background-removal' | 'canvas' | 'canvas-drawing' | 'canvas-export' | 'detection' | 'generative-fill' | 'image-prompt-editing' | 'img23d' | 'img2img' | 'img2video' | 'inference-control-net' | 'inference-control-net-img' | 'inference-control-net-inpainting' | 'inference-control-net-inpainting-ip-adapter' | 'inference-control-net-ip-adapter' | 'inference-control-net-reference' | 'inference-control-net-texture' | 'inference-img' | 'inference-img-ip-adapter' | 'inference-img-texture' | 'inference-in-paint' | 'inference-in-paint-ip-adapter' | 'inference-reference' | 'inference-reference-texture' | 'inference-txt' | 'inference-txt-ip-adapter' | 'inference-txt-texture' | 'patch' | 'pixelization' | 'reframe' | 'restyle' | 'segment' | 'segmentation-image' | 'segmentation-mask' | 'skybox-3d' | 'skybox-base-360' | 'skybox-hdri' | 'texture' | 'texture:albedo' | 'texture:ao' | 'texture:edge' | 'texture:height' | 'texture:metallic' | 'texture:normal' | 'texture:smoothness' | 'txt23d' | 'txt2audio' | 'txt2img' | 'txt2video' | 'unknown' | 'uploaded' | 'uploaded-3d' | 'uploaded-audio' | 'uploaded-avatar' | 'uploaded-video' | 'upscale' | 'upscale-skybox' | 'upscale-texture' | 'upscale-video' | 'vectorization' | 'video23d' | 'video2img' | 'video2video' | 'voice-clone';
         }
         namespace Asset {
             /**
@@ -131,7 +179,7 @@ export declare namespace UsageListResponse {
                 /**
                  * The type of the asset
                  */
-                type: '3d-texture' | '3d-texture-albedo' | '3d-texture-metallic' | '3d-texture-mtl' | '3d-texture-normal' | '3d-texture-roughness' | '3d23d' | '3d23d-texture' | 'audio2audio' | 'background-removal' | 'canvas' | 'canvas-drawing' | 'canvas-export' | 'detection' | 'generative-fill' | 'image-prompt-editing' | 'img23d' | 'img2img' | 'img2video' | 'inference-controlnet' | 'inference-controlnet-img2img' | 'inference-controlnet-inpaint' | 'inference-controlnet-inpaint-ip-adapter' | 'inference-controlnet-ip-adapter' | 'inference-controlnet-reference' | 'inference-controlnet-texture' | 'inference-img2img' | 'inference-img2img-ip-adapter' | 'inference-img2img-texture' | 'inference-inpaint' | 'inference-inpaint-ip-adapter' | 'inference-reference' | 'inference-reference-texture' | 'inference-txt2img' | 'inference-txt2img-ip-adapter' | 'inference-txt2img-texture' | 'patch' | 'pixelization' | 'reframe' | 'restyle' | 'segment' | 'segmentation-image' | 'segmentation-mask' | 'skybox-3d' | 'skybox-base-360' | 'skybox-hdri' | 'texture' | 'texture-albedo' | 'texture-ao' | 'texture-edge' | 'texture-height' | 'texture-metallic' | 'texture-normal' | 'texture-smoothness' | 'txt23d' | 'txt2audio' | 'txt2img' | 'txt2video' | 'unknown' | 'uploaded' | 'uploaded-3d' | 'uploaded-audio' | 'uploaded-avatar' | 'uploaded-video' | 'upscale' | 'upscale-skybox' | 'upscale-texture' | 'upscale-video' | 'vectorization' | 'video2img' | 'video2video';
+                type: '3d-texture' | '3d-texture-albedo' | '3d-texture-metallic' | '3d-texture-mtl' | '3d-texture-normal' | '3d-texture-roughness' | '3d23d' | '3d23d-texture' | 'audio2audio' | 'background-removal' | 'canvas' | 'canvas-drawing' | 'canvas-export' | 'detection' | 'generative-fill' | 'image-prompt-editing' | 'img23d' | 'img2img' | 'img2video' | 'inference-controlnet' | 'inference-controlnet-img2img' | 'inference-controlnet-inpaint' | 'inference-controlnet-inpaint-ip-adapter' | 'inference-controlnet-ip-adapter' | 'inference-controlnet-reference' | 'inference-controlnet-texture' | 'inference-img2img' | 'inference-img2img-ip-adapter' | 'inference-img2img-texture' | 'inference-inpaint' | 'inference-inpaint-ip-adapter' | 'inference-reference' | 'inference-reference-texture' | 'inference-txt2img' | 'inference-txt2img-ip-adapter' | 'inference-txt2img-texture' | 'patch' | 'pixelization' | 'reframe' | 'restyle' | 'segment' | 'segmentation-image' | 'segmentation-mask' | 'skybox-3d' | 'skybox-base-360' | 'skybox-hdri' | 'texture' | 'texture-albedo' | 'texture-ao' | 'texture-edge' | 'texture-height' | 'texture-metallic' | 'texture-normal' | 'texture-smoothness' | 'txt23d' | 'txt2audio' | 'txt2img' | 'txt2video' | 'unknown' | 'uploaded' | 'uploaded-3d' | 'uploaded-audio' | 'uploaded-avatar' | 'uploaded-video' | 'upscale' | 'upscale-skybox' | 'upscale-texture' | 'upscale-video' | 'vectorization' | 'video23d' | 'video2img' | 'video2video' | 'voice-clone';
             }
             /**
              * The properties of the asset
@@ -169,7 +217,7 @@ export declare namespace UsageListResponse {
                 /**
                  * Bounding box dimensions [width, height, depth]
                  */
-                dimensions?: Array<unknown>;
+                dimensions?: Array<number>;
                 /**
                  * Duration of the media in seconds
                  */
@@ -248,7 +296,7 @@ export declare namespace UsageListResponse {
             /**
              * The job type
              */
-            jobType: 'assets-download' | 'canvas-export' | 'caption' | 'caption-llava' | 'custom' | 'describe-style' | 'detection' | 'embed' | 'flux' | 'flux-model-training' | 'generate-prompt' | 'image-generation' | 'image-prompt-editing' | 'inference' | 'mesh-preview-rendering' | 'model-download' | 'model-import' | 'model-training' | 'openai-image-generation' | 'patch-image' | 'pixelate' | 'reframe' | 'remove-background' | 'repaint' | 'restyle' | 'segment' | 'skybox-3d' | 'skybox-base-360' | 'skybox-hdri' | 'skybox-upscale-360' | 'texture' | 'translate' | 'upload' | 'upscale' | 'upscale-skybox' | 'upscale-texture' | 'vectorize' | 'workflow';
+            jobType: 'assets-download' | 'canvas-export' | 'caption' | 'caption-llava' | 'custom' | 'describe-style' | 'detection' | 'embed' | 'flux' | 'flux-model-training' | 'generate-prompt' | 'image-generation' | 'image-prompt-editing' | 'inference' | 'mesh-preview-rendering' | 'model-download' | 'model-import' | 'model-training' | 'musubi-model-training' | 'openai-image-generation' | 'patch-image' | 'pixelate' | 'reframe' | 'remove-background' | 'repaint' | 'restyle' | 'segment' | 'skybox-3d' | 'skybox-base-360' | 'skybox-hdri' | 'skybox-upscale-360' | 'texture' | 'translate' | 'upload' | 'upscale' | 'upscale-skybox' | 'upscale-texture' | 'vectorize' | 'workflow';
             /**
              * The metadata of the job
              */
@@ -267,18 +315,36 @@ export declare namespace UsageListResponse {
                  * List of produced assets for this job
                  */
                 assetIds?: Array<string>;
+                /**
+                 * Eventual error for the job
+                 */
+                error?: string | null;
                 /**
                  * The flow of the job. Only available for workflow jobs.
                  */
                 flow?: Array<Metadata.Flow>;
+                /**
+                 * Actionable hint for the user explaining what went wrong and how to resolve it.
+                 */
+                hint?: string;
                 /**
                  * The inputs for the job
                  */
-                input?: unknown;
+                input?: {
+                    [key: string]: unknown;
+                };
                 /**
-                 * The output of the job
+                 * May contain the output of the job for specific custom models jobs. Only
+                 * available for custom models which generate non-assets outputs. Example: LLM text
+                 * results.
                  */
-                output?: unknown;
+                output?: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * For voice-clone jobs: the ID of the model being trained.
+                 */
+                outputModelId?: string;
                 /**
                  * The workflow ID of the job if job is part of a workflow.
                  */
@@ -301,20 +367,45 @@ export declare namespace UsageListResponse {
                     /**
                      * The type of the job for the node.
                      */
-                    type: 'custom-model' | 'generate-prompt' | 'logic' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
+                    type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
                     /**
                      * List of produced assets for this node.
                      */
                     assets?: Array<Flow.Asset>;
+                    /**
+                     * Fixed number of iterations for a ForEach node. When set, the loop runs exactly
+                     * `count` times regardless of array input. When not set, the loop iterates over
+                     * the resolved array input. Only available for ForEach nodes.
+                     */
+                    count?: number;
                     /**
                      * The nodes that this node depends on. Only available for nodes that have
                      * dependencies. Mainly used for user approval nodes.
                      */
                     dependsOn?: Array<string>;
+                    /**
+                     * If true, the outputs of this node will be included in the workflow job's final
+                     * output. Only applicable to producing nodes (custom-model, inference, etc.). By
+                     * default, only last nodes (nodes not referenced by other nodes) contribute to
+                     * outputs. Set this to true to also include intermediate nodes in the final
+                     * output. Note: This should only be set to `true` or left undefined.
+                     */
+                    includeOutputsInWorkflowJob?: true;
                     /**
                      * The inputs of the node.
                      */
                     inputs?: Array<Flow.Input>;
+                    /**
+                     * Statically-configured items for a List node. The node outputs this array as-is
+                     * when executed. Only available for List nodes. The values can be strings,
+                     * numbers, or asset IDs.
+                     */
+                    items?: Array<string>;
+                    /**
+                     * Zero-based index of the iteration this node copy belongs to. Set on
+                     * dynamically-created copies of loop body nodes.
+                     */
+                    iterationIndex?: number;
                     /**
                      * If the flow is part of a WorkflowJob, this is the jobId for the node. jobId is
                      * only available for nodes started. A node "Pending" for a running workflow job is
@@ -329,10 +420,25 @@ export declare namespace UsageListResponse {
                      * The type of the logic for the node. Only available for logic nodes.
                      */
                     logicType?: 'if-else';
+                    /**
+                     * IDs of the body template nodes that belong to this ForEach loop. At runtime
+                     * these templates are cloned once per iteration and marked Skipped. Only available
+                     * for ForEach nodes.
+                     */
+                    loopBodyNodeIds?: Array<string>;
+                    /**
+                     * ID of the ForEach node that spawned this iteration copy. Set on
+                     * dynamically-created copies of loop body nodes.
+                     */
+                    loopNodeId?: string;
                     /**
                      * The model id for the node. Mainly used for custom model tasks.
                      */
                     modelId?: string;
+                    /**
+                     * The output of the node. Only available for logic nodes.
+                     */
+                    output?: unknown;
                     /**
                      * The workflow id for the node. Mainly used for workflow tasks.
                      */
@@ -374,6 +480,10 @@ export declare namespace UsageListResponse {
                          * Whether this input affects the model's cost calculation
                          */
                         costImpact?: boolean;
+                        /**
+                         * The default value for the input
+                         */
+                        default?: unknown;
                         /**
                          * Help text displayed in the UI to provide additional information about the input
                          */
@@ -392,10 +502,20 @@ export declare namespace UsageListResponse {
                          * the same as the current object. This is only available for type inputs_array
                          * inputs.
                          */
-                        inputs?: Array<unknown>;
+                        inputs?: Array<{
+                            [key: string]: unknown;
+                        }>;
+                        /**
+                         * The configured items for inputs_array type inputs. Each item is an array of
+                         * SubNodeInput that need ref/value resolution. Only available for inputs_array
+                         * type.
+                         */
+                        items?: Array<Array<Input.Item>>;
                         /**
                          * The asset kind of the input. Only taken into account for \`file\` and
-                         * \`file_array\` input types.
+                         * \`file_array\` input types. If model provides multiple kinds, the input will be
+                         * not able to create the asset on the flight on API side with dataurl without
+                         * data:kind, prefix
                          */
                         kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
                         /**
@@ -416,6 +536,12 @@ export declare namespace UsageListResponse {
                          * \`string_array\`.
                          */
                         maxLength?: number;
+                        /**
+                         * The maximum allowed file size in bytes. Only applies to \`file\` and
+                         * \`file_array\` input types. Validated against \`asset.properties.size\` at job
+                         * creation time.
+                         */
+                        maxSize?: number;
                         /**
                          * The minimum allowed value. Only available for \`number\` and array input types.
                          */
@@ -429,7 +555,7 @@ export declare namespace UsageListResponse {
                          * The allowed model types for this input. Example: \`["flux.1-lora"]\`. Only
                          * available for \`model_array\` input type.
                          */
-                        modelTypes?: Array<'custom' | 'flux.1' | 'flux.1-composition' | 'flux.1-kontext-dev' | 'flux.1-kontext-lora' | 'flux.1-krea-dev' | 'flux.1-krea-lora' | 'flux.1-lora' | 'flux.1-pro' | 'flux.1.1-pro-ultra' | 'flux1.1-pro' | 'gpt-image-1' | 'sd-1_5' | 'sd-1_5-composition' | 'sd-1_5-lora' | 'sd-xl' | 'sd-xl-composition' | 'sd-xl-lora'>;
+                        modelTypes?: Array<'custom' | 'elevenlabs-voice' | 'flux.1' | 'flux.1-composition' | 'flux.1-kontext-dev' | 'flux.1-kontext-lora' | 'flux.1-krea-dev' | 'flux.1-krea-lora' | 'flux.1-lora' | 'flux.1-pro' | 'flux.1.1-pro-ultra' | 'flux.2-dev-edit-lora' | 'flux.2-dev-lora' | 'flux.2-klein-4b-edit-lora' | 'flux.2-klein-4b-lora' | 'flux.2-klein-9b-edit-lora' | 'flux.2-klein-9b-lora' | 'flux.2-klein-base-4b-edit-lora' | 'flux.2-klein-base-4b-lora' | 'flux.2-klein-base-9b-edit-lora' | 'flux.2-klein-base-9b-lora' | 'flux1.1-pro' | 'gpt-image-1' | 'qwen-image-2512-lora' | 'qwen-image-edit-2509-lora' | 'qwen-image-edit-2511-lora' | 'qwen-image-edit-lora' | 'qwen-image-lora' | 'sd-1_5' | 'sd-1_5-composition' | 'sd-1_5-lora' | 'sd-xl' | 'sd-xl-composition' | 'sd-xl-lora' | 'zimage-de-turbo-lora' | 'zimage-lora' | 'zimage-turbo-lora'>;
                         /**
                          * Whether this input represents a parent asset to assign to the produced assets.
                          * Only available for \`file\` and \`file_array\` input types.
@@ -473,8 +599,232 @@ export declare namespace UsageListResponse {
                          * The step increment for numeric inputs. Only available for \`number\` input type.
                          */
                         step?: number;
+                        /**
+                         * The value of the input. This is the value of the input that will be used to run
+                         * the node. Only available for flows managed by a WorkflowJob.
+                         */
+                        value?: unknown;
                     }
                     namespace Input {
+                        /**
+                         * A sub-input within an inputs_array item. Same as NodeInput but without the
+                         * recursive items field.
+                         */
+                        interface Item {
+                            /**
+                             * The name that must be user to call the model through the API
+                             */
+                            name: string;
+                            /**
+                             * The data type of the input
+                             */
+                            type: 'boolean' | 'file' | 'file_array' | 'inputs_array' | 'model' | 'model_array' | 'number' | 'number_array' | 'string' | 'string_array';
+                            /**
+                             * The allowed values for the input. For \`string\` or \`number\` types, creates a
+                             * single-select dropdown. For \`string_array\` type, creates a multi-select
+                             * dropdown.
+                             */
+                            allowedValues?: Array<unknown>;
+                            /**
+                             * Specifies the background behavior for the input. Only available for \`file\` and
+                             * \`file_array\` input types with kind \`image\`.
+                             */
+                            backgroundBehavior?: 'opaque' | 'transparent';
+                            /**
+                             * Whether the input is a color or not. Only available for \`string\` input type.
+                             */
+                            color?: boolean;
+                            /**
+                             * Whether this input affects the model's cost calculation
+                             */
+                            costImpact?: boolean;
+                            /**
+                             * The default value for the input
+                             */
+                            default?: unknown;
+                            /**
+                             * Help text displayed in the UI to provide additional information about the input
+                             */
+                            description?: string;
+                            /**
+                             * Used to visually group inputs together in the UI. Inputs with the same group
+                             * value appear consecutively in the UI.
+                             */
+                            group?: string;
+                            /**
+                             * Hint text displayed in the UI as a tooltip to guide the user
+                             */
+                            hint?: string;
+                            /**
+                             * The list of inputs which form an object within a container array. All inputs are
+                             * the same as the current object. This is only available for type inputs_array
+                             * inputs.
+                             */
+                            inputs?: Array<{
+                                [key: string]: unknown;
+                            }>;
+                            /**
+                             * The asset kind of the input. Only taken into account for \`file\` and
+                             * \`file_array\` input types. If model provides multiple kinds, the input will be
+                             * not able to create the asset on the flight on API side with dataurl without
+                             * data:kind, prefix
+                             */
+                            kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
+                            /**
+                             * The label displayed in the UI for this input
+                             */
+                            label?: string;
+                            /**
+                             * The name of the file input field to use as the mask source
+                             */
+                            maskFrom?: string;
+                            /**
+                             * The maximum allowed value. Only available for \`number\` and \`array\` input
+                             * types.
+                             */
+                            max?: number;
+                            /**
+                             * The maximum allowed length for \`string\` inputs. Also applies to each item in
+                             * \`string_array\`.
+                             */
+                            maxLength?: number;
+                            /**
+                             * The maximum allowed file size in bytes. Only applies to \`file\` and
+                             * \`file_array\` input types. Validated against \`asset.properties.size\` at job
+                             * creation time.
+                             */
+                            maxSize?: number;
+                            /**
+                             * The minimum allowed value. Only available for \`number\` and array input types.
+                             */
+                            min?: number;
+                            /**
+                             * The minimum allowed length for string inputs. Also applies to each item in
+                             * \`string_array\`.
+                             */
+                            minLength?: number;
+                            /**
+                             * The allowed model types for this input. Example: \`["flux.1-lora"]\`. Only
+                             * available for \`model_array\` input type.
+                             */
+                            modelTypes?: Array<'custom' | 'elevenlabs-voice' | 'flux.1' | 'flux.1-composition' | 'flux.1-kontext-dev' | 'flux.1-kontext-lora' | 'flux.1-krea-dev' | 'flux.1-krea-lora' | 'flux.1-lora' | 'flux.1-pro' | 'flux.1.1-pro-ultra' | 'flux.2-dev-edit-lora' | 'flux.2-dev-lora' | 'flux.2-klein-4b-edit-lora' | 'flux.2-klein-4b-lora' | 'flux.2-klein-9b-edit-lora' | 'flux.2-klein-9b-lora' | 'flux.2-klein-base-4b-edit-lora' | 'flux.2-klein-base-4b-lora' | 'flux.2-klein-base-9b-edit-lora' | 'flux.2-klein-base-9b-lora' | 'flux1.1-pro' | 'gpt-image-1' | 'qwen-image-2512-lora' | 'qwen-image-edit-2509-lora' | 'qwen-image-edit-2511-lora' | 'qwen-image-edit-lora' | 'qwen-image-lora' | 'sd-1_5' | 'sd-1_5-composition' | 'sd-1_5-lora' | 'sd-xl' | 'sd-xl-composition' | 'sd-xl-lora' | 'zimage-de-turbo-lora' | 'zimage-lora' | 'zimage-turbo-lora'>;
+                            /**
+                             * Whether this input represents a parent asset to assign to the produced assets.
+                             * Only available for \`file\` and \`file_array\` input types.
+                             *
+                             * For \`file_array\`, the parent asset is the first item in the array.
+                             */
+                            parent?: boolean;
+                            /**
+                             * Placeholder text for the input. Only available for 'string' input type.
+                             */
+                            placeholder?: string;
+                            /**
+                             * Whether the input is a prompt. When true, displays as a text area with prompt
+                             * spark feature. Only available for \`string\` input type.
+                             */
+                            prompt?: boolean;
+                            /**
+                             * Whether the input is used with prompt spark. Only available for \`string\` input
+                             * type.
+                             */
+                            promptSpark?: boolean;
+                            /**
+                             * The reference to another input or output of the same workflow. Must have at
+                             * least one of node or conditional.
+                             */
+                            ref?: Item.Ref;
+                            /**
+                             * Set of rules that describes when this input is required:
+                             *
+                             * - \`always\`: Input is always required
+                             * - \`ifNotDefined\`: Input is required when another specified input is not
+                             *   defined
+                             * - \`ifDefined\`: Input is required when another specified input is defined
+                             * - \`conditionalValues\`: Input is required when another input has a specific
+                             *   value
+                             *
+                             * By default, the input is not required.
+                             */
+                            required?: Item.Required;
+                            /**
+                             * The step increment for numeric inputs. Only available for \`number\` input type.
+                             */
+                            step?: number;
+                            /**
+                             * The value of the input. This is the value of the input that will be used to run
+                             * the node. Only available for flows managed by a WorkflowJob.
+                             */
+                            value?: unknown;
+                        }
+                        namespace Item {
+                            /**
+                             * The reference to another input or output of the same workflow. Must have at
+                             * least one of node or conditional.
+                             */
+                            interface Ref {
+                                /**
+                                 * The conditional nodes to reference. If the conditional nodes are successful, the
+                                 * node will be successful. If the conditional nodes are skipped, the node will be
+                                 * skipped. Contains an array of node ids used to check the status of the nodes.
+                                 */
+                                conditional?: Array<string>;
+                                /**
+                                 * This is the desired node output value if ref is an if/else node.
+                                 */
+                                equal?: string;
+                                /**
+                                 * The name of the input or output to reference. If the type is 'workflow', the
+                                 * name is the name of the input of the workflow is required If the type is 'node',
+                                 * the name is not mandatory, except if you want all outputs of the node. To get
+                                 * all outputs of a node, you can use the name 'all'.
+                                 */
+                                name?: string;
+                                /**
+                                 * The node id or 'workflow' if the source is a workflow input.
+                                 */
+                                node?: string;
+                            }
+                            /**
+                             * Set of rules that describes when this input is required:
+                             *
+                             * - \`always\`: Input is always required
+                             * - \`ifNotDefined\`: Input is required when another specified input is not
+                             *   defined
+                             * - \`ifDefined\`: Input is required when another specified input is defined
+                             * - \`conditionalValues\`: Input is required when another input has a specific
+                             *   value
+                             *
+                             * By default, the input is not required.
+                             */
+                            interface Required {
+                                /**
+                                 * Whether the input is always required
+                                 */
+                                always?: boolean;
+                                /**
+                                 * Makes this input required when another input has a specific value:
+                                 *
+                                 * - Key: name of the input to check
+                                 * - Value: operation and allowed values that trigger the requirement
+                                 */
+                                conditionalValues?: unknown;
+                                /**
+                                 * Makes this input required when another input is defined:
+                                 *
+                                 * - Key: name of the input that must be defined
+                                 * - Value: message to display when this input is required
+                                 */
+                                ifDefined?: unknown;
+                                /**
+                                 * Makes this input required when another input is not defined:
+                                 *
+                                 * - Key: name of the input that must be undefined
+                                 * - Value: message to display when this input is required
+                                 */
+                                ifNotDefined?: unknown;
+                            }
+                        }
                         /**
                          * The reference to another input or output of the same workflow. Must have at
                          * least one of node or conditional.
@@ -666,6 +1016,14 @@ export declare namespace UsageListResponse {
     }
     namespace ModelUsage {
         interface Point {
+            /**
+             * Cost for model usage for API key only
+             */
+            apiKeyCost: number;
+            /**
+             * The discount for model usage for API key only
+             */
+            apiKeyDiscount: number;
             /**
              * Cost for model usage
              */
@@ -684,6 +1042,29 @@ export declare namespace UsageListResponse {
             time: string;
         }
     }
+    interface NsfwUsage {
+        label: string;
+        /**
+         * The data points
+         */
+        points: Array<NsfwUsage.Point>;
+    }
+    namespace NsfwUsage {
+        interface Point {
+            /**
+             * Number of NSFW assets created
+             */
+            count: number;
+            /**
+             * Number of NSFW assets created via an API key
+             */
+            countApiKey: number;
+            /**
+             * The UTC ISO date of the point
+             */
+            time: string;
+        }
+    }
     interface Usage {
         /**
          * Granularity for points (example: "1d", "1h", "1m", "15m")
@@ -697,10 +1078,14 @@ export declare namespace UsageListResponse {
          * Name of the usage points (example: "images-generation", "generators-training",
          * "background-removal", "upscale", ...)
          */
-        usageName: 'background-removal' | 'captioning' | 'creative-unit-cost' | 'creative-unit-discount' | 'custom' | 'detection' | 'image-prompt-editing' | 'images-generation' | 'models-training' | 'patch' | 'pixelate' | 'repaint' | 'restyle' | 'segmentation' | 'skybox-base-360' | 'skybox-upscale-360' | 'texture' | 'upscale' | 'vectorization';
+        usageName: 'background-removal' | 'captioning' | 'creative-unit-cost' | 'creative-unit-discount' | 'custom' | 'custom-asset-created' | 'detection' | 'image-prompt-editing' | 'images-generation' | 'models-training' | 'patch' | 'pixelate' | 'repaint' | 'restyle' | 'segmentation' | 'skybox-base-360' | 'skybox-upscale-360' | 'texture' | 'upscale' | 'vectorization';
     }
     namespace Usage {
         interface Point {
+            /**
+             * Value of the point for API key only
+             */
+            apiKey: string;
             /**
              * The UTC ISO date of the point
              */
@@ -717,7 +1102,7 @@ export interface UsageListParams {
      * The offset for the activity data. Default is 0. If bad offset or empty, 0 will
      * be returned. Must be a positive integer.
      */
-    activityOffset?: string;
+    activityOffset?: number;
     /**
      * The end date of the usage in ISO 8601 format. If not provided, use default
      * timeRange. If provided, startDate is required.
@@ -737,12 +1122,12 @@ export interface UsageListParams {
      * The time range of the usage. If not provided, use default timeRange. If
      * startDate and endDate provided, timeRange is ignored.
      */
-    timeRange?: string;
+    timeRange?: 'last-hour' | 'last-day' | 'last-three-days' | 'last-seven-days' | 'last-thirty-one-days';
     /**
      * The type of the usage data. Can be one or more comma separated values. Default
      * is all types. If bad type or empty, all types will be returned.
      */
-    type?: string;
+    type?: 'usages' | 'activity' | 'consumption' | 'model-usages' | 'asset-usages' | 'nsfw-usages';
     /**
      * The unique identifier of the user for the usage. If not provided, returns all
      * usages for the team.