Search across models, guides, examples and the API.
↑↓ Navigateenter Openesc Close
Dashboard
live
MODEL IDrunware:35@1
Try in Playground

YOLOv8n Face

YOLOv8n Face is a lightweight image masking model that detects realistic 2D faces and returns black-and-white masks for each detection. It is designed for fast automated mask generation in inpainting and detail enhancement workflows where throughput matters more than maximum facial precision.

YOLOv8n Face

face-mask

Badlands Expedition Background Swap$0.0013~6s
Badlands Expedition Background Swap
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:35@1',
  settings: {
    confidence: 0.5,
    maxDetections: 6,
    maskPadding: 10,
    maskBlur: 5
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/bd70e764-663b-4094-9cd5-8c8057085d16.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:35@1",
            "settings": {
                "confidence": 0.5,
                "maxDetections": 6,
                "maskPadding": 10,
                "maskBlur": 5
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/bd70e764-663b-4094-9cd5-8c8057085d16.jpg"
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "imageMasking",
      "taskUUID": "1324ffc3-0054-425b-9c2c-07613dbfa574",
      "model": "runware:35@1",
      "settings": {
        "confidence": 0.5,
        "maxDetections": 6,
        "maskPadding": 10,
        "maskBlur": 5
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/bd70e764-663b-4094-9cd5-8c8057085d16.jpg"
      }
    }
  ]'
runware run runware:35@1 \
  settings.confidence=0.5 \
  settings.maxDetections=6 \
  settings.maskPadding=10 \
  settings.maskBlur=5 \
  inputs.image=https://assets.runware.ai/assets/inputs/bd70e764-663b-4094-9cd5-8c8057085d16.jpg
{
  "taskType": "imageMasking",
  "taskUUID": "1324ffc3-0054-425b-9c2c-07613dbfa574",
  "model": "runware:35@1",
  "settings": {
    "confidence": 0.5,
    "maxDetections": 6,
    "maskPadding": 10,
    "maskBlur": 5
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/bd70e764-663b-4094-9cd5-8c8057085d16.jpg"
  }
}
Response
{
  "taskType": "imageMasking",
  "taskUUID": "1324ffc3-0054-425b-9c2c-07613dbfa574",
  "maskImageURL": "https://im.runware.ai/image/os/a07dlim3/ws/4/ii/2af078ba-c2de-4433-815a-caba2666f434.jpg",
  "detections": [
    {
      "x_min": 258,
      "y_min": 72,
      "x_max": 411,
      "y_max": 273
    },
    {
      "x_min": 1047,
      "y_min": 321,
      "x_max": 1193,
      "y_max": 506
    },
    {
      "x_min": 557,
      "y_min": 62,
      "x_max": 696,
      "y_max": 252
    },
    {
      "x_min": 847,
      "y_min": 95,
      "x_max": 960,
      "y_max": 247
    }
  ],
  "cost": 0.0013,
  "maskImageUUID": "2af078ba-c2de-4433-815a-caba2666f434"
}

face-mask

Independent Perfumers Group Headshot$0.0013~5s
Independent Perfumers Group Headshot
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:35@1',
  settings: {
    confidence: 0.5,
    maxDetections: 6,
    maskPadding: 10,
    maskBlur: 5
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/22729a97-d803-4643-acd2-281d7512311b.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:35@1",
            "settings": {
                "confidence": 0.5,
                "maxDetections": 6,
                "maskPadding": 10,
                "maskBlur": 5
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/22729a97-d803-4643-acd2-281d7512311b.jpg"
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "imageMasking",
      "taskUUID": "7e9a3fb2-94b5-4520-837c-b29d1a7b8b2a",
      "model": "runware:35@1",
      "settings": {
        "confidence": 0.5,
        "maxDetections": 6,
        "maskPadding": 10,
        "maskBlur": 5
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/22729a97-d803-4643-acd2-281d7512311b.jpg"
      }
    }
  ]'
runware run runware:35@1 \
  settings.confidence=0.5 \
  settings.maxDetections=6 \
  settings.maskPadding=10 \
  settings.maskBlur=5 \
  inputs.image=https://assets.runware.ai/assets/inputs/22729a97-d803-4643-acd2-281d7512311b.jpg
{
  "taskType": "imageMasking",
  "taskUUID": "7e9a3fb2-94b5-4520-837c-b29d1a7b8b2a",
  "model": "runware:35@1",
  "settings": {
    "confidence": 0.5,
    "maxDetections": 6,
    "maskPadding": 10,
    "maskBlur": 5
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/22729a97-d803-4643-acd2-281d7512311b.jpg"
  }
}
Response
{
  "taskType": "imageMasking",
  "taskUUID": "7e9a3fb2-94b5-4520-837c-b29d1a7b8b2a",
  "maskImageURL": "https://im.runware.ai/image/os/a04d20/ws/4/ii/192c7aae-0d39-4f4e-88ae-33b908e7ff22.jpg",
  "detections": [
    {
      "x_min": 372,
      "y_min": 449,
      "x_max": 613,
      "y_max": 800
    },
    {
      "x_min": 71,
      "y_min": 306,
      "x_max": 270,
      "y_max": 567
    },
    {
      "x_min": 658,
      "y_min": 257,
      "x_max": 843,
      "y_max": 526
    }
  ],
  "cost": 0.0013,
  "maskImageUUID": "192c7aae-0d39-4f4e-88ae-33b908e7ff22"
}

face-mask

Maritime Exhibition Scene-Swap Masks$0.0006~4s
Maritime Exhibition Scene-Swap Masks
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:35@1',
  settings: {
    confidence: 0.5,
    maxDetections: 6,
    maskPadding: 10,
    maskBlur: 5
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/f299c2e8-bbc9-49cb-8487-49f2b7e4f570.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:35@1",
            "settings": {
                "confidence": 0.5,
                "maxDetections": 6,
                "maskPadding": 10,
                "maskBlur": 5
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/f299c2e8-bbc9-49cb-8487-49f2b7e4f570.jpg"
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "imageMasking",
      "taskUUID": "e9554201-d2bf-4996-a937-5af581c39e30",
      "model": "runware:35@1",
      "settings": {
        "confidence": 0.5,
        "maxDetections": 6,
        "maskPadding": 10,
        "maskBlur": 5
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/f299c2e8-bbc9-49cb-8487-49f2b7e4f570.jpg"
      }
    }
  ]'
runware run runware:35@1 \
  settings.confidence=0.5 \
  settings.maxDetections=6 \
  settings.maskPadding=10 \
  settings.maskBlur=5 \
  inputs.image=https://assets.runware.ai/assets/inputs/f299c2e8-bbc9-49cb-8487-49f2b7e4f570.jpg
{
  "taskType": "imageMasking",
  "taskUUID": "e9554201-d2bf-4996-a937-5af581c39e30",
  "model": "runware:35@1",
  "settings": {
    "confidence": 0.5,
    "maxDetections": 6,
    "maskPadding": 10,
    "maskBlur": 5
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/f299c2e8-bbc9-49cb-8487-49f2b7e4f570.jpg"
  }
}
Response
{
  "taskType": "imageMasking",
  "taskUUID": "e9554201-d2bf-4996-a937-5af581c39e30",
  "maskImageURL": "https://im.runware.ai/image/os/a08dlim3/ws/4/ii/c8287763-125a-4e89-8b4e-b893e2c47dd5.jpg",
  "detections": [
    {
      "x_min": 133,
      "y_min": 196,
      "x_max": 327,
      "y_max": 465
    },
    {
      "x_min": 777,
      "y_min": 214,
      "x_max": 932,
      "y_max": 418
    },
    {
      "x_min": 430,
      "y_min": 214,
      "x_max": 573,
      "y_max": 412
    }
  ],
  "cost": 0.0006,
  "maskImageUUID": "c8287763-125a-4e89-8b4e-b893e2c47dd5"
}

face-mask

Opera Character Makeup Try-On Masks$0.0006~3s
Opera Character Makeup Try-On Masks
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:35@1',
  settings: {
    confidence: 0.5,
    maxDetections: 6,
    maskPadding: 10,
    maskBlur: 5
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/ee0a6e64-90f5-49b3-9ad1-ea456f3b3b62.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:35@1",
            "settings": {
                "confidence": 0.5,
                "maxDetections": 6,
                "maskPadding": 10,
                "maskBlur": 5
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/ee0a6e64-90f5-49b3-9ad1-ea456f3b3b62.jpg"
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "imageMasking",
      "taskUUID": "c7ce15f4-809d-445c-93f4-ae09067a20c0",
      "model": "runware:35@1",
      "settings": {
        "confidence": 0.5,
        "maxDetections": 6,
        "maskPadding": 10,
        "maskBlur": 5
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/ee0a6e64-90f5-49b3-9ad1-ea456f3b3b62.jpg"
      }
    }
  ]'
runware run runware:35@1 \
  settings.confidence=0.5 \
  settings.maxDetections=6 \
  settings.maskPadding=10 \
  settings.maskBlur=5 \
  inputs.image=https://assets.runware.ai/assets/inputs/ee0a6e64-90f5-49b3-9ad1-ea456f3b3b62.jpg
{
  "taskType": "imageMasking",
  "taskUUID": "c7ce15f4-809d-445c-93f4-ae09067a20c0",
  "model": "runware:35@1",
  "settings": {
    "confidence": 0.5,
    "maxDetections": 6,
    "maskPadding": 10,
    "maskBlur": 5
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/ee0a6e64-90f5-49b3-9ad1-ea456f3b3b62.jpg"
  }
}
Response
{
  "taskType": "imageMasking",
  "taskUUID": "c7ce15f4-809d-445c-93f4-ae09067a20c0",
  "maskImageURL": "https://im.runware.ai/image/os/a07dlim3/ws/4/ii/23507494-3922-48a0-94c5-d5000d045f17.jpg",
  "detections": [
    {
      "x_min": 735,
      "y_min": 303,
      "x_max": 906,
      "y_max": 533
    },
    {
      "x_min": 468,
      "y_min": 94,
      "x_max": 644,
      "y_max": 334
    },
    {
      "x_min": 144,
      "y_min": 179,
      "x_max": 340,
      "y_max": 445
    },
    {
      "x_min": 469,
      "y_min": 373,
      "x_max": 671,
      "y_max": 637
    }
  ],
  "cost": 0.0006,
  "maskImageUUID": "23507494-3922-48a0-94c5-d5000d045f17"
}
Ask AI
Send feedback