Image
SDXL ControlNet Union
Combine structural controls for an SDXL scene with ControlNet Union.
- Text to image
- Image editing
Sign in to create. Review the credit cost in the studio before running.
Catalog preview for SDXL ControlNet Union. Review your own result before publishing.
A starting point.
Combine structural controls for an SDXL scene with ControlNet Union. Begin with one control type so its effect is easy to judge.
Before you publish.
Check alignment between control maps and whether added controls conflict with one another.
Review the quote before running. A failed generation releases its reserved credits. Download the results you want to keep; stored media is retained for 30 days.
Settings and model questionsCheck the available settings and guidance when preparing your input.
Inputs and settings
Send prompt and the matching control URL, such as depth_image_url or canny_image_url.
Use the corresponding preprocess switch for that input. Different editing modes require their own image or mask fields.
Inputs, all modes and APIModel IDs, current input limits and the API generation workflow.
Supported inputs
These fields come from the current studio form for sdxl-controlnet-union. Other modes may require different inputs.
| Input | Type | Requirement | Options and limits |
|---|---|---|---|
prompt | Text | Required | — |
canny_image_url | Text | Optional | — |
canny_preprocess | On/off | Optional | — |
controlnet_conditioning_scale | Number | Optional | ≥ 0 · ≤ 1 |
depth_image_url | Text | Optional | — |
depth_preprocess | On/off | Optional | — |
embeddings | List | Optional | — |
enable_safety_checker | On/off | Optional | — |
expand_prompt | On/off | Optional | — |
format | Text | Optional | jpeg, png |
guidance_scale | Number | Optional | ≥ 0 · ≤ 20 |
loras | List | Optional | — |
negative_prompt | Text | Optional | — |
normal_image_url | Text | Optional | — |
normal_preprocess | On/off | Optional | — |
num_images | Whole number | Optional | ≥ 1 · ≤ 8 |
num_inference_steps | Whole number | Optional | ≥ 1 · ≤ 70 |
openpose_image_url | Text | Optional | — |
openpose_preprocess | On/off | Optional | — |
request_id | Text | Optional | — |
safety_checker_version | Text | Optional | — |
seed | Whole number | Optional | — |
segmentation_image_url | Text | Optional | — |
segmentation_preprocess | On/off | Optional | — |
teed_image_url | Text | Optional | — |
teed_preprocess | On/off | Optional | — |
Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.
Other modes and their inputs
Open the operation you need and check its inputs. Settings from one mode do not automatically apply to another.
image-to-image (image-to-image)sdxl-controlnet-union/image-to-image
Supported inputs
These fields come from the current studio form for sdxl-controlnet-union/image-to-image. Other modes may require different inputs.
| Input | Type | Requirement | Options and limits |
|---|---|---|---|
image_url | Text | Required | — |
prompt | Text | Required | — |
canny_image_url | Text | Optional | — |
canny_preprocess | On/off | Optional | — |
controlnet_conditioning_scale | Number | Optional | ≥ 0 · ≤ 1 |
crop_output | On/off | Optional | — |
depth_image_url | Text | Optional | — |
depth_preprocess | On/off | Optional | — |
embeddings | List | Optional | — |
enable_safety_checker | On/off | Optional | — |
expand_prompt | On/off | Optional | — |
format | Text | Optional | jpeg, png |
guidance_scale | Number | Optional | ≥ 0 · ≤ 20 |
loras | List | Optional | — |
negative_prompt | Text | Optional | — |
normal_image_url | Text | Optional | — |
normal_preprocess | On/off | Optional | — |
num_images | Whole number | Optional | ≥ 1 · ≤ 8 |
num_inference_steps | Whole number | Optional | ≥ 1 · ≤ 70 |
openpose_image_url | Text | Optional | — |
openpose_preprocess | On/off | Optional | — |
preserve_aspect_ratio | On/off | Optional | — |
request_id | Text | Optional | — |
safety_checker_version | Text | Optional | — |
seed | Whole number | Optional | — |
segmentation_image_url | Text | Optional | — |
segmentation_preprocess | On/off | Optional | — |
strength | Number | Optional | ≥ 0.05 · ≤ 1 |
teed_image_url | Text | Optional | — |
teed_preprocess | On/off | Optional | — |
Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.
image-to-image (inpainting)sdxl-controlnet-union/inpainting
Supported inputs
These fields come from the current studio form for sdxl-controlnet-union/inpainting. Other modes may require different inputs.
| Input | Type | Requirement | Options and limits |
|---|---|---|---|
image_url | Text | Required | — |
mask_url | Text | Required | — |
prompt | Text | Required | — |
canny_image_url | Text | Optional | — |
canny_preprocess | On/off | Optional | — |
controlnet_conditioning_scale | Number | Optional | ≥ 0 · ≤ 1 |
depth_image_url | Text | Optional | — |
depth_preprocess | On/off | Optional | — |
embeddings | List | Optional | — |
enable_safety_checker | On/off | Optional | — |
expand_prompt | On/off | Optional | — |
format | Text | Optional | jpeg, png |
guidance_scale | Number | Optional | ≥ 0 · ≤ 20 |
loras | List | Optional | — |
negative_prompt | Text | Optional | — |
normal_image_url | Text | Optional | — |
normal_preprocess | On/off | Optional | — |
num_images | Whole number | Optional | ≥ 1 · ≤ 8 |
num_inference_steps | Whole number | Optional | ≥ 1 · ≤ 70 |
openpose_image_url | Text | Optional | — |
openpose_preprocess | On/off | Optional | — |
request_id | Text | Optional | — |
safety_checker_version | Text | Optional | — |
seed | Whole number | Optional | — |
segmentation_image_url | Text | Optional | — |
segmentation_preprocess | On/off | Optional | — |
strength | Number | Optional | ≥ 0.01 · ≤ 1 |
teed_image_url | Text | Optional | — |
teed_preprocess | On/off | Optional | — |
Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.
Use SDXL ControlNet Union through the API.
Start with this model ID for the endpoint featured on this page:
sdxl-controlnet-union
Input requirements belong to this model ID. Check a different mode’s schema separately when switching modes.
Available modes
- text-to-image ·
sdxl-controlnet-union - image-to-image (image-to-image) ·
sdxl-controlnet-union/image-to-image - image-to-image (inpainting) ·
sdxl-controlnet-union/inpainting
Check the current model schema for supported inputs and options. Other tasks may use different model IDs.
From quote to result.
Request a credit quote for your input and settings before submitting a generation. A sample output or the price of another model is not a quote for your request.
Follow the generation workflow, then poll the job for its status and result. The API and studio use the same balance.