@runware/schemas 0.0.0-20260510231619

package/dist/schemas/requests/models/runware/kandinsky-5-0-image-lite.json

@@ -0,0 +1,469 @@
+{
+  "$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:kandinsky-5.0-image-lite@1"
+    },
+    "positivePrompt": {
+      "title": "Positive Prompt",
+      "description": "Text prompt describing elements to include in the generated output.",
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 32000
+    },
+    "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",
+      "multipleOf": 16
+    },
+    "height": {
+      "title": "Height",
+      "description": "Height of the generated media in pixels.",
+      "type": "integer",
+      "multipleOf": 16
+    },
+    "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": 10,
+      "default": 20,
+      "maximum": 50
+    },
+    "scheduler": {
+      "title": "Scheduler",
+      "description": "Scheduler to use for the diffusion process.",
+      "type": "string",
+      "enum": [
+        "DPM++ 2M Karras",
+        "DPM++ SDE Karras",
+        "DPM++ 2M SDE Exponential",
+        "DPM++ 2M SDE Karras",
+        "Euler",
+        "Euler a",
+        "Euler Trailing",
+        "LCM",
+        "DDIM",
+        "DDPM",
+        "PNDM",
+        "UniPC"
+      ]
+    },
+    "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": 2,
+      "default": 7,
+      "maximum": 10
+    },
+    "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
+      }
+    },
+    "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 (1:1)",
+          "properties": {
+            "width": {
+              "const": 1024
+            },
+            "height": {
+              "const": 1024
+            }
+          }
+        },
+        {
+          "title": "1K (~9:20)",
+          "properties": {
+            "width": {
+              "const": 640
+            },
+            "height": {
+              "const": 1408
+            }
+          }
+        },
+        {
+          "title": "1K (~20:9)",
+          "properties": {
+            "width": {
+              "const": 1408
+            },
+            "height": {
+              "const": 640
+            }
+          }
+        },
+        {
+          "title": "1K (3:5)",
+          "properties": {
+            "width": {
+              "const": 768
+            },
+            "height": {
+              "const": 1280
+            }
+          }
+        },
+        {
+          "title": "1K (5:3)",
+          "properties": {
+            "width": {
+              "const": 1280
+            },
+            "height": {
+              "const": 768
+            }
+          }
+        },
+        {
+          "title": "1K (7:9)",
+          "properties": {
+            "width": {
+              "const": 896
+            },
+            "height": {
+              "const": 1152
+            }
+          }
+        },
+        {
+          "title": "1K (9:7)",
+          "properties": {
+            "width": {
+              "const": 1152
+            },
+            "height": {
+              "const": 896
+            }
+          }
+        }
+      ]
+    }
+  ],
+  "additionalProperties": false
+}