> ## Documentation Index > Fetch the complete documentation index at: https://docs.legnext.ai/llms.txt > Use this file to discover all available pages before exploring further. # Image Parameters > Comprehensive reference for image generation parameters including aspect ratio, style, quality, chaos, and version control for Midjourney API Control various parameter settings for image generation to help you create ideal image effects. ## Image Generation Parameter List | Parameter | Format | Values/Range | Description | | ------------------- | ------------------ | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | Aspect Ratio | `--aspect`, `--ar` | Up to 14:1 (4:1 for v8.1 HD) | Images are initially square, but you can use the aspect ratio parameter to change this | | Chaos | `--chaos`, `--c` | 0-100 (default: 0) | Use the chaos parameter to add variety to your image results. Higher values create more unusual results | | Character Reference | `--cref` | Image URL | Keep the same character across images. **Only v6 / v6.1 / niji 6** — replaced by Omni Reference (`--oref`) from v7 onward. Not supported on v7/v8/v8.1. | | Negative Prompt | `--no` | Text description | Use the negative parameter to tell what you don't want to see in the image. Supported on v6 / v6.1 / v7 / v8 / v8.1 (not niji 6). | | Quality | `--quality`, `--q` | 0.25, 0.5, 1, 2, 4 (default: 1) | Use the quality parameter to control image detail and processing time. V8 supports --q 4 for enhanced coherence (4x cost). **Removed in V8.1** | | Seed | `--seed` | 0-4294967295 | Use the seed parameter for testing and experimentation. Same seed with same prompt = consistent results | | Stop | `--stop` | 10-100 (default: 100) | Need a softer, more unique look? Use the stop parameter to finish images halfway through the process | | Raw Mode | `--raw` | No value | Use raw mode to get more control over your images, reduces default aesthetic styling | | Stylize | `--stylize`, `--s` | 0-1000 (default: 100) | Use the stylize parameter to control artistic style in images. Lower = more prompt-focused, Higher = more artistic | | Style Reference | `--sref` | Image URL | Want to match the look and feel of another image? You can provide style reference! | | Omni Reference | `--oref` | Image URL | V7+. Reference a person or object from another image. In V8, replaces --cref and handles both person likeness and object form. **Removed in V8.1** | | Tile | `--tile` | No value | Use the tile parameter to create seamless tiled images for patterns and textures | | Version | `--version`, `--v` | 1-8.1 (API default: 7; latest: 8.1) | Use version parameter to explore and switch between different model versions | | HD Mode | `--hd` | No value | V8: native 2K resolution at 4x credit cost. V8.1: `--hd` produces native 2K (2048×2048) at **1.5× cost** (120 credits; default output is 1024×1024 SD). | | Draft | `--draft` | No value | Generate draft images using half GPU power for rapid prototyping. **V7 only** (Draft Mode is not available on v8/v8.1) | | Weird | `--weird`, `--w` | 0-3000 (default: 0) | Use the weird parameter to make your images strange and unconventional | | Fast | `--fast` | No value | Switch your GPU speed to fast mode (default processing speed) | | Image Weight | `--iw` | 0-3 (default: 1) | Control the influence of image prompts. Higher values make image prompts more influential | | Relax | `--relax` | No value | Switch your GPU speed to relax mode (slower but uses less quota) | | Turbo | `--turbo` | No value | Switch your GPU speed to turbo mode (4x faster, double cost, v5+ only) | | Niji | `--niji` | 5, 6 (current: 6) | Use our focused anime and East Asian aesthetic model | | Experimental | `--exp` | No value | Control the aesthetic effects of image generation with experimental features | | Motion | `--motion` | 1-4 (default: 2) | Control video motion status (only supports video tasks). Higher = more motion | ### Example Usage ``` A cute kitten --ar 16:9 --stylize 100 Beautiful landscape, sunset --quality 1 --chaos 50 Portrait --cref [reference image URL] --niji A small duck holding a magic wand --oref [object reference URL] Dynamic explosion --chaos 75 --weird 250 --s 200 Minimalist design --raw --stylize 0 --stop 80 Mountain scenery --ar 16:9 Abstract art --stylize 500 --weird 750 ``` ## Advanced Prompt Techniques ### Multi-Prompts Use double colons `::` to separate concepts and control their relative importance: ``` Hot dog:: animal --ar 16:9 Hot:: dog:: animal --ar 16:9 ``` The first example treats "Hot dog" as one concept, while the second separates "Hot" and "dog" as different concepts. ### Prompt Weights Add weights to multi-prompt sections using `::` followed by a number: ``` Beach::2 mountain forest --ar 16:9 ``` This gives "Beach" twice the weight of "mountain forest" in the generation. **Weight Examples:** * `::2` - Double weight * `::0.5` - Half weight * `::-0.5` - Negative weight (reduces influence) ### Negative Prompting Examples ``` Beautiful garden --no weeds, dead plants, brown leaves Portrait --no glasses, hat, beard Landscape --no buildings, cars, people ``` ### Advanced Parameter Combinations **Ultra-detailed realistic photo:** ``` Professional portrait --quality 2 --stylize 50 --chaos 10 ``` **Artistic and experimental:** ``` Abstract art --stylize 750 --weird 1500 --chaos 80 ``` **Character consistency across images:** ``` Character design --cref [URL] --seed 12345 --stylize 200 ``` **Anime style with motion:** ``` Dynamic action scene --niji 6 --motion 4 --chaos 30 ``` ## Supported Aspect Ratios Core aspect ratios and their typical applications: * **1:1** - Standard square, suitable for social media avatars, Instagram posts * **4:3** - Traditional rectangle, suitable for older monitors, tablets * **2:3** - Classic photography ratio, commonly used for frames, posters * **16:9** - Modern widescreen ratio, mainstream standard for HD video, smart TVs * **9:16** - Portrait ratio, optimized for mobile short videos, social media stories ### Setting Aspect Ratios You can quickly determine and set image aspect ratios through these methods: * **Based on pixel dimensions**: For 1920x1080 pixel images, input `--ar 1920:1080`, system automatically simplifies to `--ar 16:9` * **Based on physical dimensions**: For sizes like 8.5x11 inches, remove decimal points and input `--ar 85:110` * **Custom ratios**: Supports any integer ratios, such as `--ar 3:2` or `--ar 5:4` ### Important Notes * Default aspect ratio is 1:1, suitable for most basic scenarios * Only supports integer ratios, use 139:100 instead of 1.39:1 * Different model versions may have varying support for aspect ratios * Extreme aspect ratios (like 1:10 or 10:1) are experimental features with potentially unstable results * During HD processing, some aspect ratios may be fine-tuned for optimization ## Detailed Parameter Guidelines ### Stylize Parameter Effects **Low Stylize (0-50):** More literal interpretation of prompts * `--s 0`: Very literal, follows prompt closely * `--s 25`: Slight artistic interpretation * `--s 50`: Balanced between literal and artistic **Medium Stylize (100-250):** Default range with good artistic balance * `--s 100`: Default value, good balance * `--s 200`: More artistic interpretation * `--s 250`: Strong artistic styling **High Stylize (300-1000):** Heavy artistic interpretation * `--s 500`: Very artistic, may deviate from prompt * `--s 750`: Extremely artistic * `--s 1000`: Maximum artistic interpretation, minimal prompt adherence ### Chaos Parameter Effects **Low Chaos (0-25):** Consistent, predictable results * `--c 0`: Default, very consistent results * `--c 15`: Slight variation * `--c 25`: Moderate variation while staying on-theme **High Chaos (50-100):** Unpredictable, varied results * `--c 50`: Significant variation * `--c 75`: High variation, experimental * `--c 100`: Maximum chaos, very unpredictable results ### Quality Parameter Impact * `--q 0.25`: 4x faster, lower detail (draft quality) * `--q 0.5`: 2x faster, moderate detail * `--q 1`: Default quality and speed * `--q 2`: 2x slower, maximum detail (only v4+) ### Weird Parameter Effects **Subtle Weird (0-250):** Slight oddness * `--w 0`: Default, no weirdness * `--w 100`: Slightly unusual elements * `--w 250`: Noticeable strange elements **Strong Weird (500-1500):** Significant strangeness * `--w 750`: Very unusual and surreal * `--w 1500`: Extremely weird and abstract **Maximum Weird (2000-3000):** Extreme experimental results * `--w 2500`: Highly abstract and bizarre * `--w 3000`: Maximum weirdness, often unrecognizable ### Seed Parameter Usage Seeds are useful for: * **Consistency**: Same seed + prompt = similar results * **Variations**: Change other parameters while keeping seed * **Experimentation**: Test different prompts with same seed * **Reproducibility**: Share exact results with others **Important Notes:** * Seeds only work with same model version * Different aspect ratios may produce different results even with same seed * Seeds from older model versions won't work with newer versions ## Parameter Combination Suggestions * **High Quality Detailed Images**: `--quality 1 --stylize 250 --chaos 10` * **Creative Experimentation**: `--chaos 75 --stylize 50 --weird 500` * **Character Consistency**: `--cref [character image] --seed [fixed value] --chaos 0` * **Style Matching**: `--sref [style image] --stylize 100 --iw 1.5` * **Realistic Photography**: `--stylize 50 --quality 1 --raw` * **Abstract Art**: `--stylize 750 --weird 1000 --chaos 80` * **Anime/Manga Style**: `--niji 6 --stylize 200 --quality 1` * **Multiple Variations**: `--chaos 25 --stylize 150` ## Current Limitations The API currently does **not** support the following parameters for **image generation**: * `--repeat` parameter * `--bs`, `--batchsize` parameter (only supported in video functions with values \[1,2,4]) * `--personalize` parameter * `{}` prompt variation syntax * `--stealth`/`--public` parameters * `--video` parameter (use video-specific endpoints instead) ## Object Reference (--oref) - V7 Update Object Reference allows you to reference an object from another image in your generation. ### Usage Add the `--oref` parameter at the end of your prompt, followed by your image URL. You can only use one image in object reference. **Example:** ``` A small duck holding a magic wand --oref http://image.png ``` ### Important Limitations (V7) * **Incompatible with V6.1 features**: Object reference is incompatible with features that still use V6.1 (such as inpainting or outpainting) * **Double GPU consumption**: Using object reference consumes 2x GPU time compared to regular V7 images * **Editing incompatibility**: Object reference images are currently incompatible with regional inpainting, pan, or outpaint. To edit these images, use the Edit interface and remove image references along with any `--oref` or `--ow` parameters * **Speed mode incompatibility**: Object reference is currently incompatible with speed modes or `--q 4` ## Important Usage Requirements * **When using enhance**: The original job must be created in draft mode with parameters `--v7 --draft` * **Draft mode**: Ultra-fast image prototyping (10x faster than normal mode) with slightly reduced quality but consuming only half the GPU resources. Use `--draft` parameter to activate. ## Supported Speed Modes Speed modes control the GPU type used for task execution, determining task execution time. The API provides **fast mode** and **turbo mode**, with **relax mode** currently not supported. ### Fast Mode (`--fast`) Fast mode is the default GPU speed mode where API requests are prioritized using GPU resources for processing. Usually completes image generation within 1 minute. * **Usage**: Activated with `--fast` parameter * **Default**: Used when no speed mode is specified * **Processing Time**: Typically under 1 minute for standard images ### Turbo Mode (`--turbo`) Turbo mode uses a high-performance GPU pool with processing speeds up to 4x faster than fast mode. This mode consumes double the GPU time quota and only supports v5 and above versions. * **Usage**: Activated with `--turbo` parameter * **Speed**: Up to 4x faster than fast mode * **Requirements**: Only supports v5+ versions * **Cost**: Consumes double GPU time quota * **Status**: Experimental feature - availability and billing may change ## Prompt Best Practices ### Effective Prompt Structure 1. **Subject**: What you want to see (e.g., "portrait of a woman") 2. **Style/Medium**: Art style or medium (e.g., "oil painting", "digital art") 3. **Details**: Specific details (e.g., "blue eyes, flowing hair") 4. **Environment**: Setting or background (e.g., "in a garden", "studio lighting") 5. **Parameters**: Add parameters at the end **Example:** ``` Portrait of an elderly wizard, oil painting style, long white beard, wise eyes, wearing purple robes, mystical library background --ar 2:3 --stylize 200 --quality 1 ``` ### Parameter Order Recommendations Place parameters in this order for best results: 1. Aspect ratio (`--ar`) 2. Quality (`--quality`) 3. Stylize (`--stylize`) 4. Chaos (`--chaos`) 5. Weird (`--weird`) 6. Speed mode (`--fast`, `--turbo`) 7. Model version (`--v`, `--niji`) 8. Special modes (`--raw`, `--tile`, `--draft`) ### Common Mistakes to Avoid * **Too many conflicting parameters**: Keep combinations logical * **Extreme parameter values**: Start with moderate values and adjust * **Inconsistent aspect ratios**: Choose ratios that match your intended use * **Overuse of chaos**: High chaos can make results unpredictable * **Wrong model versions**: Use appropriate version for your style needs