@scenario-labs/sdk 0.1.3 → 0.2.0

package/src/resources/models/train.ts

@@ -11,10 +11,15 @@ export class Train extends APIResource {
    */
   action(
     modelID: string,
-    body: TrainActionParams,
+    params: TrainActionParams,
     options?: RequestOptions,
   ): APIPromise<TrainActionResponse> {
-    return this._client.post(path`/models/${modelID}/train/action`, { body, ...options });
+    const { originalAssets, ...body } = params;
+    return this._client.post(path`/models/${modelID}/train/action`, {
+      query: { originalAssets },
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -25,9 +30,9 @@ export class Train extends APIResource {
     params: TrainTriggerParams,
     options?: RequestOptions,
   ): APIPromise<TrainTriggerResponse> {
-    const { dryRun, originalAssets, ...body } = params;
+    const { dryRun, originalAssets, trainingImagesCount, ...body } = params;
     return this._client.put(path`/models/${modelID}/train`, {
-      query: { dryRun, originalAssets },
+      query: { dryRun, originalAssets, trainingImagesCount },
       body,
       ...options,
     });
@@ -77,6 +82,7 @@ export namespace TrainActionResponse {
       | 'txt2img_texture'
       | 'txt2txt'
       | 'txt2video'
+      | 'video23d'
       | 'video2img'
       | 'video2video'
     >;
@@ -132,6 +138,7 @@ export namespace TrainActionResponse {
      */
     type:
       | 'custom'
+      | 'elevenlabs-voice'
       | 'flux.1'
       | 'flux.1-composition'
       | 'flux.1-kontext-dev'
@@ -141,14 +148,32 @@ export namespace TrainActionResponse {
       | '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';
+      | 'sd-xl-lora'
+      | 'zimage-de-turbo-lora'
+      | 'zimage-lora'
+      | 'zimage-turbo-lora';
 
     /**
      * The model last update date as an ISO string (example:
@@ -160,7 +185,7 @@ export namespace TrainActionResponse {
      * The access restrictions of the model 0: Free plan 25: Creator plan 50: Pro plan
      * 75: Team plan 100: Enterprise plan
      */
-    accessRestrictions?: number;
+    accessRestrictions?: 0 | 100 | 25 | 50 | 75;
 
     /**
      * The author user ID (example: "user_VFhihHKMRZyDDnZAJwLb2Q")
@@ -172,11 +197,6 @@ export namespace TrainActionResponse {
      */
     class?: Model.Class;
 
-    /**
-     * Compliance and regulatory metadata for the model
-     */
-    complianceMetadata?: Model.ComplianceMetadata;
-
     /**
      * List of base model IDs compliant with the model (example: ["flux.1-dev",
      * "flux.1-schnell"]) This attribute is mainly used for Flux LoRA models
@@ -236,6 +256,11 @@ export namespace TrainActionResponse {
      */
     parentModelId?: string;
 
+    /**
+     * Aggregated performance stats
+     */
+    performanceStats?: Model.PerformanceStats;
+
     /**
      * Fine-tune the model's inferences with prompt embedding
      */
@@ -336,36 +361,6 @@ export namespace TrainActionResponse {
       thumbnails: Array<string>;
     }
 
-    /**
-     * Compliance and regulatory metadata for the model
-     */
-    export interface ComplianceMetadata {
-      /**
-       * Data processing comment (e.g., zeroRetention, temporaryRetention, etc.)
-       */
-      dataProcessingComment?: 'researchOnly' | 'serviceImprovement' | 'temporaryRetention' | 'zeroRetention';
-
-      /**
-       * URL to license terms
-       */
-      licenseTerms?: string;
-
-      /**
-       * The maintainer of the model
-       */
-      maintainer?: 'Fal' | 'Provider' | 'Replicate' | 'Scenario';
-
-      /**
-       * The provider of the model (examples: 'Google', 'AWS', 'BFL', 'Meshy', etc.)
-       */
-      modelProvider?: string;
-
-      /**
-       * The sub-processor used for the model
-       */
-      subProcessor?: 'AWS' | 'Fal' | 'Modal' | 'Provider' | 'Replicate';
-    }
-
     export interface Concept {
       /**
        * The model ID (example: "model_eyVcnFJcR92BxBkz7N6g5w")
@@ -462,6 +457,11 @@ export namespace TrainActionResponse {
        */
       costImpact?: boolean;
 
+      /**
+       * The default value for the input
+       */
+      default?: unknown;
+
       /**
        * Help text displayed in the UI to provide additional information about the input
        */
@@ -483,11 +483,13 @@ export namespace TrainActionResponse {
        * the same as the current object. This is only available for type inputs_array
        * inputs.
        */
-      inputs?: Array<unknown>;
+      inputs?: Array<{ [key: string]: unknown }>;
 
       /**
        * 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';
 
@@ -513,6 +515,13 @@ export namespace TrainActionResponse {
        */
       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.
        */
@@ -530,6 +539,7 @@ export namespace TrainActionResponse {
        */
       modelTypes?: Array<
         | 'custom'
+        | 'elevenlabs-voice'
         | 'flux.1'
         | 'flux.1-composition'
         | 'flux.1-kontext-dev'
@@ -539,14 +549,32 @@ export namespace TrainActionResponse {
         | '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'
       >;
 
       /**
@@ -643,6 +671,13 @@ export namespace TrainActionResponse {
      * The parameters of the model
      */
     export interface Parameters {
+      /**
+       * Age group of the voice (for professional cloning)
+       *
+       * Only available for ElevenLabs voice training
+       */
+      age?: string;
+
       /**
        * The batch size Less steps, and will increase the learning rate
        *
@@ -657,6 +692,14 @@ export namespace TrainActionResponse {
        */
       classPrompt?: string;
 
+      /**
+       * Type of voice cloning: "instant" (fast) or "professional" (higher quality,
+       * requires captcha)
+       *
+       * Only available for ElevenLabs voice training
+       */
+      cloneType?: string;
+
       /**
        * The prompt with identifier specifying the instance (or subject) of the class
        * (example: "a daiton dog")
@@ -669,6 +712,20 @@ export namespace TrainActionResponse {
        */
       conceptPrompt?: string;
 
+      /**
+       * Gender of the voice (for professional cloning)
+       *
+       * Only available for ElevenLabs voice training
+       */
+      gender?: string;
+
+      /**
+       * Language of the audio samples (ISO 639-1 code)
+       *
+       * Only available for ElevenLabs voice training
+       */
+      language?: string;
+
       /**
        * Initial learning rate (after the potential warmup period)
        *
@@ -803,15 +860,27 @@ export namespace TrainActionResponse {
       /**
        * The dimension of the LoRA update matrices
        *
-       * Only available for SDXL and Flux LoRA training
+       * Only available for SDXL (deprecated), Flux LoRA and Musubi training
        *
        * Default value varies depending on the model type:
        *
-       * - For SDXL: 64
+       * - For SDXL (deprecated): 64
        * - For Flux: 16
+       * - For Musubi: 64
+       *
+       * Each trainer enforces its own tighter limit (Flux LoRA: [2; 64], Musubi: [2;
+       * 128])
        */
       rank?: number;
 
+      /**
+       * Whether to remove background noise from audio samples before cloning. When
+       * enabled, each sample must be at least 5 seconds long.
+       *
+       * Only available for ElevenLabs voice training
+       */
+      removeBackgroundNoise?: boolean;
+
       /**
        * The prompts to use for each epoch Only available for Flux LoRA training
        */
@@ -865,12 +934,148 @@ export namespace TrainActionResponse {
        */
       validationPrompt?: string;
 
+      /**
+       * Description of the voice characteristics
+       *
+       * Only available for ElevenLabs voice training
+       */
+      voiceDescription?: string;
+
       /**
        * The Weights And Bias key to use for logging. The maximum length is 40 characters
        */
       wandbKey?: string;
     }
 
+    /**
+     * Aggregated performance stats
+     */
+    export interface PerformanceStats {
+      /**
+       * Performance metrics per variant
+       */
+      variants: Array<PerformanceStats.Variant>;
+
+      /**
+       * Default variant key for quick model comparison
+       */
+      default?: string;
+    }
+
+    export namespace PerformanceStats {
+      /**
+       * Performance stats for a model variant
+       */
+      export interface Variant {
+        /**
+         * The generation capability (example: "txt2img", "img2video", "txt2audio")
+         */
+        capability: string;
+
+        /**
+         * When these stats were last computed (ISO date)
+         */
+        computedAt: string;
+
+        /**
+         * Maximum cost per output asset (CU)
+         */
+        costPerAssetMaxCU: number;
+
+        /**
+         * Minimum cost per output asset (CU)
+         */
+        costPerAssetMinCU: number;
+
+        /**
+         * Median cost per output asset (CU)
+         */
+        costPerAssetP50CU: number;
+
+        /**
+         * Inference latency P50 per output asset (seconds)
+         */
+        inferenceLatencyP50Sec: number;
+
+        /**
+         * Inference latency P75 per output asset (seconds)
+         */
+        inferenceLatencyP75Sec: number;
+
+        /**
+         * Total latency P50 per output asset, including queue time (seconds)
+         */
+        totalLatencyP50Sec: number;
+
+        /**
+         * Total latency P75 per output asset, including queue time (seconds)
+         */
+        totalLatencyP75Sec: number;
+
+        /**
+         * Unique variant identifier (example: "txt2img:1K", "img2video:2K", "txt2audio")
+         */
+        variantKey: string;
+
+        /**
+         * External quality score from arena.ai leaderboard
+         */
+        arenaScore?: Variant.ArenaScore;
+
+        /**
+         * The resolution bucket (example: "0.5K", "1K", "2K", "4K")
+         */
+        resolution?: string;
+      }
+
+      export namespace Variant {
+        /**
+         * External quality score from arena.ai leaderboard
+         */
+        export interface ArenaScore {
+          /**
+           * Arena category (example: "text_to_image", "image_to_video")
+           */
+          arenaCategory: string;
+
+          /**
+           * Model name on arena.ai
+           */
+          arenaModelName: string;
+
+          /**
+           * When this score was last fetched (ISO date)
+           */
+          fetchedAt: string;
+
+          /**
+           * Rank in the arena category
+           */
+          rank: number;
+
+          /**
+           * ELO rating
+           */
+          rating: number;
+
+          /**
+           * ELO rating confidence interval lower bound
+           */
+          ratingLower: number;
+
+          /**
+           * ELO rating confidence interval upper bound
+           */
+          ratingUpper: number;
+
+          /**
+           * Number of human votes
+           */
+          votes: number;
+        }
+      }
+    }
+
     /**
      * A thumbnail for your model
      */
@@ -944,7 +1149,7 @@ export namespace TrainActionResponse {
       /**
        * The stage of the request
        */
-      stage: 'pending' | 'queued-for-train' | 'running-train' | 'starting-train';
+      stage: 'pending' | 'pending-captcha' | 'queued-for-train' | 'running-train' | 'starting-train';
 
       /**
        * Timestamp in milliseconds of the last time the training progress was updated
@@ -1180,6 +1385,7 @@ export namespace TrainTriggerResponse {
       | 'model-download'
       | 'model-import'
       | 'model-training'
+      | 'musubi-model-training'
       | 'openai-image-generation'
       | 'patch-image'
       | 'pixelate'
@@ -1261,20 +1467,37 @@ export namespace TrainTriggerResponse {
        */
       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.
@@ -1304,8 +1527,11 @@ export namespace TrainTriggerResponse {
          */
         type:
           | 'custom-model'
+          | 'for-each'
           | 'generate-prompt'
+          | 'list'
           | 'logic'
+          | 'model'
           | 'remove-background'
           | 'transform'
           | 'user-approval'
@@ -1316,17 +1542,46 @@ export namespace TrainTriggerResponse {
          */
         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
@@ -1344,11 +1599,29 @@ export namespace TrainTriggerResponse {
          */
         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.
          */
@@ -1409,6 +1682,11 @@ export namespace TrainTriggerResponse {
            */
           costImpact?: boolean;
 
+          /**
+           * The default value for the input
+           */
+          default?: unknown;
+
           /**
            * Help text displayed in the UI to provide additional information about the input
            */
@@ -1430,11 +1708,20 @@ export namespace TrainTriggerResponse {
            * 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';
 
@@ -1460,6 +1747,13 @@ export namespace TrainTriggerResponse {
            */
           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.
            */
@@ -1477,6 +1771,7 @@ export namespace TrainTriggerResponse {
            */
           modelTypes?: Array<
             | 'custom'
+            | 'elevenlabs-voice'
             | 'flux.1'
             | 'flux.1-composition'
             | 'flux.1-kontext-dev'
@@ -1486,14 +1781,32 @@ export namespace TrainTriggerResponse {
             | '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'
           >;
 
           /**
@@ -1545,9 +1858,316 @@ export namespace TrainTriggerResponse {
            * 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;
         }
 
         export namespace Input {
+          /**
+           * A sub-input within an inputs_array item. Same as NodeInput but without the
+           * recursive items field.
+           */
+          export 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;
+          }
+
+          export namespace Item {
+            /**
+             * The reference to another input or output of the same workflow. Must have at
+             * least one of node or conditional.
+             */
+            export 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.
+             */
+            export 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.
@@ -1716,6 +2336,7 @@ export namespace TrainTriggerResponse {
       | 'txt2img_texture'
       | 'txt2txt'
       | 'txt2video'
+      | 'video23d'
       | 'video2img'
       | 'video2video'
     >;
@@ -1771,6 +2392,7 @@ export namespace TrainTriggerResponse {
      */
     type:
       | 'custom'
+      | 'elevenlabs-voice'
       | 'flux.1'
       | 'flux.1-composition'
       | 'flux.1-kontext-dev'
@@ -1780,14 +2402,32 @@ export namespace TrainTriggerResponse {
       | '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';
+      | 'sd-xl-lora'
+      | 'zimage-de-turbo-lora'
+      | 'zimage-lora'
+      | 'zimage-turbo-lora';
 
     /**
      * The model last update date as an ISO string (example:
@@ -1799,7 +2439,7 @@ export namespace TrainTriggerResponse {
      * The access restrictions of the model 0: Free plan 25: Creator plan 50: Pro plan
      * 75: Team plan 100: Enterprise plan
      */
-    accessRestrictions?: number;
+    accessRestrictions?: 0 | 100 | 25 | 50 | 75;
 
     /**
      * The author user ID (example: "user_VFhihHKMRZyDDnZAJwLb2Q")
@@ -1811,11 +2451,6 @@ export namespace TrainTriggerResponse {
      */
     class?: Model.Class;
 
-    /**
-     * Compliance and regulatory metadata for the model
-     */
-    complianceMetadata?: Model.ComplianceMetadata;
-
     /**
      * List of base model IDs compliant with the model (example: ["flux.1-dev",
      * "flux.1-schnell"]) This attribute is mainly used for Flux LoRA models
@@ -1875,6 +2510,11 @@ export namespace TrainTriggerResponse {
      */
     parentModelId?: string;
 
+    /**
+     * Aggregated performance stats
+     */
+    performanceStats?: Model.PerformanceStats;
+
     /**
      * Fine-tune the model's inferences with prompt embedding
      */
@@ -1975,36 +2615,6 @@ export namespace TrainTriggerResponse {
       thumbnails: Array<string>;
     }
 
-    /**
-     * Compliance and regulatory metadata for the model
-     */
-    export interface ComplianceMetadata {
-      /**
-       * Data processing comment (e.g., zeroRetention, temporaryRetention, etc.)
-       */
-      dataProcessingComment?: 'researchOnly' | 'serviceImprovement' | 'temporaryRetention' | 'zeroRetention';
-
-      /**
-       * URL to license terms
-       */
-      licenseTerms?: string;
-
-      /**
-       * The maintainer of the model
-       */
-      maintainer?: 'Fal' | 'Provider' | 'Replicate' | 'Scenario';
-
-      /**
-       * The provider of the model (examples: 'Google', 'AWS', 'BFL', 'Meshy', etc.)
-       */
-      modelProvider?: string;
-
-      /**
-       * The sub-processor used for the model
-       */
-      subProcessor?: 'AWS' | 'Fal' | 'Modal' | 'Provider' | 'Replicate';
-    }
-
     export interface Concept {
       /**
        * The model ID (example: "model_eyVcnFJcR92BxBkz7N6g5w")
@@ -2101,6 +2711,11 @@ export namespace TrainTriggerResponse {
        */
       costImpact?: boolean;
 
+      /**
+       * The default value for the input
+       */
+      default?: unknown;
+
       /**
        * Help text displayed in the UI to provide additional information about the input
        */
@@ -2122,11 +2737,13 @@ export namespace TrainTriggerResponse {
        * the same as the current object. This is only available for type inputs_array
        * inputs.
        */
-      inputs?: Array<unknown>;
+      inputs?: Array<{ [key: string]: unknown }>;
 
       /**
        * 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';
 
@@ -2152,6 +2769,13 @@ export namespace TrainTriggerResponse {
        */
       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.
        */
@@ -2169,6 +2793,7 @@ export namespace TrainTriggerResponse {
        */
       modelTypes?: Array<
         | 'custom'
+        | 'elevenlabs-voice'
         | 'flux.1'
         | 'flux.1-composition'
         | 'flux.1-kontext-dev'
@@ -2178,14 +2803,32 @@ export namespace TrainTriggerResponse {
         | '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'
       >;
 
       /**
@@ -2282,6 +2925,13 @@ export namespace TrainTriggerResponse {
      * The parameters of the model
      */
     export interface Parameters {
+      /**
+       * Age group of the voice (for professional cloning)
+       *
+       * Only available for ElevenLabs voice training
+       */
+      age?: string;
+
       /**
        * The batch size Less steps, and will increase the learning rate
        *
@@ -2296,6 +2946,14 @@ export namespace TrainTriggerResponse {
        */
       classPrompt?: string;
 
+      /**
+       * Type of voice cloning: "instant" (fast) or "professional" (higher quality,
+       * requires captcha)
+       *
+       * Only available for ElevenLabs voice training
+       */
+      cloneType?: string;
+
       /**
        * The prompt with identifier specifying the instance (or subject) of the class
        * (example: "a daiton dog")
@@ -2308,6 +2966,20 @@ export namespace TrainTriggerResponse {
        */
       conceptPrompt?: string;
 
+      /**
+       * Gender of the voice (for professional cloning)
+       *
+       * Only available for ElevenLabs voice training
+       */
+      gender?: string;
+
+      /**
+       * Language of the audio samples (ISO 639-1 code)
+       *
+       * Only available for ElevenLabs voice training
+       */
+      language?: string;
+
       /**
        * Initial learning rate (after the potential warmup period)
        *
@@ -2442,15 +3114,27 @@ export namespace TrainTriggerResponse {
       /**
        * The dimension of the LoRA update matrices
        *
-       * Only available for SDXL and Flux LoRA training
+       * Only available for SDXL (deprecated), Flux LoRA and Musubi training
        *
        * Default value varies depending on the model type:
        *
-       * - For SDXL: 64
+       * - For SDXL (deprecated): 64
        * - For Flux: 16
+       * - For Musubi: 64
+       *
+       * Each trainer enforces its own tighter limit (Flux LoRA: [2; 64], Musubi: [2;
+       * 128])
        */
       rank?: number;
 
+      /**
+       * Whether to remove background noise from audio samples before cloning. When
+       * enabled, each sample must be at least 5 seconds long.
+       *
+       * Only available for ElevenLabs voice training
+       */
+      removeBackgroundNoise?: boolean;
+
       /**
        * The prompts to use for each epoch Only available for Flux LoRA training
        */
@@ -2504,12 +3188,148 @@ export namespace TrainTriggerResponse {
        */
       validationPrompt?: string;
 
+      /**
+       * Description of the voice characteristics
+       *
+       * Only available for ElevenLabs voice training
+       */
+      voiceDescription?: string;
+
       /**
        * The Weights And Bias key to use for logging. The maximum length is 40 characters
        */
       wandbKey?: string;
     }
 
+    /**
+     * Aggregated performance stats
+     */
+    export interface PerformanceStats {
+      /**
+       * Performance metrics per variant
+       */
+      variants: Array<PerformanceStats.Variant>;
+
+      /**
+       * Default variant key for quick model comparison
+       */
+      default?: string;
+    }
+
+    export namespace PerformanceStats {
+      /**
+       * Performance stats for a model variant
+       */
+      export interface Variant {
+        /**
+         * The generation capability (example: "txt2img", "img2video", "txt2audio")
+         */
+        capability: string;
+
+        /**
+         * When these stats were last computed (ISO date)
+         */
+        computedAt: string;
+
+        /**
+         * Maximum cost per output asset (CU)
+         */
+        costPerAssetMaxCU: number;
+
+        /**
+         * Minimum cost per output asset (CU)
+         */
+        costPerAssetMinCU: number;
+
+        /**
+         * Median cost per output asset (CU)
+         */
+        costPerAssetP50CU: number;
+
+        /**
+         * Inference latency P50 per output asset (seconds)
+         */
+        inferenceLatencyP50Sec: number;
+
+        /**
+         * Inference latency P75 per output asset (seconds)
+         */
+        inferenceLatencyP75Sec: number;
+
+        /**
+         * Total latency P50 per output asset, including queue time (seconds)
+         */
+        totalLatencyP50Sec: number;
+
+        /**
+         * Total latency P75 per output asset, including queue time (seconds)
+         */
+        totalLatencyP75Sec: number;
+
+        /**
+         * Unique variant identifier (example: "txt2img:1K", "img2video:2K", "txt2audio")
+         */
+        variantKey: string;
+
+        /**
+         * External quality score from arena.ai leaderboard
+         */
+        arenaScore?: Variant.ArenaScore;
+
+        /**
+         * The resolution bucket (example: "0.5K", "1K", "2K", "4K")
+         */
+        resolution?: string;
+      }
+
+      export namespace Variant {
+        /**
+         * External quality score from arena.ai leaderboard
+         */
+        export interface ArenaScore {
+          /**
+           * Arena category (example: "text_to_image", "image_to_video")
+           */
+          arenaCategory: string;
+
+          /**
+           * Model name on arena.ai
+           */
+          arenaModelName: string;
+
+          /**
+           * When this score was last fetched (ISO date)
+           */
+          fetchedAt: string;
+
+          /**
+           * Rank in the arena category
+           */
+          rank: number;
+
+          /**
+           * ELO rating
+           */
+          rating: number;
+
+          /**
+           * ELO rating confidence interval lower bound
+           */
+          ratingLower: number;
+
+          /**
+           * ELO rating confidence interval upper bound
+           */
+          ratingUpper: number;
+
+          /**
+           * Number of human votes
+           */
+          votes: number;
+        }
+      }
+    }
+
     /**
      * A thumbnail for your model
      */
@@ -2583,7 +3403,7 @@ export namespace TrainTriggerResponse {
       /**
        * The stage of the request
        */
-      stage: 'pending' | 'queued-for-train' | 'running-train' | 'starting-train';
+      stage: 'pending' | 'pending-captcha' | 'queued-for-train' | 'running-train' | 'starting-train';
 
       /**
        * Timestamp in milliseconds of the last time the training progress was updated
@@ -2771,21 +3591,31 @@ export namespace TrainTriggerResponse {
 
 export interface TrainActionParams {
   /**
-   * The action to perform on the model training
+   * Body param: The action to perform on the model training
    */
   action: 'cancel';
+
+  /**
+   * Query param: If set to true, returns the original asset without transformation
+   */
+  originalAssets?: boolean;
 }
 
 export interface TrainTriggerParams {
   /**
    * Query param
    */
-  dryRun?: string;
+  dryRun?: unknown;
 
   /**
    * Query param: If set to true, returns the original asset without transformation
    */
-  originalAssets?: string;
+  originalAssets?: boolean;
+
+  /**
+   * Query param: Simulate the number of training images, used for dryRun purpose
+   */
+  trainingImagesCount?: number;
 
   /**
    * Body param
@@ -2795,6 +3625,13 @@ export interface TrainTriggerParams {
 
 export namespace TrainTriggerParams {
   export interface Parameters {
+    /**
+     * Age group of the voice (for professional cloning)
+     *
+     * Only available for ElevenLabs voice training
+     */
+    age?: string;
+
     /**
      * The batch size Less steps, and will increase the learning rate
      *
@@ -2809,6 +3646,14 @@ export namespace TrainTriggerParams {
      */
     classPrompt?: string;
 
+    /**
+     * Type of voice cloning: "instant" (fast) or "professional" (higher quality,
+     * requires captcha)
+     *
+     * Only available for ElevenLabs voice training
+     */
+    cloneType?: string;
+
     /**
      * The prompt with identifier specifying the instance (or subject) of the class
      * (example: "a daiton dog")
@@ -2821,6 +3666,20 @@ export namespace TrainTriggerParams {
      */
     conceptPrompt?: string;
 
+    /**
+     * Gender of the voice (for professional cloning)
+     *
+     * Only available for ElevenLabs voice training
+     */
+    gender?: string;
+
+    /**
+     * Language of the audio samples (ISO 639-1 code)
+     *
+     * Only available for ElevenLabs voice training
+     */
+    language?: string;
+
     /**
      * Initial learning rate (after the potential warmup period)
      *
@@ -2955,15 +3814,27 @@ export namespace TrainTriggerParams {
     /**
      * The dimension of the LoRA update matrices
      *
-     * Only available for SDXL and Flux LoRA training
+     * Only available for SDXL (deprecated), Flux LoRA and Musubi training
      *
      * Default value varies depending on the model type:
      *
-     * - For SDXL: 64
+     * - For SDXL (deprecated): 64
      * - For Flux: 16
+     * - For Musubi: 64
+     *
+     * Each trainer enforces its own tighter limit (Flux LoRA: [2; 64], Musubi: [2;
+     * 128])
      */
     rank?: number;
 
+    /**
+     * Whether to remove background noise from audio samples before cloning. When
+     * enabled, each sample must be at least 5 seconds long.
+     *
+     * Only available for ElevenLabs voice training
+     */
+    removeBackgroundNoise?: boolean;
+
     /**
      * The prompts to use for each epoch Only available for Flux LoRA training
      */
@@ -3017,6 +3888,13 @@ export namespace TrainTriggerParams {
      */
     validationPrompt?: string;
 
+    /**
+     * Description of the voice characteristics
+     *
+     * Only available for ElevenLabs voice training
+     */
+    voiceDescription?: string;
+
     /**
      * The Weights And Bias key to use for logging. The maximum length is 40 characters
      */