ControlNet Preprocess Shuffle

May 1, 2025

ControlNet Preprocess Shuffle creates a shuffled representation of the source image for ControlNet conditioning. It is useful when the goal is to borrow palette, local texture, and visual character from a source image without rigidly preserving exact edges, contours, or pose.

content-shuffle

Polar Night Station Relight Guide$0.0006~3s

Try in Playground

import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'runware:controlnet-preprocess@shuffle',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/e018edea-dbab-44cc-84ba-c781a8a6b39c.jpg'
  }
})

import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "runware:controlnet-preprocess@shuffle",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/e018edea-dbab-44cc-84ba-c781a8a6b39c.jpg"
            }
        })


asyncio.run(main())

curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "controlNetPreprocess",
      "taskUUID": "96c8aea2-b6dd-4c34-9e7d-d1c66968bd20",
      "model": "runware:controlnet-preprocess@shuffle",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/e018edea-dbab-44cc-84ba-c781a8a6b39c.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@shuffle \
  inputs.image=https://assets.runware.ai/assets/inputs/e018edea-dbab-44cc-84ba-c781a8a6b39c.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "96c8aea2-b6dd-4c34-9e7d-d1c66968bd20",
  "model": "runware:controlnet-preprocess@shuffle",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/e018edea-dbab-44cc-84ba-c781a8a6b39c.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "96c8aea2-b6dd-4c34-9e7d-d1c66968bd20",
  "guideImageURL": "https://im.runware.ai/image/os/a09dlim3/ws/3/ii/9deab40e-e6b9-4075-9e62-40f7d4861b02.jpg",
  "cost": 0.0006,
  "guideImageUUID": "9deab40e-e6b9-4075-9e62-40f7d4861b02",
  "inputImageUUID": "ffe21419-8736-4932-8f66-a318dda911f9"
}

content-shuffle

Night Market Cooktop Scene Guide$0.0006~5s

Try in Playground

import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'runware:controlnet-preprocess@shuffle',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/76049a03-2b13-4b3b-abac-304b6ea1157d.jpg'
  }
})

import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "runware:controlnet-preprocess@shuffle",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/76049a03-2b13-4b3b-abac-304b6ea1157d.jpg"
            }
        })


asyncio.run(main())

curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "controlNetPreprocess",
      "taskUUID": "598a322b-b6d3-4682-804b-b4e12f733540",
      "model": "runware:controlnet-preprocess@shuffle",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/76049a03-2b13-4b3b-abac-304b6ea1157d.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@shuffle \
  inputs.image=https://assets.runware.ai/assets/inputs/76049a03-2b13-4b3b-abac-304b6ea1157d.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "598a322b-b6d3-4682-804b-b4e12f733540",
  "model": "runware:controlnet-preprocess@shuffle",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/76049a03-2b13-4b3b-abac-304b6ea1157d.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "598a322b-b6d3-4682-804b-b4e12f733540",
  "guideImageURL": "https://im.runware.ai/image/os/a07dlim3/ws/3/ii/26555ddb-2367-432a-b617-d964876fec45.jpg",
  "cost": 0.0006,
  "guideImageUUID": "26555ddb-2367-432a-b617-d964876fec45",
  "inputImageUUID": "c8f09ec0-70fc-4df3-bac4-8ec6604f1914"
}

content-shuffle

Geology Exhibition Panorama Expansion$0.0006~6s

Try in Playground

import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'runware:controlnet-preprocess@shuffle',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/df8a67b4-b192-476c-8004-2db0d2222fb1.jpg'
  }
})

import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "runware:controlnet-preprocess@shuffle",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/df8a67b4-b192-476c-8004-2db0d2222fb1.jpg"
            }
        })


asyncio.run(main())

curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "controlNetPreprocess",
      "taskUUID": "1403f76d-54aa-45fc-aa9d-bdcdf2aa2d4c",
      "model": "runware:controlnet-preprocess@shuffle",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/df8a67b4-b192-476c-8004-2db0d2222fb1.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@shuffle \
  inputs.image=https://assets.runware.ai/assets/inputs/df8a67b4-b192-476c-8004-2db0d2222fb1.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "1403f76d-54aa-45fc-aa9d-bdcdf2aa2d4c",
  "model": "runware:controlnet-preprocess@shuffle",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/df8a67b4-b192-476c-8004-2db0d2222fb1.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "1403f76d-54aa-45fc-aa9d-bdcdf2aa2d4c",
  "guideImageURL": "https://im.runware.ai/image/os/a02d21/ws/3/ii/6862cfb7-bc6b-4716-8c6d-03b1d7662965.jpg",
  "cost": 0.0006,
  "guideImageUUID": "6862cfb7-bc6b-4716-8c6d-03b1d7662965",
  "inputImageUUID": "b1b4465c-2706-40b1-8cf8-61c53a4e5b96"
}

content-shuffle

Skate Championship Broadcast Expansion Guide$0.0006~3s

Try in Playground

import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'runware:controlnet-preprocess@shuffle',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/ba6da28e-0251-4ac6-b2d2-2370e8936872.jpg'
  }
})

import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "runware:controlnet-preprocess@shuffle",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/ba6da28e-0251-4ac6-b2d2-2370e8936872.jpg"
            }
        })


asyncio.run(main())

curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "controlNetPreprocess",
      "taskUUID": "31f84c28-2e5a-42ba-b978-a09d35351162",
      "model": "runware:controlnet-preprocess@shuffle",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/ba6da28e-0251-4ac6-b2d2-2370e8936872.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@shuffle \
  inputs.image=https://assets.runware.ai/assets/inputs/ba6da28e-0251-4ac6-b2d2-2370e8936872.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "31f84c28-2e5a-42ba-b978-a09d35351162",
  "model": "runware:controlnet-preprocess@shuffle",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/ba6da28e-0251-4ac6-b2d2-2370e8936872.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "31f84c28-2e5a-42ba-b978-a09d35351162",
  "guideImageURL": "https://im.runware.ai/image/os/a06dlim3/ws/3/ii/72e0dfae-7ff3-4893-b26f-7c03807049d7.jpg",
  "cost": 0.0006,
  "guideImageUUID": "72e0dfae-7ff3-4893-b26f-7c03807049d7",
  "inputImageUUID": "17c79a7d-ab78-4c45-adfb-c8cb27eac314"
}