Skip to main content
Control various parameter settings for image generation to help you create ideal image effects.

Image Generation Parameter List

ParameterFormatValues/RangeDescription
Aspect Ratio--aspect, --arAny ratio (e.g. 16:9, 2:3)Images are initially square, but you can use the aspect ratio parameter to change this
Chaos--chaos, --c0-100 (default: 0)Use the chaos parameter to add variety to your image results. Higher values create more unusual results
Character Reference--crefImage URLWant to use the same character across multiple images and scenes? You can provide character reference!
Negative Prompt--noText descriptionUse the negative parameter to tell what you don’t want to see in the image
Quality--quality, --q0.25, 0.5, 1, 2 (default: 1)Use the quality parameter to control image detail and processing time. Higher values = more detail, longer time
Seed--seed0-4294967295Use the seed parameter for testing and experimentation. Same seed with same prompt = consistent results
Stop--stop10-100 (default: 100)Need a softer, more unique look? Use the stop parameter to finish images halfway through the process
Raw Mode--rawNo valueUse raw mode to get more control over your images, reduces default aesthetic styling
Stylize--stylize, --s0-1000 (default: 100)Use the stylize parameter to control artistic style in images. Lower = more prompt-focused, Higher = more artistic
Style Reference--srefImage URLWant to match the look and feel of another image? You can provide style reference!
Object Reference--orefImage URLReference an object from another image. Only one image can be used in object reference
Tile--tileNo valueUse the tile parameter to create seamless tiled images for patterns and textures
Version--version, --v1-7 (current: 7)Use version parameter to explore and switch between different model versions
Draft--draftNo valueGenerate draft images using half GPU power in V7 and above for rapid prototyping
Weird--weird, --w0-3000 (default: 0)Use the weird parameter to make your images strange and unconventional
Fast--fastNo valueSwitch your GPU speed to fast mode (default processing speed)
Image Weight--iw0-3 (default: 1)Control the influence of image prompts. Higher values make image prompts more influential
Relax--relaxNo valueSwitch your GPU speed to relax mode (slower but uses less quota)
Turbo--turboNo valueSwitch your GPU speed to turbo mode (4x faster, double cost, v5+ only)
Niji--niji5, 6 (current: 6)Use our focused anime and East Asian aesthetic model
Experimental--expNo valueControl the aesthetic effects of image generation with experimental features
Motion--motion1-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
I