YOLOv8s Face

January 10, 2023

YOLOv8s Face is a face-focused image masking model that detects realistic 2D faces and produces black-and-white masks for each matched region. Compared with smaller variants, it is better suited to workflows that need stronger detection accuracy and cleaner face coverage.

Mask

Harbor Ferry Deck Snapshot

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@2',
  settings: {
    confidence: 0.45,
    maxDetections: 3,
    maskPadding: 14,
    maskBlur: 4
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/38837c23-1b72-4322-8465-ec950f83e2ad.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@2",
            "settings": {
                "confidence": 0.45,
                "maxDetections": 3,
                "maskPadding": 14,
                "maskBlur": 4
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/38837c23-1b72-4322-8465-ec950f83e2ad.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": "17c7c34b-4efb-4653-8d3d-cb8b767a2fde",
      "model": "runware:35@2",
      "settings": {
        "confidence": 0.45,
        "maxDetections": 3,
        "maskPadding": 14,
        "maskBlur": 4
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/38837c23-1b72-4322-8465-ec950f83e2ad.jpg"
      }
    }
  ]'

runware run runware:35@2 \
  settings.confidence=0.45 \
  settings.maxDetections=3 \
  settings.maskPadding=14 \
  settings.maskBlur=4 \
  inputs.image=https://assets.runware.ai/assets/inputs/38837c23-1b72-4322-8465-ec950f83e2ad.jpg

{
  "taskType": "imageMasking",
  "taskUUID": "17c7c34b-4efb-4653-8d3d-cb8b767a2fde",
  "model": "runware:35@2",
  "settings": {
    "confidence": 0.45,
    "maxDetections": 3,
    "maskPadding": 14,
    "maskBlur": 4
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/38837c23-1b72-4322-8465-ec950f83e2ad.jpg"
  }
}

Response

{
  "taskType": "imageMasking",
  "taskUUID": "17c7c34b-4efb-4653-8d3d-cb8b767a2fde",
  "maskImageURL": "https://im.runware.ai/image/os/a08dlim3/ws/4/ii/99e456fa-0c2c-40e6-b756-b78f1c0f89dc.jpg",
  "detections": [
    {
      "x_min": 430,
      "y_min": 140,
      "x_max": 575,
      "y_max": 320
    }
  ],
  "cost": 0.0006,
  "maskImageUUID": "99e456fa-0c2c-40e6-b756-b78f1c0f89dc"
}

Mask

Airfield Ground Crew Snapshot

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@2',
  settings: {
    confidence: 0.55,
    maxDetections: 3,
    maskPadding: 16,
    maskBlur: 6
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/0b3eee51-6693-46d2-9211-2150b6159121.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@2",
            "settings": {
                "confidence": 0.55,
                "maxDetections": 3,
                "maskPadding": 16,
                "maskBlur": 6
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/0b3eee51-6693-46d2-9211-2150b6159121.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": "a9e1ed3d-7f80-45f3-b671-0c80fe54467a",
      "model": "runware:35@2",
      "settings": {
        "confidence": 0.55,
        "maxDetections": 3,
        "maskPadding": 16,
        "maskBlur": 6
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/0b3eee51-6693-46d2-9211-2150b6159121.jpg"
      }
    }
  ]'

runware run runware:35@2 \
  settings.confidence=0.55 \
  settings.maxDetections=3 \
  settings.maskPadding=16 \
  settings.maskBlur=6 \
  inputs.image=https://assets.runware.ai/assets/inputs/0b3eee51-6693-46d2-9211-2150b6159121.jpg

{
  "taskType": "imageMasking",
  "taskUUID": "a9e1ed3d-7f80-45f3-b671-0c80fe54467a",
  "model": "runware:35@2",
  "settings": {
    "confidence": 0.55,
    "maxDetections": 3,
    "maskPadding": 16,
    "maskBlur": 6
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/0b3eee51-6693-46d2-9211-2150b6159121.jpg"
  }
}

Response

{
  "taskType": "imageMasking",
  "taskUUID": "a9e1ed3d-7f80-45f3-b671-0c80fe54467a",
  "maskImageURL": "https://im.runware.ai/image/os/a01d21/ws/4/ii/fd5c8c41-972e-46fb-bb04-49314978e606.jpg",
  "detections": [
    {
      "x_min": 353,
      "y_min": 103,
      "x_max": 461,
      "y_max": 240
    }
  ],
  "cost": 0.0006,
  "maskImageUUID": "fd5c8c41-972e-46fb-bb04-49314978e606"
}

Mask

Station Platform Candid Face Mask

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@2',
  settings: {
    confidence: 0.55,
    maxDetections: 5,
    maskPadding: 12,
    maskBlur: 4
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/aa783214-5104-4beb-9423-1833693e0fdb.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@2",
            "settings": {
                "confidence": 0.55,
                "maxDetections": 5,
                "maskPadding": 12,
                "maskBlur": 4
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/aa783214-5104-4beb-9423-1833693e0fdb.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": "8c7626cb-dac8-48c9-8b4e-6350ab64555a",
      "model": "runware:35@2",
      "settings": {
        "confidence": 0.55,
        "maxDetections": 5,
        "maskPadding": 12,
        "maskBlur": 4
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/aa783214-5104-4beb-9423-1833693e0fdb.jpg"
      }
    }
  ]'

runware run runware:35@2 \
  settings.confidence=0.55 \
  settings.maxDetections=5 \
  settings.maskPadding=12 \
  settings.maskBlur=4 \
  inputs.image=https://assets.runware.ai/assets/inputs/aa783214-5104-4beb-9423-1833693e0fdb.jpg

{
  "taskType": "imageMasking",
  "taskUUID": "8c7626cb-dac8-48c9-8b4e-6350ab64555a",
  "model": "runware:35@2",
  "settings": {
    "confidence": 0.55,
    "maxDetections": 5,
    "maskPadding": 12,
    "maskBlur": 4
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/aa783214-5104-4beb-9423-1833693e0fdb.jpg"
  }
}

Response

{
  "taskType": "imageMasking",
  "taskUUID": "8c7626cb-dac8-48c9-8b4e-6350ab64555a",
  "maskImageURL": "https://im.runware.ai/image/os/a04d20/ws/4/ii/34ac588d-0d8a-4120-8062-5fdd79625e0c.jpg",
  "detections": [
    {
      "x_min": 498,
      "y_min": 250,
      "x_max": 561,
      "y_max": 328
    },
    {
      "x_min": 373,
      "y_min": 375,
      "x_max": 414,
      "y_max": 420
    },
    {
      "x_min": 335,
      "y_min": 368,
      "x_max": 381,
      "y_max": 420
    },
    {
      "x_min": 304,
      "y_min": 393,
      "x_max": 353,
      "y_max": 439
    }
  ],
  "cost": 0.0006,
  "maskImageUUID": "34ac588d-0d8a-4120-8062-5fdd79625e0c"
}

Mask

Ceramics Workshop Documentary Snapshot

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@2',
  settings: {
    confidence: 0.45,
    maxDetections: 3,
    maskPadding: 14,
    maskBlur: 6
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/c2703d9a-7a58-442c-a58c-942f46ae49c0.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@2",
            "settings": {
                "confidence": 0.45,
                "maxDetections": 3,
                "maskPadding": 14,
                "maskBlur": 6
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/c2703d9a-7a58-442c-a58c-942f46ae49c0.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": "dae2bcbd-e049-4df8-94e7-e0572127914a",
      "model": "runware:35@2",
      "settings": {
        "confidence": 0.45,
        "maxDetections": 3,
        "maskPadding": 14,
        "maskBlur": 6
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/c2703d9a-7a58-442c-a58c-942f46ae49c0.jpg"
      }
    }
  ]'

runware run runware:35@2 \
  settings.confidence=0.45 \
  settings.maxDetections=3 \
  settings.maskPadding=14 \
  settings.maskBlur=6 \
  inputs.image=https://assets.runware.ai/assets/inputs/c2703d9a-7a58-442c-a58c-942f46ae49c0.jpg

{
  "taskType": "imageMasking",
  "taskUUID": "dae2bcbd-e049-4df8-94e7-e0572127914a",
  "model": "runware:35@2",
  "settings": {
    "confidence": 0.45,
    "maxDetections": 3,
    "maskPadding": 14,
    "maskBlur": 6
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/c2703d9a-7a58-442c-a58c-942f46ae49c0.jpg"
  }
}

Response

{
  "taskType": "imageMasking",
  "taskUUID": "dae2bcbd-e049-4df8-94e7-e0572127914a",
  "maskImageURL": "https://im.runware.ai/image/os/a09dlim3/ws/4/ii/e5e3a232-b269-4b7d-b504-b8f428551874.jpg",
  "detections": [
    {
      "x_min": 228,
      "y_min": 144,
      "x_max": 353,
      "y_max": 296
    }
  ],
  "cost": 0.0006,
  "maskImageUUID": "e5e3a232-b269-4b7d-b504-b8f428551874"
}