MediaPipe Face Short
MediaPipe Face Short is an image masking model optimized for short-range realistic face detection. It returns black-and-white masks around nearby faces and is a practical fit for portrait images, selfies, and other close-frame facial masking workflows.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
Candid Bicycle Repair 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@7',
settings: {
confidence: 0.6,
maxDetections: 1,
maskPadding: 24,
maskBlur: 8
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/7fa107b8-1ebf-4b44-9451-2daf20d8962f.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@7",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 24,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7fa107b8-1ebf-4b44-9451-2daf20d8962f.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": "48fe297d-ce3e-4028-9aed-829b6753163f",
"model": "runware:35@7",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 24,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7fa107b8-1ebf-4b44-9451-2daf20d8962f.jpg"
}
}
]'runware run runware:35@7 \
settings.confidence=0.6 \
settings.maxDetections=1 \
settings.maskPadding=24 \
settings.maskBlur=8 \
inputs.image=https://assets.runware.ai/assets/inputs/7fa107b8-1ebf-4b44-9451-2daf20d8962f.jpg{
"taskType": "imageMasking",
"taskUUID": "48fe297d-ce3e-4028-9aed-829b6753163f",
"model": "runware:35@7",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 24,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7fa107b8-1ebf-4b44-9451-2daf20d8962f.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "48fe297d-ce3e-4028-9aed-829b6753163f",
"maskImageURL": "https://im.runware.ai/image/os/a06dlim3/ws/4/ii/c4833ca7-fa39-4333-a9c2-4d508bf4a3bc.jpg",
"cost": 0.0006,
"maskImageUUID": "c4833ca7-fa39-4333-a9c2-4d508bf4a3bc"
}Laundromat Folding Table 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@7',
settings: {
confidence: 0.6,
maxDetections: 1,
maskPadding: 18,
maskBlur: 8
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/b14ee70a-3c17-4690-af65-5172ff9c5dd4.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@7",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/b14ee70a-3c17-4690-af65-5172ff9c5dd4.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": "e5d91578-711f-4f69-9495-a67eca814dbd",
"model": "runware:35@7",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/b14ee70a-3c17-4690-af65-5172ff9c5dd4.jpg"
}
}
]'runware run runware:35@7 \
settings.confidence=0.6 \
settings.maxDetections=1 \
settings.maskPadding=18 \
settings.maskBlur=8 \
inputs.image=https://assets.runware.ai/assets/inputs/b14ee70a-3c17-4690-af65-5172ff9c5dd4.jpg{
"taskType": "imageMasking",
"taskUUID": "e5d91578-711f-4f69-9495-a67eca814dbd",
"model": "runware:35@7",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/b14ee70a-3c17-4690-af65-5172ff9c5dd4.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "e5d91578-711f-4f69-9495-a67eca814dbd",
"maskImageURL": "https://im.runware.ai/image/os/a07dlim3/ws/4/ii/6da6f3a4-7fbf-4319-8b5a-461274f43b05.jpg",
"cost": 0.0006,
"maskImageUUID": "6da6f3a4-7fbf-4319-8b5a-461274f43b05"
}Ceramics Studio Glaze Table

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@7',
settings: {
confidence: 0.65,
maxDetections: 1,
maskPadding: 18,
maskBlur: 8
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/c68d7f1b-b4a0-4cd5-8a40-4385f975bc74.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@7",
"settings": {
"confidence": 0.65,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/c68d7f1b-b4a0-4cd5-8a40-4385f975bc74.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": "6a4a206a-c532-49ac-9a84-e833022b5fbc",
"model": "runware:35@7",
"settings": {
"confidence": 0.65,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/c68d7f1b-b4a0-4cd5-8a40-4385f975bc74.jpg"
}
}
]'runware run runware:35@7 \
settings.confidence=0.65 \
settings.maxDetections=1 \
settings.maskPadding=18 \
settings.maskBlur=8 \
inputs.image=https://assets.runware.ai/assets/inputs/c68d7f1b-b4a0-4cd5-8a40-4385f975bc74.jpg{
"taskType": "imageMasking",
"taskUUID": "6a4a206a-c532-49ac-9a84-e833022b5fbc",
"model": "runware:35@7",
"settings": {
"confidence": 0.65,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/c68d7f1b-b4a0-4cd5-8a40-4385f975bc74.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "6a4a206a-c532-49ac-9a84-e833022b5fbc",
"maskImageURL": "https://im.runware.ai/image/os/a01d21/ws/4/ii/772fd5c4-0725-4378-b86c-26151343a69c.jpg",
"cost": 0.0006,
"maskImageUUID": "772fd5c4-0725-4378-b86c-26151343a69c"
}Candid Bakery Prep Frame

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@7',
settings: {
confidence: 0.6,
maxDetections: 1,
maskPadding: 18,
maskBlur: 8
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/43228de3-125f-4bef-a825-7c05e66725a0.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@7",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/43228de3-125f-4bef-a825-7c05e66725a0.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": "dd56940b-cc2b-411e-9cd4-af69373703d4",
"model": "runware:35@7",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/43228de3-125f-4bef-a825-7c05e66725a0.jpg"
}
}
]'runware run runware:35@7 \
settings.confidence=0.6 \
settings.maxDetections=1 \
settings.maskPadding=18 \
settings.maskBlur=8 \
inputs.image=https://assets.runware.ai/assets/inputs/43228de3-125f-4bef-a825-7c05e66725a0.jpg{
"taskType": "imageMasking",
"taskUUID": "dd56940b-cc2b-411e-9cd4-af69373703d4",
"model": "runware:35@7",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 18,
"maskBlur": 8
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/43228de3-125f-4bef-a825-7c05e66725a0.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "dd56940b-cc2b-411e-9cd4-af69373703d4",
"maskImageURL": "https://im.runware.ai/image/os/a02d21/ws/4/ii/731c7cf1-e38d-4076-9099-02244da71843.jpg",
"cost": 0.0006,
"maskImageUUID": "731c7cf1-e38d-4076-9099-02244da71843"
}