ControlNet Preprocess Tile

May 1, 2025

ControlNet Preprocess Tile prepares an image for tile-style ControlNet conditioning, emphasizing local detail and patch-level consistency. It is useful for upscaling-adjacent workflows, texture refinement, and preserving fine local structure when a model needs more detailed guidance from the source image.

tile-preprocessing

Accordion Colorway Detail 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@tile',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/9c068590-09a2-48a4-97a9-a3e0a68dece0.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@tile",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/9c068590-09a2-48a4-97a9-a3e0a68dece0.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": "526393d1-6b12-4945-a5d8-2cd6a07f4f31",
      "model": "runware:controlnet-preprocess@tile",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/9c068590-09a2-48a4-97a9-a3e0a68dece0.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@tile \
  inputs.image=https://assets.runware.ai/assets/inputs/9c068590-09a2-48a4-97a9-a3e0a68dece0.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "526393d1-6b12-4945-a5d8-2cd6a07f4f31",
  "model": "runware:controlnet-preprocess@tile",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/9c068590-09a2-48a4-97a9-a3e0a68dece0.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "526393d1-6b12-4945-a5d8-2cd6a07f4f31",
  "guideImageURL": "https://im.runware.ai/image/os/a10dlim3/ws/3/ii/3ce98e36-c33e-4a11-879d-0d97958bc0da.jpg",
  "cost": 0.0006,
  "guideImageUUID": "3ce98e36-c33e-4a11-879d-0d97958bc0da",
  "inputImageUUID": "c188deb3-f6d7-4dff-9be6-371af0879b65"
}

tile-preprocessing

Wildland Ecologist Headshot Detail Map$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@tile',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/f09dec5d-8389-4353-a495-aa4467514a32.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@tile",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/f09dec5d-8389-4353-a495-aa4467514a32.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": "95805518-81e8-4d5e-84ee-6ea00dcbd2ea",
      "model": "runware:controlnet-preprocess@tile",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/f09dec5d-8389-4353-a495-aa4467514a32.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@tile \
  inputs.image=https://assets.runware.ai/assets/inputs/f09dec5d-8389-4353-a495-aa4467514a32.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "95805518-81e8-4d5e-84ee-6ea00dcbd2ea",
  "model": "runware:controlnet-preprocess@tile",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/f09dec5d-8389-4353-a495-aa4467514a32.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "95805518-81e8-4d5e-84ee-6ea00dcbd2ea",
  "guideImageURL": "https://im.runware.ai/image/os/a01d21/ws/3/ii/d98c2f3e-74d7-4c53-bab4-477216788e46.jpg",
  "cost": 0.0006,
  "guideImageUUID": "d98c2f3e-74d7-4c53-bab4-477216788e46",
  "inputImageUUID": "eefd9365-36b9-4ebb-ac27-0975bacc8640"
}

tile-preprocessing

Historic Planetarium Restoration Control Map$0.0006~4s

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@tile',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/bc5f8f44-a32b-49db-a3ea-87207a2597ec.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@tile",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/bc5f8f44-a32b-49db-a3ea-87207a2597ec.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": "85246d3e-5cd5-4e0b-966d-8963bb40e044",
      "model": "runware:controlnet-preprocess@tile",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/bc5f8f44-a32b-49db-a3ea-87207a2597ec.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@tile \
  inputs.image=https://assets.runware.ai/assets/inputs/bc5f8f44-a32b-49db-a3ea-87207a2597ec.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "85246d3e-5cd5-4e0b-966d-8963bb40e044",
  "model": "runware:controlnet-preprocess@tile",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/bc5f8f44-a32b-49db-a3ea-87207a2597ec.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "85246d3e-5cd5-4e0b-966d-8963bb40e044",
  "guideImageURL": "https://im.runware.ai/image/os/a04d20/ws/3/ii/ea73a82b-3710-43d1-8cf4-e7e799b0ef2f.jpg",
  "cost": 0.0006,
  "guideImageUUID": "ea73a82b-3710-43d1-8cf4-e7e799b0ef2f",
  "inputImageUUID": "7ebc8803-6302-4ae1-bc1c-69f78f99e02f"
}

tile-preprocessing

Woodcut Organ Restyle Detail Guide$0.0006~4s

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@tile',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/039deb6d-aaae-4825-b680-40ea1238b29f.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@tile",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/039deb6d-aaae-4825-b680-40ea1238b29f.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": "0f01190d-d5a2-449e-ab3f-9ea751cd0311",
      "model": "runware:controlnet-preprocess@tile",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/039deb6d-aaae-4825-b680-40ea1238b29f.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@tile \
  inputs.image=https://assets.runware.ai/assets/inputs/039deb6d-aaae-4825-b680-40ea1238b29f.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "0f01190d-d5a2-449e-ab3f-9ea751cd0311",
  "model": "runware:controlnet-preprocess@tile",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/039deb6d-aaae-4825-b680-40ea1238b29f.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "0f01190d-d5a2-449e-ab3f-9ea751cd0311",
  "guideImageURL": "https://im.runware.ai/image/os/a03d21/ws/3/ii/052868ab-29ea-4f44-8385-a2d539743b53.jpg",
  "cost": 0.0006,
  "guideImageUUID": "052868ab-29ea-4f44-8385-a2d539743b53",
  "inputImageUUID": "32634bd4-ebce-4d70-b6c2-54b1ee13b545"
}