{
  "$id": "https://docs.legnext.ai/schemas/mj-image-params.v1.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "allOf": [
    {
      "description": "Midjourney v8 rejects: --cref, --cw, --draft, --turbo",
      "if": {
        "anyOf": [
          {
            "properties": {
              "v": {
                "const": "8"
              }
            },
            "required": [
              "v"
            ]
          },
          {
            "properties": {
              "version": {
                "const": "8"
              }
            },
            "required": [
              "version"
            ]
          }
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "cref"
              ]
            },
            {
              "required": [
                "cw"
              ]
            },
            {
              "required": [
                "draft"
              ]
            },
            {
              "required": [
                "turbo"
              ]
            }
          ]
        }
      }
    },
    {
      "description": "Midjourney v8.1 rejects: --cref, --cw, --oref, --ow, --q, --quality, --sd, --turbo",
      "if": {
        "anyOf": [
          {
            "properties": {
              "v": {
                "const": "8.1"
              }
            },
            "required": [
              "v"
            ]
          },
          {
            "properties": {
              "version": {
                "const": "8.1"
              }
            },
            "required": [
              "version"
            ]
          }
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "cref"
              ]
            },
            {
              "required": [
                "cw"
              ]
            },
            {
              "required": [
                "oref"
              ]
            },
            {
              "required": [
                "ow"
              ]
            },
            {
              "required": [
                "q"
              ]
            },
            {
              "required": [
                "quality"
              ]
            },
            {
              "required": [
                "sd"
              ]
            },
            {
              "required": [
                "turbo"
              ]
            }
          ]
        }
      }
    },
    {
      "description": "Midjourney v8.2 rejects: --cref, --cw, --oref, --ow, --q, --quality, --sd, --turbo",
      "if": {
        "anyOf": [
          {
            "properties": {
              "v": {
                "const": "8.2"
              }
            },
            "required": [
              "v"
            ]
          },
          {
            "properties": {
              "version": {
                "const": "8.2"
              }
            },
            "required": [
              "version"
            ]
          }
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "cref"
              ]
            },
            {
              "required": [
                "cw"
              ]
            },
            {
              "required": [
                "oref"
              ]
            },
            {
              "required": [
                "ow"
              ]
            },
            {
              "required": [
                "q"
              ]
            },
            {
              "required": [
                "quality"
              ]
            },
            {
              "required": [
                "sd"
              ]
            },
            {
              "required": [
                "turbo"
              ]
            }
          ]
        }
      }
    }
  ],
  "description": "Machine-readable contract for the Midjourney image-generation prompt parameters accepted by the Legnext API (https://api.legnext.ai). Validate a structured parameter object: set the model version with \"v\" (or \"version\") and each flag by name without the leading \"--\" (booleans as true). The if/then rules encode exactly the combinations the API rejects up front with a 400; the x-params annotation carries the full status matrix, cost multipliers, value types, and descriptions. Unrecognized v8 minors inherit the newest known v8 row (see x-versions). Additive-only within this URL version: new flags, version rows, and annotations may appear, but existing entries will not be removed or re-typed — breaking changes ship under a new URL (v2). Generated from spec/mj-image-params.yaml in legnext-ai/Legnext-backend — do not edit by hand.",
  "properties": {
    "ar": {
      "description": "Images are initially square; use this to change the shape. Integer ratios only — use 139:100 instead of 1.39:1.",
      "pattern": "^[0-9]+:[0-9]+$",
      "type": "string",
      "x-param": "aspect"
    },
    "aspect": {
      "description": "Images are initially square; use this to change the shape. Integer ratios only — use 139:100 instead of 1.39:1.",
      "pattern": "^[0-9]+:[0-9]+$",
      "type": "string",
      "x-param": "aspect"
    },
    "bs": {
      "description": "Legacy batch-size flag. Not supported for image generation — video endpoints only; accepted by the API but unverified.",
      "type": "string",
      "x-param": "bs"
    },
    "c": {
      "description": "Adds variety to image results; higher values create more unusual images.",
      "type": "number",
      "x-param": "chaos"
    },
    "chaos": {
      "description": "Adds variety to image results; higher values create more unusual images.",
      "type": "number",
      "x-param": "chaos"
    },
    "cref": {
      "description": "Keeps the same character across images. Only v6 / v6.1 / niji 6 — replaced by Omni Reference (--oref) from v7 onward; the whole v8 family rejects it. A no-version prompt using --cref renders as v7 and fails upstream with Invalid prompt format.",
      "format": "uri",
      "type": "string",
      "x-param": "character_reference"
    },
    "cw": {
      "description": "Keeps the same character across images. Only v6 / v6.1 / niji 6 — replaced by Omni Reference (--oref) from v7 onward; the whole v8 family rejects it. A no-version prompt using --cref renders as v7 and fails upstream with Invalid prompt format.",
      "type": "number",
      "x-param": "character_reference"
    },
    "draft": {
      "description": "Rapid low-resolution exploration. v7: 4 images at half price. v8.1 / v8.2: a 24-image batch billed at the standard rate (no discount); only the first 4 images are actionable. Not available on v8.0 — rejected up front.",
      "type": "boolean",
      "x-param": "draft"
    },
    "end": {
      "description": "Legacy video flag, accepted by the API; semantics unverified.",
      "type": "string",
      "x-param": "end"
    },
    "exp": {
      "description": "Experimental aesthetic control (legacy flag, accepted by the API; semantics unverified).",
      "type": "number",
      "x-param": "exp"
    },
    "fast": {
      "description": "Default GPU speed mode (standard processing speed, typically under 1 minute).",
      "type": "boolean",
      "x-param": "fast"
    },
    "hd": {
      "description": "v8.1 / v8.2: renders native 2K (2048x2048) at 1.5x the standard cost (120 credits vs 80 for SD). v8.0 and pre-V8: no effect — renders SD 1024 and is billed 1x.",
      "type": "boolean",
      "x-param": "hd"
    },
    "iw": {
      "description": "Controls the influence of image prompts; higher values make image prompts more influential. Probed passing on v8.2.",
      "type": "number",
      "x-param": "iw"
    },
    "loop": {
      "description": "Legacy video flag, accepted by the API; semantics unverified.",
      "type": "boolean",
      "x-param": "loop"
    },
    "motion": {
      "description": "Controls video motion intensity (video tasks only); higher = more motion. Legacy flag, value handling unverified.",
      "type": "string",
      "x-param": "motion"
    },
    "niji": {
      "description": "Focused anime and East Asian aesthetic model (e.g. --niji 6).",
      "type": "string",
      "x-param": "niji"
    },
    "no": {
      "description": "Tells the model what not to include in the image. Supported on v6 / v6.1 / v7 / v8 / v8.1 / v8.2 (not niji 6).",
      "type": "string",
      "x-param": "no"
    },
    "oref": {
      "description": "References a person or object from another image (v7+); in v8.0 it replaces --cref, handling both person likeness and object form. Removed from v8.1 onward — rejected on v8.1 and v8.2.",
      "format": "uri",
      "type": "string",
      "x-param": "omni_reference"
    },
    "ow": {
      "description": "References a person or object from another image (v7+); in v8.0 it replaces --cref, handling both person likeness and object form. Removed from v8.1 onward — rejected on v8.1 and v8.2.",
      "type": "number",
      "x-param": "omni_reference"
    },
    "p": {
      "description": "Personalization profile selector (--p / --profile).",
      "type": "string",
      "x-param": "profile"
    },
    "profile": {
      "description": "Personalization profile selector (--p / --profile).",
      "type": "string",
      "x-param": "profile"
    },
    "q": {
      "description": "Controls image detail and processing time. V8 supports --q 4 for enhanced coherence (4x cost). Removed from v8.1 onward — rejected on v8.1 and v8.2.",
      "type": "number",
      "x-param": "quality"
    },
    "quality": {
      "description": "Controls image detail and processing time. V8 supports --q 4 for enhanced coherence (4x cost). Removed from v8.1 onward — rejected on v8.1 and v8.2.",
      "type": "number",
      "x-param": "quality"
    },
    "raw": {
      "description": "Vestigial alias carried over from the legacy flag set — the real surface is --style raw.",
      "type": "boolean",
      "x-param": "raw"
    },
    "s": {
      "description": "Controls artistic style: lower = more prompt-focused, higher = more artistic.",
      "type": "number",
      "x-param": "stylize"
    },
    "sd": {
      "description": "From v8.1 on, SD is controlled via the Midjourney web settings panel and is not exposed via the API — rejected on v8.1 and v8.2.",
      "type": "boolean",
      "x-param": "seed_diffusion"
    },
    "seed": {
      "description": "For testing and experimentation: same seed + same prompt = consistent results.",
      "type": "number",
      "x-param": "seed"
    },
    "sref": {
      "description": "Matches the look and feel of another image. Probed passing on v8.2.",
      "format": "uri",
      "type": "string",
      "x-param": "sref"
    },
    "stop": {
      "description": "Finish images partway through the process for a softer, more unique look.",
      "type": "number",
      "x-param": "stop"
    },
    "style": {
      "description": "Style selector. --style raw reduces the default aesthetic styling; probed passing on v8.2.",
      "type": "string",
      "x-param": "style"
    },
    "stylize": {
      "description": "Controls artistic style: lower = more prompt-focused, higher = more artistic.",
      "type": "number",
      "x-param": "stylize"
    },
    "sw": {
      "description": "Style weight; companion parameter of --sref.",
      "type": "number",
      "x-param": "sw"
    },
    "tile": {
      "description": "Creates seamless tiled images for patterns and textures. Probed passing on v8.2.",
      "type": "boolean",
      "x-param": "tile"
    },
    "turbo": {
      "description": "High-performance GPU pool, up to 4x faster, double cost (v5+ only). The entire v8 family rejects --turbo, so it is rejected up front on v8 / v8.1 / v8.2 — use --fast instead.",
      "type": "boolean",
      "x-param": "turbo"
    },
    "v": {
      "description": "Switches between model versions. When --v is omitted the API renders as v7 — version is the user's choice, never injected.",
      "type": "string",
      "x-param": "version"
    },
    "version": {
      "description": "Switches between model versions. When --v is omitted the API renders as v7 — version is the user's choice, never injected.",
      "type": "string",
      "x-param": "version"
    },
    "w": {
      "description": "Makes images strange and unconventional.",
      "type": "number",
      "x-param": "weird"
    },
    "weird": {
      "description": "Makes images strange and unconventional.",
      "type": "number",
      "x-param": "weird"
    }
  },
  "schema_version": 1,
  "title": "Legnext Midjourney image parameters (v1)",
  "type": "object",
  "x-params": {
    "aspect": {
      "display_name": "Aspect Ratio",
      "description": "Images are initially square; use this to change the shape. Integer ratios only — use 139:100 instead of 1.39:1.",
      "flags": [
        "ar",
        "aspect"
      ],
      "value_type": "ratio",
      "values": "Up to 14:1 (4:1 for v8.1 / v8.2 HD)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "bs": {
      "display_name": "Batch Size (legacy)",
      "description": "Legacy batch-size flag. Not supported for image generation — video endpoints only; accepted by the API but unverified.",
      "flags": [
        "bs"
      ],
      "value_type": "string",
      "values": "[1, 2, 4] (video endpoints only)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "chaos": {
      "display_name": "Chaos",
      "description": "Adds variety to image results; higher values create more unusual images.",
      "flags": [
        "c",
        "chaos"
      ],
      "value_type": "number",
      "values": "0-100 (default: 0)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "character_reference": {
      "display_name": "Character Reference",
      "description": "Keeps the same character across images. Only v6 / v6.1 / niji 6 — replaced by Omni Reference (--oref) from v7 onward; the whole v8 family rejects it. A no-version prompt using --cref renders as v7 and fails upstream with Invalid prompt format.",
      "flags": [
        "cref",
        "cw"
      ],
      "value_type": "url",
      "values": "Image URL (--cref); weight 0-100 (--cw)",
      "versions": {
        "8": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "draft": {
      "display_name": "Draft Mode",
      "description": "Rapid low-resolution exploration. v7: 4 images at half price. v8.1 / v8.2: a 24-image batch billed at the standard rate (no discount); only the first 4 images are actionable. Not available on v8.0 — rejected up front.",
      "flags": [
        "draft"
      ],
      "value_type": "bool",
      "values": "No value",
      "versions": {
        "8": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "end": {
      "display_name": "End (legacy)",
      "description": "Legacy video flag, accepted by the API; semantics unverified.",
      "flags": [
        "end"
      ],
      "value_type": "string",
      "values": "—",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "exp": {
      "display_name": "Experimental",
      "description": "Experimental aesthetic control (legacy flag, accepted by the API; semantics unverified).",
      "flags": [
        "exp"
      ],
      "value_type": "number",
      "values": "No value",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "fast": {
      "display_name": "Fast Mode",
      "description": "Default GPU speed mode (standard processing speed, typically under 1 minute).",
      "flags": [
        "fast"
      ],
      "value_type": "bool",
      "values": "No value",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "hd": {
      "display_name": "HD Mode",
      "description": "v8.1 / v8.2: renders native 2K (2048x2048) at 1.5x the standard cost (120 credits vs 80 for SD). v8.0 and pre-V8: no effect — renders SD 1024 and is billed 1x.",
      "flags": [
        "hd"
      ],
      "value_type": "bool",
      "values": "No value",
      "versions": {
        "8": {
          "status": "noop",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1.5
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1.5
        },
        "default": {
          "status": "noop",
          "cost_multiplier": 1
        }
      }
    },
    "iw": {
      "display_name": "Image Weight",
      "description": "Controls the influence of image prompts; higher values make image prompts more influential. Probed passing on v8.2.",
      "flags": [
        "iw"
      ],
      "value_type": "number",
      "values": "0-3 (default: 1)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "loop": {
      "display_name": "Loop (legacy)",
      "description": "Legacy video flag, accepted by the API; semantics unverified.",
      "flags": [
        "loop"
      ],
      "value_type": "bool",
      "values": "—",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "motion": {
      "display_name": "Motion",
      "description": "Controls video motion intensity (video tasks only); higher = more motion. Legacy flag, value handling unverified.",
      "flags": [
        "motion"
      ],
      "value_type": "string",
      "values": "1-4 (default: 2)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "niji": {
      "display_name": "Niji",
      "description": "Focused anime and East Asian aesthetic model (e.g. --niji 6).",
      "flags": [
        "niji"
      ],
      "value_type": "string",
      "values": "5, 6 (current: 6)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "no": {
      "display_name": "Negative Prompt",
      "description": "Tells the model what not to include in the image. Supported on v6 / v6.1 / v7 / v8 / v8.1 / v8.2 (not niji 6).",
      "flags": [
        "no"
      ],
      "value_type": "string",
      "values": "Text description",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "omni_reference": {
      "display_name": "Omni Reference",
      "description": "References a person or object from another image (v7+); in v8.0 it replaces --cref, handling both person likeness and object form. Removed from v8.1 onward — rejected on v8.1 and v8.2.",
      "flags": [
        "oref",
        "ow"
      ],
      "value_type": "url",
      "values": "Image URL (--oref); weight (--ow)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "profile": {
      "display_name": "Personalization Profile",
      "description": "Personalization profile selector (--p / --profile).",
      "flags": [
        "p",
        "profile"
      ],
      "value_type": "string",
      "values": "Profile code",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "quality": {
      "display_name": "Quality",
      "description": "Controls image detail and processing time. V8 supports --q 4 for enhanced coherence (4x cost). Removed from v8.1 onward — rejected on v8.1 and v8.2.",
      "flags": [
        "q",
        "quality"
      ],
      "value_type": "number",
      "values": "0.25, 0.5, 1, 2, 4 (default: 1)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "raw": {
      "display_name": "Raw Mode",
      "description": "Vestigial alias carried over from the legacy flag set — the real surface is --style raw.",
      "flags": [
        "raw"
      ],
      "value_type": "bool",
      "values": "No value",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "seed": {
      "display_name": "Seed",
      "description": "For testing and experimentation: same seed + same prompt = consistent results.",
      "flags": [
        "seed"
      ],
      "value_type": "number",
      "values": "0-4294967295",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "seed_diffusion": {
      "display_name": "Seed Diffusion",
      "description": "From v8.1 on, SD is controlled via the Midjourney web settings panel and is not exposed via the API — rejected on v8.1 and v8.2.",
      "flags": [
        "sd"
      ],
      "value_type": "bool",
      "values": "No value",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "sref": {
      "display_name": "Style Reference",
      "description": "Matches the look and feel of another image. Probed passing on v8.2.",
      "flags": [
        "sref"
      ],
      "value_type": "url",
      "values": "Image URL",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "stop": {
      "display_name": "Stop",
      "description": "Finish images partway through the process for a softer, more unique look.",
      "flags": [
        "stop"
      ],
      "value_type": "number",
      "values": "10-100 (default: 100)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "style": {
      "display_name": "Style",
      "description": "Style selector. --style raw reduces the default aesthetic styling; probed passing on v8.2.",
      "flags": [
        "style"
      ],
      "value_type": "string",
      "values": "Style name (e.g. raw)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "stylize": {
      "display_name": "Stylize",
      "description": "Controls artistic style: lower = more prompt-focused, higher = more artistic.",
      "flags": [
        "s",
        "stylize"
      ],
      "value_type": "number",
      "values": "0-1000 (default: 100)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "sw": {
      "display_name": "Style Weight",
      "description": "Style weight; companion parameter of --sref.",
      "flags": [
        "sw"
      ],
      "value_type": "number",
      "values": "Number",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "tile": {
      "display_name": "Tile",
      "description": "Creates seamless tiled images for patterns and textures. Probed passing on v8.2.",
      "flags": [
        "tile"
      ],
      "value_type": "bool",
      "values": "No value",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "turbo": {
      "display_name": "Turbo Mode",
      "description": "High-performance GPU pool, up to 4x faster, double cost (v5+ only). The entire v8 family rejects --turbo, so it is rejected up front on v8 / v8.1 / v8.2 — use --fast instead.",
      "flags": [
        "turbo"
      ],
      "value_type": "bool",
      "values": "No value",
      "versions": {
        "8": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "rejected",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "version": {
      "display_name": "Version",
      "description": "Switches between model versions. When --v is omitted the API renders as v7 — version is the user's choice, never injected.",
      "flags": [
        "v",
        "version"
      ],
      "value_type": "string",
      "values": "1-8.2 (API default: 7; latest: 8.2)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    },
    "weird": {
      "display_name": "Weird",
      "description": "Makes images strange and unconventional.",
      "flags": [
        "w",
        "weird"
      ],
      "value_type": "number",
      "values": "0-3000 (default: 0)",
      "versions": {
        "8": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.1": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "8.2": {
          "status": "supported",
          "cost_multiplier": 1
        },
        "default": {
          "status": "supported",
          "cost_multiplier": 1
        }
      }
    }
  },
  "x-status-legend": {
    "noop": "accepted but has no effect on this version, and is not billed",
    "rejected": "the API returns 400 before the prompt is processed",
    "stripped": "removed from the prompt before processing",
    "supported": "flag reaches the upstream and has an effect on this version"
  },
  "x-versions": {
    "8": {
      "family": "v8",
      "grid_edit_actions": false
    },
    "8.1": {
      "family": "v8",
      "grid_edit_actions": false
    },
    "8.2": {
      "family": "v8",
      "released": "2026-07-24",
      "grid_edit_actions": false
    },
    "default": {
      "grid_edit_actions": true
    }
  }
}