drawhisper/illustrious-xl

Public

2 runs

Run drawhisper/illustrious-xl with an API

Use one of our client libraries to get started quickly. Clicking on a library will take you to the Playground tab where you can tweak different inputs, see the results, and copy the corresponding code to use in your own project.

Input schema

The fields you can use to run this model with an API. If you don't give a value for a field its default value will be used.

Field	Type	Default value	Description
prompt	string	An astronaut riding a rainbow unicorn	Text prompt for image generation
num_outputs	integer	1 Min: 1 Max: 4	Number of images to generate
aspect_ratio	None	1:1	Aspect ratio for the generated image
output_format	None	webp	Output image format
output_quality	integer	80 Max: 100	Output image quality (0-100, only for JPEG)
image	string		Input image for image-to-image mode (supports PNG, JPG, WEBP).
prompt_strength	number	0.8 Max: 1	Prompt strength when using img2img. 1.0 corresponds to full destruction of information in image
seed	integer		Random seed. Set for reproducible generation
go_fast	boolean	False	Run faster predictions with reduced quality
guidance	number	7.5 Min: 1 Max: 20	Guidance for generated image. Lower values can give more realistic images. Good values to try are 2, 2.5, 3 and 3.5
megapixels	None	1	Approximate number of megapixels for generated image
num_inference_steps	integer	28 Min: 1 Max: 50	Number of denoising steps. More steps generally give better quality but take longer
disable_safety_checker	boolean	False	Disable safety checker for generated images
lora_weights	string		Primary LoRA weights. Supports Replicate models (owner/model), HuggingFace (huggingface.co/owner/model), CivitAI (civitai.com/models/id), and direct URLs
lora_scale	number	1 Min: -1 Max: 3	Primary LoRA scale/strength
extra_lora	string		Secondary LoRA weights. Allows combining two LoRAs simultaneously
extra_lora_scale	number	1 Min: -1 Max: 3	Secondary LoRA scale/strength
hf_api_token	string		HuggingFace API token for private models
civitai_api_token	string		CivitAI API token for private models
negative_prompt	string		Negative prompt - what you don't want in the image
scheduler	None	K_EULER	Sampling scheduler algorithm
cfg_scale	number	7.5 Min: 1 Max: 20	Classifier-free guidance scale (same as guidance, kept for SDXL compatibility)
clip_skip	integer	0 Max: 2	Number of CLIP layers to skip (advanced parameter)
refine	None	no_refiner	Which refine style to use
high_noise_frac	number	0.8 Max: 1	For expert_ensemble_refiner, the fraction of noise to use
refine_steps	integer		For base_image_refiner, the number of steps to refine
apply_watermark	boolean	False	Apply watermark to generated images
use_standard_sdxl	boolean	False	Use standard SDXL instead of Illustrious XL (for realistic content)

{
  "type": "object",
  "title": "Input",
  "properties": {
    "seed": {
      "type": "integer",
      "title": "Seed",
      "x-order": 7,
      "description": "Random seed. Set for reproducible generation"
    },
    "image": {
      "type": "string",
      "title": "Image",
      "format": "uri",
      "x-order": 5,
      "nullable": true,
      "description": "Input image for image-to-image mode (supports PNG, JPG, WEBP)."
    },
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "default": "An astronaut riding a rainbow unicorn",
      "x-order": 0,
      "description": "Text prompt for image generation"
    },
    "refine": {
      "enum": [
        "no_refiner",
        "expert_ensemble_refiner",
        "base_image_refiner"
      ],
      "type": "string",
      "title": "refine",
      "description": "Which refine style to use",
      "default": "no_refiner",
      "x-order": 23
    },
    "go_fast": {
      "type": "boolean",
      "title": "Go Fast",
      "default": false,
      "x-order": 8,
      "description": "Run faster predictions with reduced quality"
    },
    "guidance": {
      "type": "number",
      "title": "Guidance",
      "default": 7.5,
      "maximum": 20,
      "minimum": 1,
      "x-order": 9,
      "description": "Guidance for generated image. Lower values can give more realistic images. Good values to try are 2, 2.5, 3 and 3.5"
    },
    "cfg_scale": {
      "type": "number",
      "title": "Cfg Scale",
      "default": 7.5,
      "maximum": 20,
      "minimum": 1,
      "x-order": 21,
      "description": "Classifier-free guidance scale (same as guidance, kept for SDXL compatibility)"
    },
    "clip_skip": {
      "type": "integer",
      "title": "Clip Skip",
      "default": 0,
      "maximum": 2,
      "minimum": 0,
      "x-order": 22,
      "description": "Number of CLIP layers to skip (advanced parameter)"
    },
    "scheduler": {
      "enum": [
        "DDIM",
        "DPMSolverMultistep",
        "HeunDiscrete",
        "KarrasDPM",
        "K_EULER_ANCESTRAL",
        "K_EULER",
        "PNDM"
      ],
      "type": "string",
      "title": "scheduler",
      "description": "Sampling scheduler algorithm",
      "default": "K_EULER",
      "x-order": 20
    },
    "extra_lora": {
      "type": "string",
      "title": "Extra Lora",
      "x-order": 15,
      "description": "Secondary LoRA weights. Allows combining two LoRAs simultaneously"
    },
    "lora_scale": {
      "type": "number",
      "title": "Lora Scale",
      "default": 1,
      "maximum": 3,
      "minimum": -1,
      "x-order": 14,
      "description": "Primary LoRA scale/strength"
    },
    "megapixels": {
      "enum": [
        "0.25",
        "0.5",
        "1",
        "2"
      ],
      "type": "string",
      "title": "megapixels",
      "description": "Approximate number of megapixels for generated image",
      "default": "1",
      "x-order": 10
    },
    "num_outputs": {
      "type": "integer",
      "title": "Num Outputs",
      "default": 1,
      "maximum": 4,
      "minimum": 1,
      "x-order": 1,
      "description": "Number of images to generate"
    },
    "aspect_ratio": {
      "enum": [
        "1:1",
        "2:3",
        "3:2",
        "4:3",
        "3:4",
        "4:5",
        "5:4",
        "16:9",
        "9:16"
      ],
      "type": "string",
      "title": "aspect_ratio",
      "description": "Aspect ratio for the generated image",
      "default": "1:1",
      "x-order": 2
    },
    "hf_api_token": {
      "type": "string",
      "title": "Hf Api Token",
      "x-order": 17,
      "description": "HuggingFace API token for private models"
    },
    "lora_weights": {
      "type": "string",
      "title": "Lora Weights",
      "x-order": 13,
      "description": "Primary LoRA weights. Supports Replicate models (owner/model), HuggingFace (huggingface.co/owner/model), CivitAI (civitai.com/models/id), and direct URLs"
    },
    "refine_steps": {
      "type": "integer",
      "title": "Refine Steps",
      "x-order": 25,
      "description": "For base_image_refiner, the number of steps to refine"
    },
    "output_format": {
      "enum": [
        "webp",
        "png",
        "jpg"
      ],
      "type": "string",
      "title": "output_format",
      "description": "Output image format",
      "default": "webp",
      "x-order": 3
    },
    "output_quality": {
      "type": "integer",
      "title": "Output Quality",
      "default": 80,
      "maximum": 100,
      "minimum": 0,
      "x-order": 4,
      "description": "Output image quality (0-100, only for JPEG)"
    },
    "apply_watermark": {
      "type": "boolean",
      "title": "Apply Watermark",
      "default": false,
      "x-order": 26,
      "description": "Apply watermark to generated images"
    },
    "high_noise_frac": {
      "type": "number",
      "title": "High Noise Frac",
      "default": 0.8,
      "maximum": 1,
      "minimum": 0,
      "x-order": 24,
      "description": "For expert_ensemble_refiner, the fraction of noise to use"
    },
    "negative_prompt": {
      "type": "string",
      "title": "Negative Prompt",
      "default": "",
      "x-order": 19,
      "description": "Negative prompt - what you don't want in the image"
    },
    "prompt_strength": {
      "type": "number",
      "title": "Prompt Strength",
      "default": 0.8,
      "maximum": 1,
      "minimum": 0,
      "x-order": 6,
      "description": "Prompt strength when using img2img. 1.0 corresponds to full destruction of information in image"
    },
    "extra_lora_scale": {
      "type": "number",
      "title": "Extra Lora Scale",
      "default": 1,
      "maximum": 3,
      "minimum": -1,
      "x-order": 16,
      "description": "Secondary LoRA scale/strength"
    },
    "civitai_api_token": {
      "type": "string",
      "title": "Civitai Api Token",
      "x-order": 18,
      "description": "CivitAI API token for private models"
    },
    "use_standard_sdxl": {
      "type": "boolean",
      "title": "Use Standard Sdxl",
      "default": false,
      "x-order": 27,
      "description": "Use standard SDXL instead of Illustrious XL (for realistic content)"
    },
    "num_inference_steps": {
      "type": "integer",
      "title": "Num Inference Steps",
      "default": 28,
      "maximum": 50,
      "minimum": 1,
      "x-order": 11,
      "description": "Number of denoising steps. More steps generally give better quality but take longer"
    },
    "disable_safety_checker": {
      "type": "boolean",
      "title": "Disable Safety Checker",
      "default": false,
      "x-order": 12,
      "description": "Disable safety checker for generated images"
    }
  }
}

Output schema

The shape of the response you’ll get when you run this model with an API.

Schema

{
  "type": "array",
  "items": {
    "type": "string",
    "format": "uri"
  },
  "title": "Output"
}