live

MODEL IDrunware:controlnet-preprocess@seg

ControlNet Preprocess Seg

May 1, 2025

ControlNet Preprocess Seg converts an input image into a semantic segmentation map for ControlNet conditioning. It is best for preserving broad scene organization such as sky, ground, buildings, clothing, vegetation, and other region-level structure while allowing major stylistic changes.

Canal Rescue Training Yard

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@seg',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/ead7aaec-d31b-4df9-b0cb-34561863cf95.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@seg",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/ead7aaec-d31b-4df9-b0cb-34561863cf95.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": "e733edbc-4928-43f0-bf66-552a5a67b5cd",
      "model": "runware:controlnet-preprocess@seg",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/ead7aaec-d31b-4df9-b0cb-34561863cf95.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@seg \
  inputs.image=https://assets.runware.ai/assets/inputs/ead7aaec-d31b-4df9-b0cb-34561863cf95.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "e733edbc-4928-43f0-bf66-552a5a67b5cd",
  "model": "runware:controlnet-preprocess@seg",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/ead7aaec-d31b-4df9-b0cb-34561863cf95.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "e733edbc-4928-43f0-bf66-552a5a67b5cd",
  "guideImageURL": "https://im.runware.ai/image/os/a10dlim3/ws/3/ii/5f856486-40e4-4e13-84a3-c51d69703749.jpg",
  "cost": 0.0019,
  "guideImageUUID": "5f856486-40e4-4e13-84a3-c51d69703749",
  "inputImageUUID": "19553511-9373-4ddd-ab55-775a66d6727a"
}

semantic-segmentation

Drysuit Colorway Segmentation Map$0.0013~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@seg',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/b3fddc4f-3956-4973-b86b-748bc45c41dd.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@seg",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/b3fddc4f-3956-4973-b86b-748bc45c41dd.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": "135d797b-10e2-44c8-824c-7749a9643147",
      "model": "runware:controlnet-preprocess@seg",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/b3fddc4f-3956-4973-b86b-748bc45c41dd.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@seg \
  inputs.image=https://assets.runware.ai/assets/inputs/b3fddc4f-3956-4973-b86b-748bc45c41dd.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "135d797b-10e2-44c8-824c-7749a9643147",
  "model": "runware:controlnet-preprocess@seg",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/b3fddc4f-3956-4973-b86b-748bc45c41dd.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "135d797b-10e2-44c8-824c-7749a9643147",
  "guideImageURL": "https://im.runware.ai/image/os/a07dlim3/ws/3/ii/0bc1abba-efcc-4668-887e-eaf2929cb820.jpg",
  "cost": 0.0013,
  "guideImageUUID": "0bc1abba-efcc-4668-887e-eaf2929cb820",
  "inputImageUUID": "7e4f5c06-d2a2-457f-8e62-7bc578af4232"
}

semantic-segmentation

Cargo Trike Colorway Segmentation Guide$0.0013~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@seg',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/24cd483a-3b39-4d62-98cd-59187bd6d888.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@seg",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/24cd483a-3b39-4d62-98cd-59187bd6d888.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": "db981afb-2424-43ad-b41b-87cd6967ae17",
      "model": "runware:controlnet-preprocess@seg",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/24cd483a-3b39-4d62-98cd-59187bd6d888.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@seg \
  inputs.image=https://assets.runware.ai/assets/inputs/24cd483a-3b39-4d62-98cd-59187bd6d888.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "db981afb-2424-43ad-b41b-87cd6967ae17",
  "model": "runware:controlnet-preprocess@seg",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/24cd483a-3b39-4d62-98cd-59187bd6d888.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "db981afb-2424-43ad-b41b-87cd6967ae17",
  "guideImageURL": "https://im.runware.ai/image/os/a04d20/ws/3/ii/cf05ddf3-7a6a-4d09-ab4f-692fc15e0033.jpg",
  "cost": 0.0013,
  "guideImageUUID": "cf05ddf3-7a6a-4d09-ab4f-692fc15e0033",
  "inputImageUUID": "8558d307-e052-4c4f-a63b-b0a2bcf3fd45"
}

Polar Research Canteen Interior

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@seg',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/275fb6ec-47f3-4b3f-badf-8a5f2a1c2539.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@seg",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/275fb6ec-47f3-4b3f-badf-8a5f2a1c2539.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": "00554747-b08b-448c-b35b-da3a1c7c2599",
      "model": "runware:controlnet-preprocess@seg",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/275fb6ec-47f3-4b3f-badf-8a5f2a1c2539.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@seg \
  inputs.image=https://assets.runware.ai/assets/inputs/275fb6ec-47f3-4b3f-badf-8a5f2a1c2539.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "00554747-b08b-448c-b35b-da3a1c7c2599",
  "model": "runware:controlnet-preprocess@seg",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/275fb6ec-47f3-4b3f-badf-8a5f2a1c2539.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "00554747-b08b-448c-b35b-da3a1c7c2599",
  "guideImageURL": "https://im.runware.ai/image/os/a03d21/ws/3/ii/c01384ed-30fe-4264-b211-31d7171039ee.jpg",
  "cost": 0.0013,
  "guideImageUUID": "c01384ed-30fe-4264-b211-31d7171039ee",
  "inputImageUUID": "2b9ec5bd-2b85-422a-9d67-cabcb2688a41"
}

Geothermal Port District Segmentation

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@seg',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/161bbffc-ca99-4d14-b027-8c7ed4fa50fb.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@seg",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/161bbffc-ca99-4d14-b027-8c7ed4fa50fb.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": "dbb5a2cf-8cad-4f65-8d49-374689c1ee53",
      "model": "runware:controlnet-preprocess@seg",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/161bbffc-ca99-4d14-b027-8c7ed4fa50fb.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@seg \
  inputs.image=https://assets.runware.ai/assets/inputs/161bbffc-ca99-4d14-b027-8c7ed4fa50fb.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "dbb5a2cf-8cad-4f65-8d49-374689c1ee53",
  "model": "runware:controlnet-preprocess@seg",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/161bbffc-ca99-4d14-b027-8c7ed4fa50fb.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "dbb5a2cf-8cad-4f65-8d49-374689c1ee53",
  "guideImageURL": "https://im.runware.ai/image/os/a06dlim3/ws/3/ii/9bb82ba8-b669-4e19-961b-0d309774ad0d.jpg",
  "cost": 0.0013,
  "guideImageUUID": "9bb82ba8-b669-4e19-961b-0d309774ad0d",
  "inputImageUUID": "75041e03-ce68-4510-a1d6-36ee30302486"
}

Ornate Transit Atrium Segmentation

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@seg',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/c0f71eeb-7d75-4e5c-9af3-7303d432e928.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@seg",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/c0f71eeb-7d75-4e5c-9af3-7303d432e928.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": "864e7256-d448-4255-b027-b620dc366893",
      "model": "runware:controlnet-preprocess@seg",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/c0f71eeb-7d75-4e5c-9af3-7303d432e928.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@seg \
  inputs.image=https://assets.runware.ai/assets/inputs/c0f71eeb-7d75-4e5c-9af3-7303d432e928.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "864e7256-d448-4255-b027-b620dc366893",
  "model": "runware:controlnet-preprocess@seg",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/c0f71eeb-7d75-4e5c-9af3-7303d432e928.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "864e7256-d448-4255-b027-b620dc366893",
  "guideImageURL": "https://im.runware.ai/image/os/a08dlim3/ws/3/ii/7bfa61b5-35c4-4340-965a-6df75bb66311.jpg",
  "cost": 0.0019,
  "guideImageUUID": "7bfa61b5-35c4-4340-965a-6df75bb66311",
  "inputImageUUID": "42903ced-d3cf-47a6-84a4-b01fa23b3466"
}

semantic-segmentation

Glassblower Headshot Retouch Segmentation$0.0013~7s

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@seg',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/a61e644a-67b2-4908-ba42-7b34272072d6.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@seg",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/a61e644a-67b2-4908-ba42-7b34272072d6.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": "eda9dc4b-22cc-487a-8836-87765398a743",
      "model": "runware:controlnet-preprocess@seg",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/a61e644a-67b2-4908-ba42-7b34272072d6.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@seg \
  inputs.image=https://assets.runware.ai/assets/inputs/a61e644a-67b2-4908-ba42-7b34272072d6.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "eda9dc4b-22cc-487a-8836-87765398a743",
  "model": "runware:controlnet-preprocess@seg",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/a61e644a-67b2-4908-ba42-7b34272072d6.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "eda9dc4b-22cc-487a-8836-87765398a743",
  "guideImageURL": "https://im.runware.ai/image/os/a06dlim3/ws/3/ii/34943a41-6689-489c-b8ad-977519d58d4b.jpg",
  "cost": 0.0013,
  "guideImageUUID": "34943a41-6689-489c-b8ad-977519d58d4b",
  "inputImageUUID": "7d235a58-c451-413a-8e04-e87a05c93120"
}

semantic-segmentation

Oyster Hatchery Dusk Relight Guide$0.0013~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@seg',
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/b14013c1-fdfa-4597-9538-502b7bc8049b.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@seg",
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/b14013c1-fdfa-4597-9538-502b7bc8049b.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": "fe99cb72-5ae5-4a57-b6d4-e870116fb5e4",
      "model": "runware:controlnet-preprocess@seg",
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/b14013c1-fdfa-4597-9538-502b7bc8049b.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@seg \
  inputs.image=https://assets.runware.ai/assets/inputs/b14013c1-fdfa-4597-9538-502b7bc8049b.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "fe99cb72-5ae5-4a57-b6d4-e870116fb5e4",
  "model": "runware:controlnet-preprocess@seg",
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/b14013c1-fdfa-4597-9538-502b7bc8049b.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "fe99cb72-5ae5-4a57-b6d4-e870116fb5e4",
  "guideImageURL": "https://im.runware.ai/image/os/a03d21/ws/3/ii/2411dfa4-b824-46c9-8eaf-e32434a4b46d.jpg",
  "cost": 0.0013,
  "guideImageUUID": "2411dfa4-b824-46c9-8eaf-e32434a4b46d",
  "inputImageUUID": "f036855a-4174-4dda-bc08-d9fec3cedc59"
}