ControlNet Preprocess OpenPose

May 1, 2025

ControlNet Preprocess OpenPose extracts a human pose skeleton from an input image for ControlNet conditioning. It is best for character and figure workflows where body posture, gesture, limb placement, and overall pose need to stay consistent across generations.

Preprocess

Studio Capoeira Kick Sequence

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@openpose',
  settings: {
    includeHandsAndFaceOpenPose: true
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/e87d4b6a-3efb-4a64-bbe9-477404d270c2.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@openpose",
            "settings": {
                "includeHandsAndFaceOpenPose": True
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/e87d4b6a-3efb-4a64-bbe9-477404d270c2.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": "62e22be3-0a17-4f6d-8a9a-3888bcd5467e",
      "model": "runware:controlnet-preprocess@openpose",
      "settings": {
        "includeHandsAndFaceOpenPose": true
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/e87d4b6a-3efb-4a64-bbe9-477404d270c2.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@openpose \
  settings.includeHandsAndFaceOpenPose=true \
  inputs.image=https://assets.runware.ai/assets/inputs/e87d4b6a-3efb-4a64-bbe9-477404d270c2.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "62e22be3-0a17-4f6d-8a9a-3888bcd5467e",
  "model": "runware:controlnet-preprocess@openpose",
  "settings": {
    "includeHandsAndFaceOpenPose": true
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/e87d4b6a-3efb-4a64-bbe9-477404d270c2.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "62e22be3-0a17-4f6d-8a9a-3888bcd5467e",
  "guideImageURL": "https://im.runware.ai/image/os/a02d21/ws/3/ii/a17d3e0b-1146-474c-b0f7-78f9a82116fd.jpg",
  "cost": 0.0102,
  "guideImageUUID": "a17d3e0b-1146-474c-b0f7-78f9a82116fd",
  "inputImageUUID": "c408b5a1-20de-4ec5-be60-5b0fd68d8d2e"
}

Preprocess

Tarmac Signal Marshal Stance

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@openpose',
  settings: {
    includeHandsAndFaceOpenPose: true
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/8d44098b-0db1-4236-b69c-7676c1e22f31.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@openpose",
            "settings": {
                "includeHandsAndFaceOpenPose": True
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/8d44098b-0db1-4236-b69c-7676c1e22f31.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": "478953ef-1372-43ad-a245-ba7721be2590",
      "model": "runware:controlnet-preprocess@openpose",
      "settings": {
        "includeHandsAndFaceOpenPose": true
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/8d44098b-0db1-4236-b69c-7676c1e22f31.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@openpose \
  settings.includeHandsAndFaceOpenPose=true \
  inputs.image=https://assets.runware.ai/assets/inputs/8d44098b-0db1-4236-b69c-7676c1e22f31.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "478953ef-1372-43ad-a245-ba7721be2590",
  "model": "runware:controlnet-preprocess@openpose",
  "settings": {
    "includeHandsAndFaceOpenPose": true
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/8d44098b-0db1-4236-b69c-7676c1e22f31.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "478953ef-1372-43ad-a245-ba7721be2590",
  "guideImageURL": "https://im.runware.ai/image/os/a04d20/ws/3/ii/a2f8f7e3-7532-46e7-9f35-431f5962909a.jpg",
  "cost": 0.016,
  "guideImageUUID": "a2f8f7e3-7532-46e7-9f35-431f5962909a",
  "inputImageUUID": "741b2b9d-5391-4f0e-bddd-8ff1fc71dabd"
}

Preprocess

Orchestral Conductor Rehearsal Gesture

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@openpose',
  settings: {
    includeHandsAndFaceOpenPose: true
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/c9e8d2c5-93e4-44e3-ab7f-b8bb2a83bb09.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@openpose",
            "settings": {
                "includeHandsAndFaceOpenPose": True
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/c9e8d2c5-93e4-44e3-ab7f-b8bb2a83bb09.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": "7b534b1a-e6ee-48dc-84cd-926eaaf6d741",
      "model": "runware:controlnet-preprocess@openpose",
      "settings": {
        "includeHandsAndFaceOpenPose": true
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/c9e8d2c5-93e4-44e3-ab7f-b8bb2a83bb09.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@openpose \
  settings.includeHandsAndFaceOpenPose=true \
  inputs.image=https://assets.runware.ai/assets/inputs/c9e8d2c5-93e4-44e3-ab7f-b8bb2a83bb09.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "7b534b1a-e6ee-48dc-84cd-926eaaf6d741",
  "model": "runware:controlnet-preprocess@openpose",
  "settings": {
    "includeHandsAndFaceOpenPose": true
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/c9e8d2c5-93e4-44e3-ab7f-b8bb2a83bb09.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "7b534b1a-e6ee-48dc-84cd-926eaaf6d741",
  "guideImageURL": "https://im.runware.ai/image/os/a08dlim3/ws/3/ii/fa11ff84-0857-417b-a4a1-d7664a2c8972.jpg",
  "cost": 0.0109,
  "guideImageUUID": "fa11ff84-0857-417b-a4a1-d7664a2c8972",
  "inputImageUUID": "11e4b467-52e0-4857-a198-9d594e5dce38"
}

Preprocess

Clockwork Mime Balancing Routine

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@openpose',
  settings: {
    includeHandsAndFaceOpenPose: true
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/015b5877-0068-4f75-943a-861579547531.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@openpose",
            "settings": {
                "includeHandsAndFaceOpenPose": True
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/015b5877-0068-4f75-943a-861579547531.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": "7010b7d0-d31f-4f2c-af58-91c4a6b6f0f8",
      "model": "runware:controlnet-preprocess@openpose",
      "settings": {
        "includeHandsAndFaceOpenPose": true
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/015b5877-0068-4f75-943a-861579547531.jpg"
      }
    }
  ]'

runware run runware:controlnet-preprocess@openpose \
  settings.includeHandsAndFaceOpenPose=true \
  inputs.image=https://assets.runware.ai/assets/inputs/015b5877-0068-4f75-943a-861579547531.jpg

{
  "taskType": "controlNetPreprocess",
  "taskUUID": "7010b7d0-d31f-4f2c-af58-91c4a6b6f0f8",
  "model": "runware:controlnet-preprocess@openpose",
  "settings": {
    "includeHandsAndFaceOpenPose": true
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/015b5877-0068-4f75-943a-861579547531.jpg"
  }
}

Response

{
  "taskType": "imageControlNetPreProcess",
  "taskUUID": "7010b7d0-d31f-4f2c-af58-91c4a6b6f0f8",
  "guideImageURL": "https://im.runware.ai/image/os/a09dlim3/ws/3/ii/ca4a44b6-86fa-4f93-bec4-31a00c74aa9e.jpg",
  "cost": 0.007,
  "guideImageUUID": "ca4a44b6-86fa-4f93-bec4-31a00c74aa9e",
  "inputImageUUID": "bc624964-9360-4d8f-9c4c-23de1bde0048"
}