SandBase is live — $1 in free credits on signupStart free ›
Start building
Use in agentStability AI models

Stability AI modelsimage generation api

stability-ai/sdxl-controlnet-union

Sdxl Controlnet Union is Stability AI's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.

Input
The prompt to use for generating the image. Be as descriptive as possible for best results.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
020
The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. Range: 0 to 20.
170
The number of inference steps to perform. Range: 1 to 70.
The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The URL of the control image.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The URL of the control image.
An id bound to a request, can be used with response to identify the request itself.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The URL of the control image.
Whether to preprocess the canny image.
If set to true, the prompt will be expanded with additional prompts.
Whether to preprocess the normal image.
The list of LoRA weights to use.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The URL of the control image.
Whether to preprocess the teed image.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The URL of the control image.
Whether to preprocess the depth image.
Whether to preprocess the openpose image.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The URL of the control image.
The version of the safety checker to use. v1 is the default CompVis safety checker. v2 uses a custom ViT model. Allowed values: v1, v2.
01
The scale of the controlnet conditioning. Range: 0 to 1.
The format of the generated image. Allowed values: jpeg, png.
The list of embeddings to use.
Whether to preprocess the segmentation image.
Idle

Example output — click Run to generate your own

API README

SDXL ControlNet Union

SDXL ControlNet Union occupies a clearly bounded position in a image production pipeline under the route stability-ai/sdxl-controlnet-union. It is best evaluated as a named workflow endpoint rather than as a generic substitute for neighboring versions: planners can assign the route to a specific brief, record the chosen revision, and keep approval history tied to one predictable integration surface from intake through delivery.

A practical rollout of SDXL ControlNet Union should begin with source-readiness checks, ownership of the submitted material, an agreed budget, and a written definition of the final sdxl controlnet union deliverable. Before automation is enabled, the acceptance pass should verify that the returned asset opens correctly, fits the intended downstream toolchain, satisfies the project’s review criteria, and can be reproduced from the stored request and route identity stability-ai/sdxl-controlnet-union.

Highlights

  • Distinct output behavior. For SDXL ControlNet Union, for SDXL ControlNet Union, provide any of the declared edge, depth, normal, pose, or segmentation references In SDXL ControlNet Union, this capability is applied through the exact stability-ai/sdxl-controlnet-union workflow with seed as a relevant request control; the seed control exposes the corresponding choice in this route; the seed control exposes the corresponding choice in this route.
  • Creative control. For SDXL ControlNet Union, for SDXL ControlNet Union, enable or disable preprocessing independently for every conditioning input In SDXL ControlNet Union, this capability is applied through the exact stability-ai/sdxl-controlnet-union workflow with loras as a relevant request control; the loras control exposes the corresponding choice in this route; the loras control exposes the corresponding choice in this route.
  • Workflow fit. For SDXL ControlNet Union, for SDXL ControlNet Union, keep the prompt required while adding structural condition images as needed In SDXL ControlNet Union, this capability is applied through the exact stability-ai/sdxl-controlnet-union workflow with format as a relevant request control; the format control exposes the corresponding choice in this route; the format control exposes the corresponding choice in this route.
  • Production detail. For SDXL ControlNet Union, for SDXL ControlNet Union, set num_inference_steps between 1 and 70 In SDXL ControlNet Union, this capability is applied through the exact stability-ai/sdxl-controlnet-union workflow with prompt as a relevant request control; the prompt control exposes the corresponding choice in this route; the prompt control exposes the corresponding choice in this route.

Pricing

ConfigurationPrice
Per request$0.00125

When to Use

ScenarioWhy this model fits
Choose SDXL ControlNet UnionUse it when the required deliverable is specifically the image result documented for stability-ai/sdxl-controlnet-union.
Match the source materialSelect this route when your inputs naturally map to seed, loras, format, prompt.
Use its distinguishing capabilityFor SDXL ControlNet Union, provide any of the declared edge, depth, normal, pose, or segmentation references In SDXL ControlNet Union, this capability is applied through the exact stability-ai/sdxl-controlnet-union workflow with seed as a relevant request control; the seed control exposes the corresponding choice in this route
Plan repeatable productionFor SDXL ControlNet Union, enable or disable preprocessing independently for every conditioning input In SDXL ControlNet Union, this capability is applied through the exact stability-ai/sdxl-controlnet-union workflow with loras as a relevant request control; the loras control exposes the corresponding choice in this route
Confirm cost and deliveryUse the pricing combinations below and the output contract above when budgeting or automating SDXL ControlNet Union jobs.

Prompt Guide

Build the request around the exact stability-ai/sdxl-controlnet-union schema. Start with required fields, then add only the controls needed for the intended output; keep URLs reachable and enum values exactly as shown in Technical Specs.

{
  "prompt": "Ice fortress, aurora skies, polar wildlife, twilight",
  "seed": 0,
  "loras": [],
  "format": "jpeg"
}

Technical Specs

SpecificationValue
Model IDstability-ai/sdxl-controlnet-union
Execution modeasync
Required inputsprompt
Request fieldsseed (integer, optional); loras (array, optional); format (string, optional, options: jpeg / png); prompt (string, required); embeddings (array, optional); request_id (string, optional); aspect_ratio (string, optional, options: 21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16); expand_prompt (boolean, optional); guidance_scale (number, optional, min 0, max 20); teed_image_url (string, optional); canny_image_url (string, optional); depth_image_url (string, optional); teed_preprocess (boolean, optional); canny_preprocess (boolean, optional); depth_preprocess (boolean, optional); normal_image_url (string, optional); normal_preprocess (boolean, optional); openpose_image_url (string, optional); num_inference_steps (integer, optional, min 1, max 70); openpose_preprocess (boolean, optional); safety_checker_version (string, optional, options: v1 / v2); segmentation_image_url (string, optional); segmentation_preprocess (boolean, optional); controlnet_conditioning_scale (number, optional, min 0, max 1)
Outputurl (string); content_type (string)

Related Models

Related Models

stability-ai/sdxl-controlnet-union/image-to-imageSdxl Controlnet Union by Stability AI - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.stability-ai/sdxl-controlnet-union/inpaintingSdxl Controlnet Union Inpainting by Stability AI - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.stability-ai/fast-sdxl-controlnet-canny/image-to-imageFast Sdxl Controlnet Canny is Stability AI's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.stability-ai/fast-sdxl/image-to-imageFast Sdxl by Stability AI - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.stability-ai/fast-sdxl/inpaintingFast Sdxl Inpainting by Stability AI - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.stability-ai/sd/3.5-largeSd 3.5 Large by stability-ai - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.stability-ai/sd/3.5-mediumSd 3.5 Medium is stability-ai's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.stability-ai/fast-sdxlFast Sdxl is Stability AI's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.