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.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
Bicycle Workshop Face Masking

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.45,
maxDetections: 3,
maskPadding: 18,
maskBlur: 8
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/69b6c30e-1892-46fc-bc6b-56aef098e800.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.45,
"maxDetections": 3,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/69b6c30e-1892-46fc-bc6b-56aef098e800.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": "8b85824b-886b-4db0-ba85-ca525ed6f3fd",
"model": "runware:35@1",
"settings": {
"confidence": 0.45,
"maxDetections": 3,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/69b6c30e-1892-46fc-bc6b-56aef098e800.jpg"
}
}
]'runware run runware:35@1 \
settings.confidence=0.45 \
settings.maxDetections=3 \
settings.maskPadding=18 \
settings.maskBlur=8 \
inputs.image=https://assets.runware.ai/assets/inputs/69b6c30e-1892-46fc-bc6b-56aef098e800.jpg{
"taskType": "imageMasking",
"taskUUID": "8b85824b-886b-4db0-ba85-ca525ed6f3fd",
"model": "runware:35@1",
"settings": {
"confidence": 0.45,
"maxDetections": 3,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/69b6c30e-1892-46fc-bc6b-56aef098e800.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "8b85824b-886b-4db0-ba85-ca525ed6f3fd",
"maskImageURL": "https://im.runware.ai/image/os/a03d21/ws/4/ii/470dcc6e-3860-4b03-8938-e57fedc142b1.jpg",
"detections": [
{
"x_min": 592,
"y_min": 147,
"x_max": 708,
"y_max": 329
}
],
"cost": 0.0006,
"maskImageUUID": "470dcc6e-3860-4b03-8938-e57fedc142b1"
}Ambulance Bay Paramedic Candid

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.45,
maxDetections: 3,
maskPadding: 14,
maskBlur: 6
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/9da267b2-847a-45f6-bcab-b395b40ecfc7.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.45,
"maxDetections": 3,
"maskPadding": 14,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/9da267b2-847a-45f6-bcab-b395b40ecfc7.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": "e4bdc38a-cf9f-479d-9dd5-614007c37abd",
"model": "runware:35@1",
"settings": {
"confidence": 0.45,
"maxDetections": 3,
"maskPadding": 14,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/9da267b2-847a-45f6-bcab-b395b40ecfc7.jpg"
}
}
]'runware run runware:35@1 \
settings.confidence=0.45 \
settings.maxDetections=3 \
settings.maskPadding=14 \
settings.maskBlur=6 \
inputs.image=https://assets.runware.ai/assets/inputs/9da267b2-847a-45f6-bcab-b395b40ecfc7.jpg{
"taskType": "imageMasking",
"taskUUID": "e4bdc38a-cf9f-479d-9dd5-614007c37abd",
"model": "runware:35@1",
"settings": {
"confidence": 0.45,
"maxDetections": 3,
"maskPadding": 14,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/9da267b2-847a-45f6-bcab-b395b40ecfc7.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "e4bdc38a-cf9f-479d-9dd5-614007c37abd",
"maskImageURL": "https://im.runware.ai/image/os/a02d21/ws/4/ii/5d7ca866-c99b-40ee-a641-6845b5019043.jpg",
"detections": [
{
"x_min": 398,
"y_min": 218,
"x_max": 459,
"y_max": 304
}
],
"cost": 0.0006,
"maskImageUUID": "5d7ca866-c99b-40ee-a641-6845b5019043"
}University Archive Aisle Candid

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.45,
maxDetections: 1,
maskPadding: 18,
maskBlur: 6
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/5b677568-0244-4797-8501-fb878212d8e2.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.45,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/5b677568-0244-4797-8501-fb878212d8e2.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": "3bb0bb10-a032-40e8-a4e8-2bca860ab61e",
"model": "runware:35@1",
"settings": {
"confidence": 0.45,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/5b677568-0244-4797-8501-fb878212d8e2.jpg"
}
}
]'runware run runware:35@1 \
settings.confidence=0.45 \
settings.maxDetections=1 \
settings.maskPadding=18 \
settings.maskBlur=6 \
inputs.image=https://assets.runware.ai/assets/inputs/5b677568-0244-4797-8501-fb878212d8e2.jpg{
"taskType": "imageMasking",
"taskUUID": "3bb0bb10-a032-40e8-a4e8-2bca860ab61e",
"model": "runware:35@1",
"settings": {
"confidence": 0.45,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/5b677568-0244-4797-8501-fb878212d8e2.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "3bb0bb10-a032-40e8-a4e8-2bca860ab61e",
"maskImageURL": "https://im.runware.ai/image/os/a10dlim3/ws/4/ii/47a2ab1f-c49b-49c2-9739-81d04a187fbe.jpg",
"detections": [
{
"x_min": 464,
"y_min": 272,
"x_max": 552,
"y_max": 382
}
],
"cost": 0.0006,
"maskImageUUID": "47a2ab1f-c49b-49c2-9739-81d04a187fbe"
}Train Platform Commuter 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@1',
settings: {
confidence: 0.45,
maxDetections: 1,
maskPadding: 18,
maskBlur: 6
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/c9053d9c-4bea-499f-9b33-1efd0c55586e.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.45,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/c9053d9c-4bea-499f-9b33-1efd0c55586e.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": "12d697b8-b8f0-4f77-b083-512beb0d5ee4",
"model": "runware:35@1",
"settings": {
"confidence": 0.45,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/c9053d9c-4bea-499f-9b33-1efd0c55586e.jpg"
}
}
]'runware run runware:35@1 \
settings.confidence=0.45 \
settings.maxDetections=1 \
settings.maskPadding=18 \
settings.maskBlur=6 \
inputs.image=https://assets.runware.ai/assets/inputs/c9053d9c-4bea-499f-9b33-1efd0c55586e.jpg{
"taskType": "imageMasking",
"taskUUID": "12d697b8-b8f0-4f77-b083-512beb0d5ee4",
"model": "runware:35@1",
"settings": {
"confidence": 0.45,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/c9053d9c-4bea-499f-9b33-1efd0c55586e.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "12d697b8-b8f0-4f77-b083-512beb0d5ee4",
"maskImageURL": "https://im.runware.ai/image/os/a07dlim3/ws/4/ii/d4a55ad9-25f5-407e-860c-911196ab0b71.jpg",
"detections": [
{
"x_min": 636,
"y_min": 250,
"x_max": 714,
"y_max": 340
}
],
"cost": 0.0006,
"maskImageUUID": "d4a55ad9-25f5-407e-860c-911196ab0b71"
}