---
title: Stable Diffusion XL v1.0 VAE Fix | Runware Docs
url: https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix
description: Native 1024px SDXL generation with a corrected VAE for more reliable text-to-image and image-to-image workflows
---
# Stable Diffusion XL v1.0 VAE Fix

![Stable Diffusion XL v1.0 VAE Fix](https://assets.runware.ai/covers/stabilityai-stable-diffusion-xl-v1-0-vae-fix.jpg)

Stable Diffusion XL v1.0 VAE Fix is the SDXL 1.0 base checkpoint packaged with a corrected VAE for more stable inference. It keeps SDXL's strong prompt understanding, broad visual range, native 1024x1024 generation, and support for both text-to-image and image-to-image workflows, while reducing the artifact and decoding issues associated with the original embedded VAE.

- **Status**: live
- **ID**: `civitai:101055@128078`
- Try in Playground
- **Creator**: Stability AI
- **Release Date**: July 28, 2023
- **Zero Data Retention**: Yes
- **Capabilities**: Text to Image, Image to Image, Checkpoint

## Pricing

$0.0015 from, per run · ~4s per request

**Measured runs**

- 512×512 · steps 20: `$0.0015` (~2s)
- 1024×1024 · steps 20: `$0.003` (~2s)
- 1024×1024 · steps 50: `$0.0045` (~4s)
- 2048×2048 · steps 20: `$0.0179` (~13s)

**4 example generations**

- [image-to-image](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix/examples#example-urban-wildlife-officer-persona-portrait) · 832×1216 · steps 30: `$0.0013` (~4s)
- [text-to-image](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix/examples#example-marine-water-tester-lifestyle-photograph) · 1216×832 · steps 28: `$0.0013` (~4s)
- [expand](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix/examples#example-rare-book-conservator-headshot) · 1152×768 · steps 30: `$0.0013` (~5s)
- [inpaint](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix/examples#example-polar-biobank-badge-logo) · 1024×1024 · steps 32: `$0.0019` (~6s)

billed by compute time, so a request costs what it took · times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

When `strength` or `inputs.maskImage` is provided, `inputs.seedImage` is required.

---

`width` and `height` must be used together.

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Image output type.

**Allowed values**: `URL` `base64Data` `dataURI`

### [outputFormat](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-outputformat)

- **Type**: `string`
- **Default**: `JPG`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`JPG\`: Best for photorealistic images with smaller file sizes (no transparency).
- \`PNG\`: Lossless compression, supports high quality and transparency (alpha channel).
- \`WEBP\`: Modern format providing superior compression and transparency support.

> [!NOTE]
> \*\*Transparency\*\*: If you are using features like background removal or LayerDiffuse that require transparency, you must select a format that supports an alpha channel (e.g., \`PNG\`, \`WEBP\`, \`TIFF\`). \`JPG\` does not support transparency.

**Allowed values**: `JPG` `PNG` `WEBP`

### [outputQuality](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses 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.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (1 property)`

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`

Enable or disable content safety checking. Increases total generation time and adds a small charge on top of the generation cost.

### [ttl](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `20`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

### [acceleratorOptions](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions)

- **Path**: `acceleratorOptions.cacheEndStep`
- **Type**: `object (10 properties)`

Advanced caching mechanisms to speed up generation.

#### [cacheEndStep](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions-cacheendstep)

- **Path**: `acceleratorOptions.cacheEndStep`
- **Type**: `integer`
- **Min**: `1`

Absolute step number to end caching. Must be greater than `cacheStartStep` and less than or equal to `steps`.

#### [cacheEndStepPercentage](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions-cacheendsteppercentage)

- **Path**: `acceleratorOptions.cacheEndStepPercentage`
- **Type**: `integer`
- **Min**: `1`
- **Max**: `100`

Percentage of steps to end caching. Alternative to `cacheEndStep`. Must be greater than `cacheStartStepPercentage`.

#### [cacheMaxConsecutiveSteps](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions-cachemaxconsecutivesteps)

- **Path**: `acceleratorOptions.cacheMaxConsecutiveSteps`
- **Type**: `integer`
- **Min**: `1`
- **Max**: `5`
- **Default**: `3`

Limits the maximum number of consecutive steps that can use cached computations before forcing a fresh computation.

#### [cacheStartStep](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions-cachestartstep)

- **Path**: `acceleratorOptions.cacheStartStep`
- **Type**: `integer`
- **Min**: `0`

Absolute step number to start caching. Must be less than `cacheEndStep`.

#### [cacheStartStepPercentage](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions-cachestartsteppercentage)

- **Path**: `acceleratorOptions.cacheStartStepPercentage`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `99`

Percentage of steps to start caching. Alternative to `cacheStartStep`. Must be less than `cacheEndStepPercentage`.

#### [teaCache](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions-teacache)

- **Path**: `acceleratorOptions.teaCache`
- **Type**: `boolean`

TeaCache acceleration for transformer-based models. Estimates step differences to skip redundant computations.

#### [teaCacheDistance](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions-teacachedistance)

- **Path**: `acceleratorOptions.teaCacheDistance`
- **Type**: `float`
- **Min**: `0`
- **Max**: `1`
- **Step**: `0.01`
- **Default**: `0.5`

Controls the aggressiveness of the TeaCache feature. Lower values prioritize quality, higher values prioritize speed.

#### [deepCache](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions-deepcache)

- **Path**: `acceleratorOptions.deepCache`
- **Type**: `boolean`

DeepCache acceleration. Skips transformer computations in certain steps to speed up generation.

#### [deepCacheInterval](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions-deepcacheinterval)

- **Path**: `acceleratorOptions.deepCacheInterval`
- **Type**: `integer`
- **Min**: `1`

Interval for DeepCache acceleration. A value of 2 skips every other step, 3 skips two out of three, etc.

#### [deepCacheBranchId](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-acceleratoroptions-deepcachebranchid)

- **Path**: `acceleratorOptions.deepCacheBranchId`
- **Type**: `integer`
- **Min**: `0`

Branch ID for DeepCache acceleration. Determines which U-Net layers are skipped.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [seedImage](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-inputs-seedimage)

- **Path**: `inputs.seedImage`
- **Type**: `string`

Image used as a starting point for the generation (UUID, URL, Data URI, or Base64).

**Learn more** (3 resources):

- [Image To Image: Seed Image The Foundation](https://runware.ai/docs/learn/image-to-image#seed-image-the-foundation) (learn)
- [Image Inpainting: Seed And Mask Image The Foundation](https://runware.ai/docs/learn/image-inpainting#seed-and-mask-image-the-foundation) (learn)
- [Image Outpainting: Seed Image The Starting Point](https://runware.ai/docs/learn/image-outpainting#seed-image-the-starting-point) (learn)

### [maskImage](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-inputs-maskimage)

- **Path**: `inputs.maskImage`
- **Type**: `string`

Image used to specify which areas of the input image should be edited (UUID, URL, Data URI, or Base64). White marks the area to edit, black is preserved.

**Learn more** (1 resource):

- [Image Inpainting: Seed And Mask Image The Foundation](https://runware.ai/docs/learn/image-inpainting#seed-and-mask-image-the-foundation) (learn)

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `civitai:101055@128078`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `2`
- **Max**: `3000`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [negativePrompt](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-negativeprompt)

- **Type**: `string`
- **Min**: `2`
- **Max**: `3000`

Prompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1).

**Learn more** (1 resource):

- [Prompts: Negative Prompts](https://runware.ai/docs/learn/prompts#negative-prompts) (learn)

### [width](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-width)

- **Type**: `integer`
- **Required**: true
- **Min**: `128`
- **Max**: `2048`
- **Step**: `8`
- **Default**: `1024`

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [height](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-height)

- **Type**: `integer`
- **Required**: true
- **Min**: `128`
- **Max**: `2048`
- **Step**: `8`
- **Default**: `1024`

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [seed](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-seed)

- **Type**: `integer`
- **Min**: `0`
- **Max**: `9223372036854776000`

Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

**Learn more** (1 resource):

- [Seed](https://runware.ai/docs/learn/seed) (learn)

### [steps](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-steps)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `100`
- **Default**: `20`

Total number of denoising steps. Higher values generally produce more detailed results but take longer.

**Learn more** (1 resource):

- [Steps](https://runware.ai/docs/learn/steps) (learn)

### [scheduler](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-scheduler)

- **Type**: `string`

Scheduler to use for the diffusion process.

**Allowed values**: `DDIM` `DDIMScheduler` `DDPMScheduler` `DEISMultistepScheduler` `Default` `DPM++` `DPM++ 2M` `DPM++ 2M Beta` `DPM++ 2M Exponential` `DPM++ 2M Karras` `DPM++ 2M SDE` `DPM++ 2M SDE Beta` `DPM++ 2M SDE Exponential` `DPM++ 2M SDE Karras` `DPM++ 2M SDE Uniform` `DPM++ 2M Uniform` `DPM++ 3M` `DPM++ 3M Beta` `DPM++ 3M Exponential` `DPM++ 3M Karras` `DPM++ 3M SDE Uniform` `DPM++ 3M Uniform` `DPM++ Beta` `DPM++ Exponential` `DPM++ Karras` `DPM++ SDE` `DPM++ SDE Beta` `DPM++ SDE Exponential` `DPM++ SDE Karras` `DPM++ Uniform` `DPM++ Uniform Beta` `DPM++ Uniform Exponential` `DPM++ Uniform Karras` `DPMSolverMultistepInverse` `DPMSolverMultistepScheduler` `DPMSolverSinglestepScheduler` `EDMDPMSolverMultistepScheduler` `EDMEulerScheduler` `Euler` `Euler a` `Euler Beta` `Euler Exponential` `Euler Karras` `EulerAncestralDiscreteScheduler` `EulerDiscreteScheduler` `FlowMatchEulerDiscreteScheduler` `Heun` `HeunDiscreteScheduler` `Heun Karras` `IPNDMScheduler` `IPNDM Uniform` `IPNDM Uniform Beta` `IPNDM Uniform Exponential` `IPNDM Uniform Karras` `KDPM2AncestralDiscreteScheduler` `KDPM2DiscreteScheduler` `LCM` `LCMScheduler` `LMS` `LMSDiscreteScheduler` `LMS Karras` `PNDMScheduler` `TCDScheduler` `UniPC` `UniPC 2M` `UniPC 2M Karras` `UniPC 2M Uniform` `UniPC 3M` `UniPC 3M Karras` `UniPC 3M Uniform` `UniPC Karras` `UniPC Uniform` `UniPC Uniform Beta` `UniPC Uniform Exponential` `UniPC Uniform Karras`

**Learn more** (2 resources):

- [Schedulers](https://runware.ai/docs/learn/schedulers) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [CFGScale](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-cfgscale)

- **Type**: `float`
- **Min**: `0`
- **Max**: `50`
- **Step**: `0.01`

Guidance scale representing how closely the output will resemble the prompt. Higher values produce results more aligned with the prompt.

**Learn more** (1 resource):

- [Cfg Scale](https://runware.ai/docs/learn/cfg-scale) (learn)

### [strength](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-strength)

- **Type**: `float`
- **Min**: `0`
- **Max**: `1`
- **Step**: `0.01`
- **Default**: `0.8`

Strength of the transformation. Lower values result in more influence from the original input.

**Learn more** (3 resources):

- [Image To Image: Strength The Transformation Intensity](https://runware.ai/docs/learn/image-to-image#strength-the-transformation-intensity) (learn)
- [Image Inpainting: Strength Controlling Transformation Intensity](https://runware.ai/docs/learn/image-inpainting#strength-controlling-transformation-intensity) (learn)
- [Image Outpainting: Strength Understanding The Critical Threshold](https://runware.ai/docs/learn/image-outpainting#strength-understanding-the-critical-threshold) (learn)

### [maskMargin](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-maskmargin)

- **Type**: `integer`
- **Min**: `32`
- **Max**: `128`

Extra context pixels around the masked region during inpainting. The model zooms into the masked area with these additional pixels for better integration.

**Learn more** (1 resource):

- [Image Inpainting: Mask Margin Enhancing Detail](https://runware.ai/docs/learn/image-inpainting#mask-margin-enhancing-detail) (learn)

### [clipSkip](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-clipskip)

- **Type**: `integer`
- **Min**: `0`
- **Max**: `4`

Number of layers to skip in the CLIP model.

**Learn more** (2 resources):

- [Clip Skip](https://runware.ai/docs/learn/clip-skip) (learn)
- [Custom Stickers: Clip Skip](https://runware.ai/docs/models/sdxl/guides/custom-stickers#clip-skip) (learn)

### [vae](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-vae)

- **Type**: `string`

VAE model identifier. Overrides the default VAE included with the base model.

**Learn more** (1 resource):

- [Vae](https://runware.ai/docs/learn/vae) (learn)

### [promptWeighting](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-promptweighting)

- **Type**: `string`

Defines the syntax to be used for prompt weighting.

Prompt weighting allows you to adjust how strongly different parts of your prompt influence the generated image. Choose between `compel` notation with advanced weighting operations or `sdEmbeds` for simple emphasis adjustments.

**Compel syntax**:

Adds 0.2 seconds to image inference time and incurs additional costs.

When `compel` syntax is selected, you can use the following notation in prompts:

**Weighting**

Syntax: `+` `-` `(word)0.9`

Increase or decrease the attention given to specific words or phrases.

Examples:

- Single words: `small+ dog, pixar style`
- Multiple words: `small dog, (pixar style)-`
- Multiple symbols for more effect: `small+++ dog, pixar style`
- Nested weighting: `(small+ dog)++, pixar style`
- Explicit weight percentage: `small dog, (pixar)1.2 style`

**Blend**

Syntax: `.blend()`

Merge multiple conditioning prompts.

Example: `("small dog", "robot").blend(1, 0.8)`

**Conjunction**

Syntax: `.and()`

Break a prompt into multiple clauses and pass them separately.

Example: `("small dog", "pixar style").and()`

**SdEmbeds syntax**:

When `sdEmbeds` syntax is selected, you can use the following notation in prompts:

**Weighting**

Syntax: `(text)` `(text:number)` `[text]`

Use parentheses `()` to increase attention, square brackets `[]` to decrease it. Add a number after the text to specify a custom multiplier.

Examples:

- Single words: `(small) dog, pixar style`
- Multiple words: `small dog, [pixar style]`
- Higher emphasis: `(small:2.5) dog, pixar style`
- Combined emphasis: `(small dog:1.5), pixar style`

**Allowed values**: `compel` `sdEmbeds`

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [outpaint](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-outpaint)

- **Path**: `outpaint.top`
- **Type**: `object (5 properties)`

Pixel extensions for each boundary direction of the source image. At least one direction is required.

**Learn more** (1 resource):

- [Image Outpainting: Outpaint Defining The Expansion](https://runware.ai/docs/learn/image-outpainting#outpaint-defining-the-expansion) (learn)

#### [top](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-outpaint-top)

- **Path**: `outpaint.top`
- **Type**: `integer`
- **Min**: `0`
- **Step**: `64`

Number of pixels to extend to the top.

#### [bottom](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-outpaint-bottom)

- **Path**: `outpaint.bottom`
- **Type**: `integer`
- **Min**: `0`
- **Step**: `64`

Number of pixels to extend to the bottom.

#### [left](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-outpaint-left)

- **Path**: `outpaint.left`
- **Type**: `integer`
- **Min**: `0`
- **Step**: `64`

Number of pixels to extend to the left.

#### [right](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-outpaint-right)

- **Path**: `outpaint.right`
- **Type**: `integer`
- **Min**: `0`
- **Step**: `64`

Number of pixels to extend to the right.

#### [blur](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-outpaint-blur)

- **Path**: `outpaint.blur`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `32`

Amount of blur to apply to the mask edge.

**Learn more** (1 resource):

- [Image Outpainting: Outpaint Defining The Expansion](https://runware.ai/docs/learn/image-outpainting#outpaint-defining-the-expansion) (learn)

### [lora](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-lora)

- **Path**: `lora.model`
- **Type**: `array of objects (2 properties)`
- **Min items**: `1`

With LoRA (Low-Rank Adaptation), you can adapt a model to specific styles or features by emphasizing particular aspects of the data. This technique enhances the quality and relevance of generated content and can be especially useful when the output needs to adhere to a specific artistic style or follow particular guidelines.

Multiple LoRA models can be used simultaneously to achieve different adaptation goals.

**Examples**:

```json
"lora": [
  {
    "model": "<lora-model-air>",
    "weight": 0.8
  }
]
```

**Learn more** (1 resource):

- [Loras](https://runware.ai/docs/learn/loras) (learn)

#### [model](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-lora-model)

- **Path**: `lora.model`
- **Type**: `string`
- **Required**: true

LoRA model identifier.

#### [weight](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-lora-weight)

- **Path**: `lora.weight`
- **Type**: `float`
- **Min**: `-4`
- **Max**: `4`
- **Step**: `0.01`
- **Default**: `1`

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.

### [controlNet](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-controlnet)

- **Path**: `controlNet.model`
- **Type**: `array of objects (8 properties)`
- **Min items**: `1`

With ControlNet, you can provide a guide image to help the model generate images that align with the desired structure. This guide image can be generated with our ControlNet preprocessing tool, extracting guidance information from an input image. The guide image can be in the form of an edge map, a pose, a depth estimation or any other type of control image that guides the generation process via the ControlNet model.

Multiple ControlNet models can be used at the same time to provide different types of guidance information to the model.

**Examples**:

```json
"controlNet": [
  {
    "model": "<controlnet-model-air>",
    "guideImage": "c64351d5-4c59-42f7-95e1-eace013eddab",
    "weight": 0.7,
    "startStep": 0,
    "endStep": 20,
    "controlMode": "controlnet"
  }
]
```

**Learn more** (2 resources):

- [Game Assets Canny: Controlnet And Edge Detection](https://runware.ai/docs/models/flux-1-dev/guides/game-assets-canny#controlnet-and-edge-detection) (learn)
- [Controlnet](https://runware.ai/docs/learn/controlnet) (learn)

#### [model](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-controlnet-model)

- **Path**: `controlNet.model`
- **Type**: `string`
- **Required**: true

ControlNet model identifier.

**Allowed values**: `runware:20@1` `runware:3@1`

#### [weight](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-controlnet-weight)

- **Path**: `controlNet.weight`
- **Type**: `float`
- **Min**: `-4`
- **Max**: `4`
- **Step**: `0.01`
- **Default**: `1`

Strength of the ControlNet influence. A value of 0 means no influence. Higher values increase the influence, and negative values can be used to steer away from the guide image.

#### [guideImage](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-controlnet-guideimage)

- **Path**: `controlNet.guideImage`
- **Type**: `string`
- **Required**: true

Reference image for ControlNet guidance (UUID, URL, Data URI, or Base64).

#### [controlMode](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-controlnet-controlmode)

- **Path**: `controlNet.controlMode`
- **Type**: `string`
- **Default**: `balanced`

ControlNet guidance mode.

**Allowed values**:

- `balanced` Equal weight between ControlNet and prompt.
- `controlnet` Prioritize ControlNet guidance.
- `prompt` Prioritize prompt guidance.

#### [endStep](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-controlnet-endstep)

- **Path**: `controlNet.endStep`
- **Type**: `integer`
- **Min**: `1`

Absolute step number to end ControlNet influence. Must be greater than `startStep` and less than or equal to `steps`.

#### [endStepPercentage](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-controlnet-endsteppercentage)

- **Path**: `controlNet.endStepPercentage`
- **Type**: `integer`
- **Min**: `1`
- **Max**: `100`

Percentage of steps to end ControlNet influence. Must be greater than `startStepPercentage`.

#### [startStep](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-controlnet-startstep)

- **Path**: `controlNet.startStep`
- **Type**: `integer`
- **Min**: `0`

Absolute step number to start ControlNet influence. Must be less than `endStep`.

#### [startStepPercentage](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-controlnet-startsteppercentage)

- **Path**: `controlNet.startStepPercentage`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `99`

Percentage of steps to start ControlNet influence. Must be less than `endStepPercentage`.

### [ipAdapters](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ipadapters)

- **Path**: `ipAdapters.model`
- **Type**: `array of objects (7 properties)`
- **Min items**: `1`

IP-Adapters enable image-prompted generation, allowing you to use reference images to guide the style and content of your generations. Multiple IP Adapters can be used simultaneously.

**Examples**:

```json
"ipAdapters": [
  {
    "model": "<ip-adapter-model-air>",
    "guideImages": ["c64351d5-4c59-42f7-95e1-eace013eddab"],
    "weight": 0.75
  },
  {
    "model": "<ip-adapter-model-air>",
    "guideImages": ["d7e8f9a0-2b5c-4e7f-a1d3-9c8b7a6e5d4f"],
    "weight": 0.5
  }
]
```

**Learn more** (1 resource):

- [Ip Adapters](https://runware.ai/docs/learn/ip-adapters) (learn)

#### [model](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ipadapters-model)

- **Path**: `ipAdapters.model`
- **Type**: `string`
- **Required**: true

We make use of the [AIR system](https://runware.ai/docs/models) to identify IP-Adapter models. This identifier is a unique string that represents a specific model.

**Supported models list**:

| AIR ID | Model Name |
| --- | --- |
| runware:55@1 | IP Adapter SDXL |
| runware:55@2 | IP Adapter SDXL Plus |
| runware:55@3 | IP Adapter SDXL Plus Face |
| runware:55@4 | IP Adapter SDXL Vit-H |
| runware:55@5 | IP Adapter SD 1.5 |
| runware:55@6 | IP Adapter SD 1.5 Plus |
| runware:55@7 | IP Adapter SD 1.5 Light |
| runware:55@8 | IP Adapter SD 1.5 Plus Face |
| runware:55@10 | IP Adapter SD 1.5 Vit-G |

**Allowed values**: `runware:55@1` `runware:55@2` `runware:55@3` `runware:55@4`

#### [weight](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ipadapters-weight)

- **Path**: `ipAdapters.weight`
- **Type**: `float`
- **Min**: `-4`
- **Max**: `4`
- **Step**: `0.01`
- **Default**: `1`

Strength of the IP-Adapter influence. A value of 0 means no influence. Higher values increase the influence, and negative values can be used to steer away from the reference.

#### [guideImages](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ipadapters-guideimages)

- **Path**: `ipAdapters.guideImages`
- **Type**: `array of strings`
- **Required**: true
- **Min items**: `1`

Images to guide the IP-Adapter (UUID, URL, Data URI, or Base64).

#### [weightType](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ipadapters-weighttype)

- **Path**: `ipAdapters.weightType`
- **Type**: `string`
- **Default**: `normal`

Shapes how influence evolves during generation.

**Allowed values**: `normal` `ease_in` `ease_out` `ease_in_out` `weak_input` `weak_output` `weak_middle` `strong_middle` `style_transfer` `composition` `strong_style_transfer` `style_and_composition` `strong_style_and_composition`

#### [weightComposition](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ipadapters-weightcomposition)

- **Path**: `ipAdapters.weightComposition`
- **Type**: `float`
- **Min**: `0`
- **Max**: `1`
- **Step**: `0.01`

Controls composition/layout influence specifically.

#### [embedScaling](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ipadapters-embedscaling)

- **Path**: `ipAdapters.embedScaling`
- **Type**: `string`
- **Default**: `kv`

Determines which embedding components are used and their strength.

**Allowed values**: `only_v` `kv` `kv_penalty_c` `k_mean_v_penalty_c`

#### [combineMethod](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ipadapters-combinemethod)

- **Path**: `ipAdapters.combineMethod`
- **Type**: `string`
- **Default**: `concat`

Controls how multiple reference images are combined.

**Allowed values**: `concat` `add` `subtract` `average` `norm_average`

### [refiner](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-refiner)

- **Path**: `refiner.model`
- **Type**: `object (3 properties)`

Refiner models help create higher quality image outputs by incorporating specialized models designed to enhance image details and overall coherence. This can be particularly useful when you need results with superior quality, photorealism, or specific aesthetic refinements. Note that refiner models are only SDXL based.

**Examples**:

```json
"refiner": {
  "model": "<refiner-model-air>",
  "startStep": 30
}
```

**Learn more** (1 resource):

- [Refiner](https://runware.ai/docs/models/sdxl/guides/refiner) (learn)

#### [model](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-refiner-model)

- **Path**: `refiner.model`
- **Type**: `string`
- **Required**: true

Refiner model identifier.

**Allowed values**: `runware:101055@128080`

#### [startStep](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-refiner-startstep)

- **Path**: `refiner.startStep`
- **Type**: `integer`
- **Min**: `1`

Absolute step number to switch from the base model to the refiner.

#### [startStepPercentage](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-refiner-startsteppercentage)

- **Path**: `refiner.startStepPercentage`
- **Type**: `integer`
- **Min**: `1`
- **Max**: `99`

Percentage of total steps at which to switch from the base model to the refiner.

### [embeddings](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-embeddings)

- **Path**: `embeddings.model`
- **Type**: `array of objects (2 properties)`
- **Min items**: `1`

Embeddings (or Textual Inversion) can be used to add specific concepts or styles to your generations. Multiple embeddings can be used at the same time.

**Examples**:

```json
"embeddings": [
  {
    "model": "<embedding-model-air>"
  }
]
```

**Learn more** (1 resource):

- [Embeddings](https://runware.ai/docs/learn/embeddings) (learn)

#### [model](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-embeddings-model)

- **Path**: `embeddings.model`
- **Type**: `string`
- **Required**: true

Textual Inversion (Embedding) model identifier.

#### [weight](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-embeddings-weight)

- **Path**: `embeddings.weight`
- **Type**: `float`
- **Min**: `-4`
- **Max**: `4`
- **Step**: `0.01`
- **Default**: `1`

Strength of the embedding influence.

**Features**

Standalone addons and post-processing features.

### [ultralytics](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ultralytics)

- **Path**: `ultralytics.CFGScale`
- **Type**: `object (9 properties)`

Configuration object for Ultralytics face enhancement during generation. This feature uses face detection and inpainting to improve facial details in the same generation step, without requiring post-processing.

> [!NOTE]
> Face enhancement is available for Stable Diffusion 1.X, SDXL, and FLUX models. The system automatically detects faces and applies targeted refinement to improve quality while maintaining consistency with the overall generation.

#### [CFGScale](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ultralytics-cfgscale)

- **Path**: `ultralytics.CFGScale`
- **Type**: `float`
- **Min**: `0`
- **Max**: `50`
- **Step**: `0.1`
- **Default**: `8`

Face refinement guidance scale.

#### [confidence](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ultralytics-confidence)

- **Path**: `ultralytics.confidence`
- **Type**: `float`
- **Min**: `0`
- **Max**: `1`
- **Step**: `0.01`
- **Default**: `0.9`

Confidence threshold for detection.

#### [inpaintSize](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ultralytics-inpaintsize)

- **Path**: `ultralytics.inpaintSize`
- **Type**: `integer`
- **Min**: `128`
- **Max**: `2048`
- **Default**: `1024`

Image size (in pixels) to use for each inpainting region. YOLO detects faces, crops the region, and scales it to this size before running diffusion. Set so most faces land in the 2–4× range of their original pixel size. Going beyond 8× may degrade identity resemblance.

#### [maskBlur](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ultralytics-maskblur)

- **Path**: `ultralytics.maskBlur`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `100`
- **Default**: `5`

Mask feathering amount. Higher values create softer transitions between the enhanced face region and surrounding areas.

#### [maskPadding](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ultralytics-maskpadding)

- **Path**: `ultralytics.maskPadding`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `20`
- **Default**: `5`

Padding around detected face in pixels. Expands the refinement area to include surrounding context like hair and neck.

#### [negativePrompt](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ultralytics-negativeprompt)

- **Path**: `ultralytics.negativePrompt`
- **Type**: `string`

Negative prompt for detection.

#### [positivePrompt](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ultralytics-positiveprompt)

- **Path**: `ultralytics.positivePrompt`
- **Type**: `string`

Positive prompt for detection.

#### [steps](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ultralytics-steps)

- **Path**: `ultralytics.steps`
- **Type**: `integer`
- **Min**: `1`
- **Max**: `100`
- **Default**: `20`

Number of face refinement steps.

#### [strength](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-ultralytics-strength)

- **Path**: `ultralytics.strength`
- **Type**: `float`
- **Max**: `1`
- **Step**: `0.01`
- **Default**: `0.3`

Refinement strength. Lower values preserve more of the original, higher values allow more aggressive reconstruction.

### [hiresFix](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-hiresfix)

- **Type**: `boolean | object`

Two-stage generation for improved resolution and detail. The model generates at a lower resolution first, then upscales and refines the result in a second pass. Can be enabled with `true` for default settings, or configured as an object for fine-grained control over the upscaling model, steps, and strength.

When using the object form, the `model` parameter is required. Available upscaling models:

| Model | Name | Upscale Factor |
| --- | --- | --- |
| `runware:504@1` | RealESRGAN\_x4plus | 4x |
| `runware:realesrgan@anime-6b` | RealESRGAN\_x4plus\_anime\_6B | 4x |
| `runware:esrgan@animesharp` | 4x-AnimeSharp | 4x |
| `runware:esrgan@ultrasharp` | 4x-UltraSharp | 4x |

**Simple (boolean)**:

```json
"hiresFix": true
```

**Configured (object)**:

```json
"hiresFix": {
  "model": "runware:esrgan@ultrasharp",
  "steps": 15,
  "strength": 0.6
}
```

**Allowed values**: `true`

### [photoMaker](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-photomaker)

- **Path**: `photoMaker.images`
- **Type**: `object (3 properties)`

PhotoMaker enables personalized image generation while preserving the identity of a subject from reference images. Provide one or more photos of a person, and the model will generate new images that maintain their facial characteristics, expression tendencies, and overall identity across different styles and compositions.

> [!NOTE]
> Reference images must each contain a single, clear face. Up to 4 reference images can be provided for stronger identity preservation.

**Examples**:

```json
"photoMaker": {
  "images": ["59a2edc2-45e6-429f-be5f-7ded59b92046"],
  "strength": 20,
  "style": "Cinematic"
}
```

#### [images](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-photomaker-images)

- **Path**: `photoMaker.images`
- **Type**: `array of strings`
- **Required**: true
- **Min items**: `1`
- **Max items**: `4`

Reference images for subject identity preservation. Each image must contain a single, clear face of the subject (UUID, URL, Data URI, or Base64).

#### [strength](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-photomaker-strength)

- **Path**: `photoMaker.strength`
- **Type**: `integer`
- **Min**: `15`
- **Max**: `50`
- **Default**: `15`

Controls the balance between preserving the subject's original features and the creative transformation specified in the prompt. Lower values provide stronger subject fidelity, higher values allow more creative freedom.

#### [style](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-photomaker-style)

- **Path**: `photoMaker.style`
- **Type**: `string`
- **Default**: `No style`

Artistic style applied to the generated images.

**Allowed values**:

- `No style` Maximizes subject fidelity while allowing creative freedom in the composition.
- `Cinematic` Applies a movie-like aesthetic.
- `Disney Character` Transforms the subject into a Disney-inspired character.
- `Digital Art` Creates a digital artwork style.
- `Photographic` Enhances photographic qualities.
- `Fantasy art` Applies fantasy-themed artistic elements.
- `Neonpunk` Creates a neon-colored cyberpunk aesthetic.
- `Enhance` Improves overall image quality.
- `Comic book` Transforms the subject into comic book style.
- `Lowpoly` Creates a low-polygon geometric style.
- `Line art` Converts the image into line drawing style.

### [watermark](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-advancedfeatures-watermark)

- **Path**: `advancedFeatures.watermark`
- **Type**: `object (6 properties)`

Configuration object for adding watermarks to generated videos. Watermarks can be applied using either text or image content with customizable positioning and appearance. You must provide either `text` or `image` content for the watermark, but not both.

**Text watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "© 2025 Company",
    "displayPosition": "bottom-right",
    "opacity": 0.6,
    "fontColor": "#ffffff",
    "bgColor": "#000000"
  }
}
```

**Image watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "image": "c64351d5-4c59-42f7-95e1-eace013eddab",
    "displayPosition": "top-left",
    "opacity": 0.6
  }
}
```

**Tiled watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "PREVIEW",
    "tiled": true,
    "opacity": 0.4,
    "fontColor": "#cccccc"
  }
}
```

#### [text](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-advancedfeatures-watermark-text)

- **Path**: `advancedFeatures.watermark.text`
- **Type**: `string`
- **Min**: `2`
- **Max**: `32`

Watermark text.

#### [image](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-advancedfeatures-watermark-image)

- **Path**: `advancedFeatures.watermark.image`
- **Type**: `string`

Watermark image (UUID, URL, Data URI, or Base64).

#### [displayPosition](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-advancedfeatures-watermark-displayposition)

- **Path**: `advancedFeatures.watermark.displayPosition`
- **Type**: `string`

Watermark position.

**Allowed values**: `top-left` `top-center` `top-right` `center-left` `center-center` `center-right` `bottom-left` `bottom-center` `bottom-right` `tiled`

#### [opacity](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-advancedfeatures-watermark-opacity)

- **Path**: `advancedFeatures.watermark.opacity`
- **Type**: `float`
- **Min**: `0.1`
- **Max**: `1`
- **Step**: `0.01`

Watermark opacity.

#### [fontColor](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-advancedfeatures-watermark-fontcolor)

- **Path**: `advancedFeatures.watermark.fontColor`
- **Type**: `string`

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#request-advancedfeatures-watermark-bgcolor)

- **Path**: `advancedFeatures.watermark.bgColor`
- **Type**: `string`

Background color in hex format.

## Response Parameters

### [taskType](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [imageUUID](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#response-imageuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#response-imageurl)

- **Type**: `string`
- **Format**: `uri`

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#response-imagedatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output image.

### [seed](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/stabilityai-stable-diffusion-xl-v1-0-vae-fix#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### text-to-image (text-to-image)

![Marine Water Tester Lifestyle Photograph](https://assets.runware.ai/examples/stabilityai-stable-diffusion-xl-v1-0-vae-fix/ad1168c8-2e78-4b3b-a65f-4aa18fbfb91f.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "ae6f38f9-7c8b-49d9-8f93-269197c3de44",
  "model": "civitai:101055@128078",
  "positivePrompt": "Photorealistic commercial lifestyle photograph of a rugged portable water-quality meter in active use on a shellfish farm workboat at blue hour. The compact professional instrument is the clear hero in the near foreground: matte graphite housing, rounded protective corners, tactile rubber controls, a small illuminated color display with simple non-legible measurement graphics, and a stainless-steel probe lowered into a clear seawater sample jar. A shellfish farmer in a coral-red waterproof jacket and dark teal bib overalls holds the device naturally with one gloved hand; only torso, arms, and a subtle partial profile are visible so attention remains on the product. Wet black rope, stacked oyster baskets, a galvanized cleat, seaweed fragments, and beads of saltwater create rich working detail across the boat deck. Behind them, orderly aquaculture lines recede across calm slate-blue water toward a misty low coastline. Cool cyan dawn light, soft overcast sky, restrained coral accent, realistic reflections on wet surfaces, crisp condensation and water droplets, premium documentary product-campaign art direction. Landscape composition, product positioned near the right third, probe and rope lines guiding the eye through the frame, generous atmospheric background on the left, low eye-level camera angle, 50mm lens, shallow but believable depth of field, sharp product texture, softly rendered worker and distant farm, natural cinematic lighting, high-end outdoor equipment photography, authentic working environment, no visible branding, no added typography.",
  "negativePrompt": "illustration, CGI, 3D render, fantasy, surrealism, studio backdrop, pristine unused equipment, oversized device, duplicate product, extra fingers, malformed hands, fused gloves, broken probe, disconnected cable, illegible prominent text, logo, brand name, watermark, caption, border, interface overlay, excessive bokeh, oversaturated colors, harsh flash, plastic-looking water, distorted boat, tilted horizon, clutter obscuring the product, low detail, blur, noise",
  "width": 1216,
  "height": 832,
  "steps": 28,
  "scheduler": "DPM++ 2M Karras",
  "CFGScale": 7
}
```

---

### image-to-image (image-to-image)

![Urban Wildlife Officer Persona Portrait](https://assets.runware.ai/examples/stabilityai-stable-diffusion-xl-v1-0-vae-fix/763cda41-fb1f-46a5-bd77-81a065c6d38b.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "eb68273a-d00e-4d6c-8033-65164dfc825a",
  "model": "civitai:101055@128078",
  "positivePrompt": "Use the seed image as the clear identity and composition guide. Substantially transform the photograph into a premium hand-cut paper and opaque gouache editorial portrait for a city urban-wildlife education campaign. Preserve the same recognizable woman, facial proportions, short silver bob, round tortoiseshell glasses, beauty mark beneath her left eye, direct gaze, three-quarter-length pose, clipboard placement, and centered vertical silhouette. Render her as a confident recurring field-officer persona in navy utility coveralls, forest-green bandana, and small brass raccoon pin. Layered cut-paper shapes with tactile deckled edges, matte gouache texture, restrained geometric shadow shapes, crisp facial likeness, sophisticated civic-publication art direction. Palette of charcoal navy, eucalyptus green, warm cream, muted coral, and small brass accents. Replace the plain studio backdrop with a graphic nocturnal city-park setting: simplified brick retaining wall, native grasses, circular storm-drain motif, subtle raccoon paw-print shapes, and a pale cream moon disk framing her head without resembling a halo. Calm, observant, practical mood rather than whimsical. Strong readable silhouette, balanced negative space, polished magazine-cover quality, no lettering, no logo, no border.",
  "negativePrompt": "photorealistic output, generic face, altered age, different hairstyle, missing glasses, extra people, mascot costume, cartoon raccoon, childish illustration, fantasy clothing, exaggerated expression, glamour pose, cluttered background, illegible clipboard writing, text, typography, logo, watermark, frame, distorted hands, extra fingers, duplicate limbs, asymmetrical eyes, plastic 3D rendering",
  "width": 832,
  "height": 1216,
  "steps": 30,
  "scheduler": "Euler a",
  "strength": 0.62,
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/4d18a5e4-3d38-4c59-a093-c9b07eb3b1d7.jpg"
  }
}
```

---

### inpaint (inpaint)

![Polar Biobank Badge Logo](https://assets.runware.ai/examples/stabilityai-stable-diffusion-xl-v1-0-vae-fix/ca130a62-cc1c-4a64-83c3-38c0ac630731.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "ab5402df-372c-4563-95d5-6ca9fb3af7ee",
  "model": "civitai:101055@128078",
  "positivePrompt": "Replace the entire isolated hexagonal subject with a finished symbol-only logo for a polar microbial biobank while preserving the surrounding warm ivory background unchanged. Create a bold geometric badge combining a dormant microbial spore, a six-point ice crystal, and a small archival capsule into one clever unified mark. Swiss modernist identity design with subtle 1970s scientific-institute character: precise modular geometry, strong negative space, balanced radial symmetry, crisp screen-printed edges, flat deep navy, glacial cyan, and one restrained safety-orange accent. Keep every graphic element fully contained inside the original hexagonal boundary. Preserve the slight tactile paper surface and natural integration with the existing lighting, but make the logo itself clean, legible, distinctive, and suitable for equipment labels, signage, and institutional stationery. Centered square composition, generous clear space, no words, no initials, no extra objects.",
  "negativePrompt": "text, letters, numbers, slogan, watermark, multiple badges, repeated symbols, gradients, glossy 3D rendering, metallic effects, photorealistic microbes, medical cross, biohazard symbol, skull, clutter, thin fragile details, asymmetrical border, elements outside the hexagon, altered background",
  "width": 1024,
  "height": 1024,
  "steps": 32,
  "strength": 0.8,
  "maskMargin": 64,
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/9a4934af-2ea3-4d8c-bb15-33dbfeae9dbb.jpg",
    "maskImage": "https://assets.runware.ai/assets/inputs/963c7bb5-10a0-484a-8f8c-b97324554b31.png"
  }
}
```

---

### expand (expand)

![Rare Book Conservator Headshot](https://assets.runware.ai/examples/stabilityai-stable-diffusion-xl-v1-0-vae-fix/3b36fcd1-269d-4009-a624-af2f43a464e7.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "47e3f194-b0ba-4bb4-ac8d-71bad33d2db3",
  "model": "civitai:101055@128078",
  "positivePrompt": "Create a finished 3:2 landscape environmental headshot by naturally expanding the supplied portrait beyond both horizontal edges. Preserve the conservator’s recognizable identity, age, facial proportions, silver-streaked natural hair, clothing, pose, and calm direct gaze. Apply restrained professional portrait retouching: balanced skin tone, softened temporary blemishes and under-eye shadows, crisp natural eyes, individually resolved hair, subtle catchlights, realistic pores and expression lines, no beauty-filter effect. The complete wider scene is a rare-book conservation studio: the long pale oak workbench extends across the frame, with a bone folder, linen thread, small wheat-paste brush, folded Japanese repair tissue, and one closed clothbound volume arranged sparingly. Behind her, low blue-gray flat files and warm ivory archival boxes continue naturally to both sides, softly out of focus with no readable labels. Soft north-window key light from camera left, gentle warm bounce from the workshop, understated museum-editorial photography, muted palette of charcoal, parchment, dusty blue, oak, and aged brass. Subject centered with comfortable negative space on both sides, chest-up framing, eye-level camera, 85mm portrait-lens character, shallow depth of field, refined color grading, photorealistic, dignified, trustworthy, quietly expert, no lettering.",
  "negativePrompt": "altered identity, younger face, plastic skin, excessive smoothing, glamour makeup, exaggerated smile, distorted facial features, asymmetrical eyes, crossed eyes, duplicate person, extra limbs, malformed hands, cluttered background, readable text, labels, logos, watermark, fantasy styling, harsh HDR, oversaturation, artificial bokeh, fisheye distortion, cutout edges, visible outpaint seams",
  "width": 1152,
  "height": 768,
  "steps": 30,
  "strength": 0.7,
  "outpaint": {
    "left": 256,
    "right": 256,
    "blur": 12
  },
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/0d24170a-ed7c-48b8-8cd0-3ebfdd77e1e3.jpg"
  }
}
```