@runware/schemas 0.0.0-20260510231619

package/dist/schemas/requests/models/bfl/bfl-flux-1-kontext-dev.json

@@ -0,0 +1,855 @@
+{
+  "$schema": "https://json-schema.org/draft/2019-09/schema",
+  "type": "object",
+  "properties": {
+    "model": {
+      "title": "Model",
+      "description": "Identifier of the model to use for generation.",
+      "type": "string",
+      "const": "runware:106@1"
+    },
+    "inputs": {
+      "title": "Inputs",
+      "description": "The unified payload wrapper for complex media assets dictating image, video or audio inference constraints.",
+      "type": "object",
+      "properties": {
+        "referenceImages": {
+          "title": "Reference Images",
+          "description": "List of reference images (UUID, URL, Data URI, or Base64).",
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "title": "Image",
+            "description": "Image input (UUID, URL, Data URI, or Base64).",
+            "type": "string",
+            "anyOf": [
+              {
+                "format": "uuid"
+              },
+              {
+                "format": "uri"
+              },
+              {
+                "pattern": "^data:image\\/[a-zA-Z]+;base64,[a-zA-Z0-9+/=]+$"
+              },
+              {
+                "pattern": "^[a-zA-Z0-9+/=]+$"
+              }
+            ]
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "positivePrompt": {
+      "title": "Positive Prompt",
+      "description": "Text prompt describing elements to include in the generated output.",
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 3000
+    },
+    "negativePrompt": {
+      "title": "Negative Prompt",
+      "description": "Prompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1).",
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 3000
+    },
+    "width": {
+      "title": "Width",
+      "description": "Width of the generated media in pixels.",
+      "type": "integer"
+    },
+    "height": {
+      "title": "Height",
+      "description": "Height of the generated media in pixels.",
+      "type": "integer"
+    },
+    "seed": {
+      "title": "Seed",
+      "description": "Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.",
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9223372036854776000
+    },
+    "steps": {
+      "title": "Steps",
+      "description": "Total number of denoising steps. Higher values generally produce more detailed results but take longer.",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50
+    },
+    "scheduler": {
+      "title": "Scheduler",
+      "description": "Scheduler to use for the diffusion process.",
+      "type": "string",
+      "enum": [
+        "DDIM",
+        "DDIMScheduler",
+        "DDPMScheduler",
+        "DEISMultistepScheduler",
+        "Default",
+        "DPM++",
+        "DPM++ 2M",
+        "DPM++ 2M Beta",
+        "DPM++ 2M Exponential",
+        "DPM++ 2M Karras",
+        "DPM++ 2M SDE",
+        "DPM++ 2M SDE Beta",
+        "DPM++ 2M SDE Exponential",
+        "DPM++ 2M SDE Karras",
+        "DPM++ 2M SDE Uniform",
+        "DPM++ 2M Uniform",
+        "DPM++ 3M",
+        "DPM++ 3M Beta",
+        "DPM++ 3M Exponential",
+        "DPM++ 3M Karras",
+        "DPM++ 3M SDE Uniform",
+        "DPM++ 3M Uniform",
+        "DPM++ Beta",
+        "DPM++ Exponential",
+        "DPM++ Karras",
+        "DPM++ SDE",
+        "DPM++ SDE Beta",
+        "DPM++ SDE Exponential",
+        "DPM++ SDE Karras",
+        "DPM++ Uniform",
+        "DPM++ Uniform Beta",
+        "DPM++ Uniform Exponential",
+        "DPM++ Uniform Karras",
+        "DPMSolverMultistepInverse",
+        "DPMSolverMultistepScheduler",
+        "DPMSolverSinglestepScheduler",
+        "EDMDPMSolverMultistepScheduler",
+        "EDMEulerScheduler",
+        "Euler",
+        "Euler a",
+        "Euler Beta",
+        "Euler DiscreteScheduler",
+        "Euler Exponential",
+        "Euler Karras",
+        "EulerAncestralDiscreteScheduler",
+        "FlowMatchEulerDiscreteScheduler",
+        "Heun",
+        "HeunDiscreteScheduler",
+        "Heun Karras",
+        "IPNDMScheduler",
+        "IPNDM Uniform",
+        "IPNDM Uniform Beta",
+        "IPNDM Uniform Exponential",
+        "IPNDM Uniform Karras",
+        "KDPM2AncestralDiscreteScheduler",
+        "KDPM2DiscreteScheduler",
+        "LCM",
+        "LCMScheduler",
+        "LMS",
+        "LMSDiscreteScheduler",
+        "LMS Karras",
+        "PNDMScheduler",
+        "TCDScheduler",
+        "UniPC",
+        "UniPC 2M",
+        "UniPC 2M Karras",
+        "UniPC 2M Uniform",
+        "UniPC 3M",
+        "UniPC 3M Karras",
+        "UniPC 3M Uniform",
+        "UniPC Karras",
+        "UniPC Uniform",
+        "UniPC Uniform Beta",
+        "UniPC Uniform Exponential",
+        "UniPC Uniform Karras"
+      ]
+    },
+    "CFGScale": {
+      "title": "CFG Scale",
+      "description": "Guidance scale representing how closely the output will resemble the prompt. Higher values produce results more aligned with the prompt.",
+      "type": "number",
+      "multipleOf": 0.01,
+      "minimum": 0,
+      "maximum": 20
+    },
+    "acceleratorOptions": {
+      "title": "Accelerator Options",
+      "description": "Advanced caching mechanisms to speed up generation.",
+      "type": "object",
+      "properties": {
+        "cacheEndStep": {
+          "title": "Cache End Step",
+          "description": "Absolute step number to end caching. Must be greater than `cacheStartStep` and less than or equal to `steps`.",
+          "type": "integer",
+          "minimum": 1
+        },
+        "cacheEndStepPercentage": {
+          "title": "Cache End Step Percentage",
+          "description": "Percentage of steps to end caching. Alternative to `cacheEndStep`. Must be greater than `cacheStartStepPercentage`.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
+        "cacheMaxConsecutiveSteps": {
+          "title": "Cache Max Consecutive Steps",
+          "description": "Limits the maximum number of consecutive steps that can use cached computations before forcing a fresh computation.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5,
+          "default": 3
+        },
+        "cacheStartStep": {
+          "title": "Cache Start Step",
+          "description": "Absolute step number to start caching. Must be less than `cacheEndStep`.",
+          "type": "integer",
+          "minimum": 0
+        },
+        "cacheStartStepPercentage": {
+          "title": "Cache Start Step Percentage",
+          "description": "Percentage of steps to start caching. Alternative to `cacheStartStep`. Must be less than `cacheEndStepPercentage`.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 99
+        },
+        "fbCache": {
+          "title": "FB Cache",
+          "description": "First Block Cache (FBCache) acceleration. Reuses feature block computations across steps.",
+          "type": "boolean",
+          "default": false
+        },
+        "fbCacheThreshold": {
+          "title": "FB Cache Threshold",
+          "description": "Controls the sensitivity threshold for determining when to reuse cached computations. Lower values reuse more aggressively.",
+          "type": "number",
+          "multipleOf": 0.01,
+          "minimum": 0,
+          "maximum": 1,
+          "default": 0.25
+        },
+        "teaCache": {
+          "title": "TeaCache",
+          "description": "TeaCache acceleration for transformer-based models. Estimates step differences to skip redundant computations.",
+          "type": "boolean",
+          "default": false
+        },
+        "teaCacheDistance": {
+          "title": "TeaCache Distance",
+          "description": "Controls the aggressiveness of the TeaCache feature. Lower values prioritize quality, higher values prioritize speed.",
+          "type": "number",
+          "multipleOf": 0.01,
+          "minimum": 0,
+          "maximum": 1,
+          "default": 0.5
+        },
+        "dbCache": {
+          "title": "DB Cache",
+          "description": "DB Cache (CacheDiT) acceleration. Caches and reuses intermediate transformer block outputs to skip redundant computations.",
+          "type": "boolean",
+          "default": false
+        },
+        "dbCacheThreshold": {
+          "title": "DB Cache Threshold",
+          "description": "Controls the sensitivity threshold for DB Cache. Lower values reuse cached blocks more aggressively, higher values prioritize quality.",
+          "type": "number",
+          "multipleOf": 0.01,
+          "minimum": 0,
+          "maximum": 1,
+          "default": 0.25
+        },
+        "dbCacheSkipInterval": {
+          "title": "DB Cache Skip Interval",
+          "description": "Controls how many steps to skip between cache refreshes. Higher values skip more steps for faster generation at the cost of quality.",
+          "type": "integer",
+          "minimum": 1,
+          "default": 5
+        }
+      },
+      "allOf": [
+        {
+          "not": {
+            "required": [
+              "cacheStartStep",
+              "cacheStartStepPercentage"
+            ]
+          }
+        },
+        {
+          "not": {
+            "required": [
+              "cacheEndStep",
+              "cacheEndStepPercentage"
+            ]
+          }
+        }
+      ],
+      "additionalProperties": false
+    },
+    "lora": {
+      "title": "LoRA",
+      "description": "Configuration for Low-Rank Adaptation models.",
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "properties": {
+          "model": {
+            "title": "LoRA Model",
+            "description": "LoRA model identifier.",
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9._-]+(:[a-zA-Z0-9._/@-]+)?$"
+          },
+          "weight": {
+            "title": "LoRA Weight",
+            "description": "Strength of the LoRA influence. A value of 0 means no influence. Higher values increase the influence, and negative values can be used to steer away from the LoRA's style.",
+            "type": "number",
+            "multipleOf": 0.01,
+            "minimum": -4,
+            "maximum": 4,
+            "default": 1
+          },
+          "transformer": {
+            "title": "LoRA Transformer",
+            "description": "Transformer stages to apply LoRA. Some video models use separate high-noise and low-noise processing stages, and LoRAs can be selectively applied to optimize their effectiveness.",
+            "type": "string",
+            "oneOf": [
+              {
+                "const": "high",
+                "title": "High",
+                "description": "Apply LoRA only to the high-noise processing stage (coarse structure and early generation steps)."
+              },
+              {
+                "const": "low",
+                "title": "Low",
+                "description": "Apply LoRA only to the low-noise processing stage (fine details and later generation steps)."
+              },
+              {
+                "const": "both",
+                "title": "Both",
+                "description": "Apply LoRA to both stages for full coverage."
+              }
+            ],
+            "default": "both"
+          }
+        },
+        "required": [
+          "model"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "ipAdapters": {
+      "title": "IP Adapters",
+      "description": "Configuration for IP-Adapter image-prompted generation.",
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "properties": {
+          "model": {
+            "title": "IP-Adapter Model",
+            "description": "IP-Adapter model identifier.",
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9._-]+(:[a-zA-Z0-9._/@-]+)?$"
+          },
+          "weight": {
+            "title": "IP-Adapter Weight",
+            "description": "Strength of the IP-Adapter influence. A value of 0 means no influence. Higher values increase the influence, and negative values can be used to steer away from the reference.",
+            "type": "number",
+            "multipleOf": 0.01,
+            "minimum": -4,
+            "maximum": 4,
+            "default": 1
+          },
+          "guideImages": {
+            "title": "Guide Images",
+            "description": "Images to guide the IP-Adapter (UUID, URL, Data URI, or Base64).",
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "title": "Image",
+              "description": "Image input (UUID, URL, Data URI, or Base64).",
+              "type": "string",
+              "anyOf": [
+                {
+                  "format": "uuid"
+                },
+                {
+                  "format": "uri"
+                },
+                {
+                  "pattern": "^data:image\\/[a-zA-Z]+;base64,[a-zA-Z0-9+/=]+$"
+                },
+                {
+                  "pattern": "^[a-zA-Z0-9+/=]+$"
+                }
+              ]
+            }
+          },
+          "combineMethod": {
+            "title": "Combine Method",
+            "description": "Controls how multiple reference images are combined.",
+            "type": "string",
+            "enum": [
+              "concat",
+              "add",
+              "subtract",
+              "average",
+              "norm_average"
+            ],
+            "default": "concat"
+          },
+          "embedScaling": {
+            "title": "Embed Scaling",
+            "description": "Determines which embedding components are used and their strength.",
+            "type": "string",
+            "enum": [
+              "only_v",
+              "kv",
+              "kv_penalty_c",
+              "k_mean_v_penalty_c"
+            ],
+            "default": "kv"
+          },
+          "weightType": {
+            "title": "Weight Type",
+            "description": "Shapes how influence evolves during generation.",
+            "type": "string",
+            "enum": [
+              "normal",
+              "ease_in",
+              "ease_out",
+              "ease_in_out",
+              "weak_input",
+              "weak_output",
+              "weak_middle",
+              "strong_middle",
+              "style_transfer",
+              "composition",
+              "strong_style_transfer",
+              "style_and_composition",
+              "strong_style_and_composition"
+            ],
+            "default": "normal"
+          },
+          "weightComposition": {
+            "title": "Weight Composition",
+            "description": "Controls composition/layout influence specifically.",
+            "type": "number",
+            "multipleOf": 0.01,
+            "minimum": 0,
+            "maximum": 1
+          }
+        },
+        "required": [
+          "model",
+          "guideImages"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "trueCFGScale": {
+      "title": "True CFG Scale",
+      "description": "True Classifier-Free Guidance scale. Higher values increase prompt adherence at the cost of quality.",
+      "type": "number"
+    },
+    "ultralytics": {
+      "title": "Ultralytics Features",
+      "description": "Configuration for Ultralytics face enhancement.",
+      "type": "object",
+      "properties": {
+        "CFGScale": {
+          "title": "CFG Scale",
+          "description": "Face refinement guidance scale.",
+          "type": "number",
+          "multipleOf": 0.1,
+          "minimum": 0,
+          "maximum": 50,
+          "default": 8
+        },
+        "confidence": {
+          "title": "Confidence",
+          "description": "Confidence threshold for detection.",
+          "type": "number",
+          "multipleOf": 0.01,
+          "minimum": 0,
+          "maximum": 1,
+          "default": 0.9
+        },
+        "maskBlur": {
+          "title": "Mask Blur",
+          "description": "Mask feathering amount. Higher values create softer transitions between the enhanced face region and surrounding areas.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100,
+          "default": 5
+        },
+        "maskPadding": {
+          "title": "Mask Padding",
+          "description": "Padding around detected face in pixels. Expands the refinement area to include surrounding context like hair and neck.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 20,
+          "default": 5
+        },
+        "negativePrompt": {
+          "title": "Negative Prompt",
+          "description": "Negative prompt for detection.",
+          "type": "string"
+        },
+        "positivePrompt": {
+          "title": "Positive Prompt",
+          "description": "Positive prompt for detection.",
+          "type": "string"
+        },
+        "steps": {
+          "title": "Steps",
+          "description": "Number of face refinement steps.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100,
+          "default": 20
+        },
+        "strength": {
+          "title": "Strength",
+          "description": "Refinement strength. Lower values preserve more of the original, higher values allow more aggressive reconstruction.",
+          "type": "number",
+          "multipleOf": 0.01,
+          "minimum": 0,
+          "maximum": 1,
+          "default": 0.3
+        }
+      },
+      "additionalProperties": false
+    },
+    "taskType": {
+      "title": "Task Type",
+      "description": "Identifier for the type of task being performed",
+      "type": "string",
+      "const": "imageInference"
+    },
+    "taskUUID": {
+      "title": "Task UUID",
+      "description": "UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.",
+      "type": "string",
+      "format": "uuid"
+    },
+    "webhookURL": {
+      "title": "Webhook URL",
+      "description": "Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.",
+      "type": "string",
+      "format": "uri"
+    },
+    "includeCost": {
+      "title": "Include Cost",
+      "description": "Include task cost in the response.",
+      "type": "boolean",
+      "default": false
+    },
+    "numberResults": {
+      "title": "Number of Results",
+      "description": "Number of results to generate. Each result uses a different seed, producing variations of the same parameters.",
+      "type": "integer",
+      "minimum": 1,
+      "default": 1,
+      "maximum": 20
+    },
+    "uploadEndpoint": {
+      "title": "Upload Endpoint",
+      "description": "URL to upload content via HTTP PUT. The request body will contain the raw binary data.",
+      "type": "string",
+      "format": "uri"
+    },
+    "ttl": {
+      "title": "TTL",
+      "description": "Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.",
+      "type": "integer",
+      "minimum": 60
+    },
+    "outputType": {
+      "title": "Output Type",
+      "description": "Image output type.",
+      "type": "string",
+      "enum": [
+        "URL",
+        "base64Data",
+        "dataURI"
+      ],
+      "default": "URL"
+    },
+    "outputFormat": {
+      "title": "Output Format",
+      "description": "File format for the generated image.",
+      "type": "string",
+      "enum": [
+        "JPG",
+        "PNG",
+        "WEBP"
+      ],
+      "default": "JPG"
+    },
+    "outputQuality": {
+      "title": "Output Quality",
+      "description": "Compression quality of the output. Higher values preserve quality but increase file size.",
+      "type": "integer",
+      "minimum": 20,
+      "maximum": 99,
+      "default": 95
+    },
+    "deliveryMethod": {
+      "title": "Delivery Method",
+      "description": "Determines how the API delivers task results.",
+      "type": "string",
+      "oneOf": [
+        {
+          "const": "sync",
+          "description": "Returns complete results directly in the API response."
+        },
+        {
+          "const": "async",
+          "description": "Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse."
+        }
+      ],
+      "default": "sync"
+    },
+    "safety": {
+      "type": "object",
+      "title": "Safety Settings",
+      "description": "Content safety checking configuration for image generation.",
+      "properties": {
+        "checkContent": {
+          "title": "Check Content",
+          "description": "Enable or disable content safety checking. When enabled, defaults to `fast` mode.",
+          "type": "boolean",
+          "default": false
+        },
+        "mode": {
+          "description": "Safety checking mode for image generation.",
+          "type": "string",
+          "oneOf": [
+            {
+              "const": "none",
+              "title": "None",
+              "description": "Disables checking."
+            },
+            {
+              "const": "fast",
+              "title": "Fast",
+              "description": "Performs a single check."
+            }
+          ],
+          "default": "none"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "positivePrompt",
+    "width",
+    "height",
+    "taskType",
+    "taskUUID",
+    "model"
+  ],
+  "allOf": [
+    {
+      "dependentRequired": {
+        "width": [
+          "height"
+        ],
+        "height": [
+          "width"
+        ]
+      }
+    },
+    {
+      "oneOf": [
+        {
+          "title": "1K (~21:9)",
+          "properties": {
+            "width": {
+              "const": 1568
+            },
+            "height": {
+              "const": 672
+            }
+          }
+        },
+        {
+          "title": "1K (~20:9)",
+          "properties": {
+            "width": {
+              "const": 1504
+            },
+            "height": {
+              "const": 688
+            }
+          }
+        },
+        {
+          "title": "1K (~2:1)",
+          "properties": {
+            "width": {
+              "const": 1456
+            },
+            "height": {
+              "const": 720
+            }
+          }
+        },
+        {
+          "title": "1K (~17:9)",
+          "properties": {
+            "width": {
+              "const": 1392
+            },
+            "height": {
+              "const": 752
+            }
+          }
+        },
+        {
+          "title": "1K (5:3)",
+          "properties": {
+            "width": {
+              "const": 1328
+            },
+            "height": {
+              "const": 800
+            }
+          }
+        },
+        {
+          "title": "1K (3:2)",
+          "properties": {
+            "width": {
+              "const": 1248
+            },
+            "height": {
+              "const": 832
+            }
+          }
+        },
+        {
+          "title": "1K (~4:3)",
+          "properties": {
+            "width": {
+              "const": 1184
+            },
+            "height": {
+              "const": 880
+            }
+          }
+        },
+        {
+          "title": "1K (~7:6)",
+          "properties": {
+            "width": {
+              "const": 1104
+            },
+            "height": {
+              "const": 944
+            }
+          }
+        },
+        {
+          "title": "1K (1:1)",
+          "properties": {
+            "width": {
+              "const": 1024
+            },
+            "height": {
+              "const": 1024
+            }
+          }
+        },
+        {
+          "title": "1K (~6:7)",
+          "properties": {
+            "width": {
+              "const": 944
+            },
+            "height": {
+              "const": 1104
+            }
+          }
+        },
+        {
+          "title": "1K (~3:4)",
+          "properties": {
+            "width": {
+              "const": 880
+            },
+            "height": {
+              "const": 1184
+            }
+          }
+        },
+        {
+          "title": "1K (2:3)",
+          "properties": {
+            "width": {
+              "const": 832
+            },
+            "height": {
+              "const": 1248
+            }
+          }
+        },
+        {
+          "title": "1K (3:5)",
+          "properties": {
+            "width": {
+              "const": 800
+            },
+            "height": {
+              "const": 1328
+            }
+          }
+        },
+        {
+          "title": "1K (~9:17)",
+          "properties": {
+            "width": {
+              "const": 752
+            },
+            "height": {
+              "const": 1392
+            }
+          }
+        },
+        {
+          "title": "1K (~1:2)",
+          "properties": {
+            "width": {
+              "const": 720
+            },
+            "height": {
+              "const": 1456
+            }
+          }
+        },
+        {
+          "title": "1K (~9:20)",
+          "properties": {
+            "width": {
+              "const": 688
+            },
+            "height": {
+              "const": 1504
+            }
+          }
+        },
+        {
+          "title": "1K (~9:21)",
+          "properties": {
+            "width": {
+              "const": 672
+            },
+            "height": {
+              "const": 1568
+            }
+          }
+        }
+      ]
+    }
+  ],
+  "additionalProperties": false
+}