YOLOv8s Face
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.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
face-mask
Observatory Blue-Hour Relight Face Mask$0.0006~5s
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.5,
maxDetections: 6,
maskPadding: 10,
maskBlur: 5
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/8654e669-08b9-4597-944a-b3c4c6ca5732.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.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8654e669-08b9-4597-944a-b3c4c6ca5732.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": "baa39189-2a68-4014-8736-d4d03e4e4589",
"model": "runware:35@2",
"settings": {
"confidence": 0.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8654e669-08b9-4597-944a-b3c4c6ca5732.jpg"
}
}
]'runware run runware:35@2 \
settings.confidence=0.5 \
settings.maxDetections=6 \
settings.maskPadding=10 \
settings.maskBlur=5 \
inputs.image=https://assets.runware.ai/assets/inputs/8654e669-08b9-4597-944a-b3c4c6ca5732.jpg{
"taskType": "imageMasking",
"taskUUID": "baa39189-2a68-4014-8736-d4d03e4e4589",
"model": "runware:35@2",
"settings": {
"confidence": 0.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8654e669-08b9-4597-944a-b3c4c6ca5732.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "baa39189-2a68-4014-8736-d4d03e4e4589",
"maskImageURL": "https://im.runware.ai/image/os/a03d21/ws/4/ii/72835e5a-ca5a-4bf1-9732-f51b1d2780ee.jpg",
"detections": [
{
"x_min": 384,
"y_min": 353,
"x_max": 629,
"y_max": 692
}
],
"cost": 0.0006,
"maskImageUUID": "72835e5a-ca5a-4bf1-9732-f51b1d2780ee"
}face-mask
Apiary Banner Outpaint Protection Mask$0.0006~4s
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.5,
maxDetections: 6,
maskPadding: 10,
maskBlur: 5
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/ae961193-0181-475f-93c5-511574df6d44.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.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/ae961193-0181-475f-93c5-511574df6d44.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": "f3b74715-a8ae-4ed8-add1-cef64d00ead5",
"model": "runware:35@2",
"settings": {
"confidence": 0.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/ae961193-0181-475f-93c5-511574df6d44.jpg"
}
}
]'runware run runware:35@2 \
settings.confidence=0.5 \
settings.maxDetections=6 \
settings.maskPadding=10 \
settings.maskBlur=5 \
inputs.image=https://assets.runware.ai/assets/inputs/ae961193-0181-475f-93c5-511574df6d44.jpg{
"taskType": "imageMasking",
"taskUUID": "f3b74715-a8ae-4ed8-add1-cef64d00ead5",
"model": "runware:35@2",
"settings": {
"confidence": 0.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/ae961193-0181-475f-93c5-511574df6d44.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "f3b74715-a8ae-4ed8-add1-cef64d00ead5",
"maskImageURL": "https://im.runware.ai/image/os/a03d21/ws/4/ii/84c7fcbf-1b11-4a01-b0ef-1e0de40e620d.jpg",
"detections": [
{
"x_min": 411,
"y_min": 109,
"x_max": 609,
"y_max": 374
}
],
"cost": 0.0006,
"maskImageUUID": "84c7fcbf-1b11-4a01-b0ef-1e0de40e620d"
}face-mask
Drag Revue Marquee Outpaint Mask$0.0006~4s
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.5,
maxDetections: 6,
maskPadding: 10,
maskBlur: 5
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/762aedc8-ef98-402b-af0d-e5897d837de0.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.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/762aedc8-ef98-402b-af0d-e5897d837de0.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": "cafc6658-49cb-4f3a-9917-d40223f98e3a",
"model": "runware:35@2",
"settings": {
"confidence": 0.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/762aedc8-ef98-402b-af0d-e5897d837de0.jpg"
}
}
]'runware run runware:35@2 \
settings.confidence=0.5 \
settings.maxDetections=6 \
settings.maskPadding=10 \
settings.maskBlur=5 \
inputs.image=https://assets.runware.ai/assets/inputs/762aedc8-ef98-402b-af0d-e5897d837de0.jpg{
"taskType": "imageMasking",
"taskUUID": "cafc6658-49cb-4f3a-9917-d40223f98e3a",
"model": "runware:35@2",
"settings": {
"confidence": 0.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/762aedc8-ef98-402b-af0d-e5897d837de0.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "cafc6658-49cb-4f3a-9917-d40223f98e3a",
"maskImageURL": "https://im.runware.ai/image/os/a04d20/ws/4/ii/bee6abdb-197e-4db5-9db1-b0c6ca596a03.jpg",
"detections": [
{
"x_min": 384,
"y_min": 180,
"x_max": 643,
"y_max": 521
}
],
"cost": 0.0006,
"maskImageUUID": "bee6abdb-197e-4db5-9db1-b0c6ca596a03"
}face-mask
Polar Night Expedition Face Masks$0.0019~6s
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.5,
maxDetections: 6,
maskPadding: 10,
maskBlur: 5
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/1088a10e-3046-4065-820a-6db2e798bd03.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.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1088a10e-3046-4065-820a-6db2e798bd03.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": "e27bc30f-848d-4853-a16f-6d682165d70a",
"model": "runware:35@2",
"settings": {
"confidence": 0.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1088a10e-3046-4065-820a-6db2e798bd03.jpg"
}
}
]'runware run runware:35@2 \
settings.confidence=0.5 \
settings.maxDetections=6 \
settings.maskPadding=10 \
settings.maskBlur=5 \
inputs.image=https://assets.runware.ai/assets/inputs/1088a10e-3046-4065-820a-6db2e798bd03.jpg{
"taskType": "imageMasking",
"taskUUID": "e27bc30f-848d-4853-a16f-6d682165d70a",
"model": "runware:35@2",
"settings": {
"confidence": 0.5,
"maxDetections": 6,
"maskPadding": 10,
"maskBlur": 5
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1088a10e-3046-4065-820a-6db2e798bd03.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "e27bc30f-848d-4853-a16f-6d682165d70a",
"maskImageURL": "https://im.runware.ai/image/os/a02d21/ws/4/ii/fd9e2739-4d7a-4481-8926-1332a143c450.jpg",
"detections": [
{
"x_min": 746,
"y_min": 299,
"x_max": 870,
"y_max": 461
},
{
"x_min": 586,
"y_min": 329,
"x_max": 690,
"y_max": 464
},
{
"x_min": 385,
"y_min": 308,
"x_max": 490,
"y_max": 446
},
{
"x_min": 153,
"y_min": 303,
"x_max": 274,
"y_max": 466
}
],
"cost": 0.0019,
"maskImageUUID": "fd9e2739-4d7a-4481-8926-1332a143c450"
}