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
face-mask
Linocut Dance Portrait Face 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@7',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/d2ae110d-b0a0-4b3e-aa97-5f19ab42c302.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",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/d2ae110d-b0a0-4b3e-aa97-5f19ab42c302.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": "a8e86f10-d9c9-4f15-b41f-b621053fae61",
"model": "runware:35@7",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/d2ae110d-b0a0-4b3e-aa97-5f19ab42c302.jpg"
}
}
]'runware run runware:35@7 \
inputs.image=https://assets.runware.ai/assets/inputs/d2ae110d-b0a0-4b3e-aa97-5f19ab42c302.jpg{
"taskType": "imageMasking",
"taskUUID": "a8e86f10-d9c9-4f15-b41f-b621053fae61",
"model": "runware:35@7",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/d2ae110d-b0a0-4b3e-aa97-5f19ab42c302.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "a8e86f10-d9c9-4f15-b41f-b621053fae61",
"maskImageURL": "https://im.runware.ai/image/os/a09dlim3/ws/4/ii/0dd92e42-a820-4646-b41e-ec11830c9915.jpg",
"cost": 0.0006,
"maskImageUUID": "0dd92e42-a820-4646-b41e-ec11830c9915"
}face-mask
Polar Research Banner Expansion 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@7',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/6da41aa3-bce4-4006-bcfd-50011b55097f.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",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6da41aa3-bce4-4006-bcfd-50011b55097f.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": "15e03c95-8666-4fd9-a60a-9540ca2d1353",
"model": "runware:35@7",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6da41aa3-bce4-4006-bcfd-50011b55097f.jpg"
}
}
]'runware run runware:35@7 \
inputs.image=https://assets.runware.ai/assets/inputs/6da41aa3-bce4-4006-bcfd-50011b55097f.jpg{
"taskType": "imageMasking",
"taskUUID": "15e03c95-8666-4fd9-a60a-9540ca2d1353",
"model": "runware:35@7",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6da41aa3-bce4-4006-bcfd-50011b55097f.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "15e03c95-8666-4fd9-a60a-9540ca2d1353",
"maskImageURL": "https://im.runware.ai/image/os/a07dlim3/ws/4/ii/d8209777-f75a-46f7-ad45-7a30d8580c85.jpg",
"cost": 0.0006,
"maskImageUUID": "d8209777-f75a-46f7-ad45-7a30d8580c85"
}face-mask
Racing Helmet Virtual Try-On 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@7',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/24aaada5-ae64-4086-9809-3ce4c0ecc4ef.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",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/24aaada5-ae64-4086-9809-3ce4c0ecc4ef.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": "323b6fc2-9e15-4229-bbc7-f38f499babe0",
"model": "runware:35@7",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/24aaada5-ae64-4086-9809-3ce4c0ecc4ef.jpg"
}
}
]'runware run runware:35@7 \
inputs.image=https://assets.runware.ai/assets/inputs/24aaada5-ae64-4086-9809-3ce4c0ecc4ef.jpg{
"taskType": "imageMasking",
"taskUUID": "323b6fc2-9e15-4229-bbc7-f38f499babe0",
"model": "runware:35@7",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/24aaada5-ae64-4086-9809-3ce4c0ecc4ef.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "323b6fc2-9e15-4229-bbc7-f38f499babe0",
"maskImageURL": "https://im.runware.ai/image/os/a03d21/ws/4/ii/92a6ba7a-05bc-4957-a946-1eadd175a824.jpg",
"cost": 0.0006,
"maskImageUUID": "92a6ba7a-05bc-4957-a946-1eadd175a824"
}face-mask
Clinical Training Privacy Mask$0.0006~3s
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',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/dc6809b6-4a67-4fc4-863c-c6e16492d54d.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",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/dc6809b6-4a67-4fc4-863c-c6e16492d54d.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": "9ae05adf-c239-4598-b862-ca4b1b21066f",
"model": "runware:35@7",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/dc6809b6-4a67-4fc4-863c-c6e16492d54d.jpg"
}
}
]'runware run runware:35@7 \
inputs.image=https://assets.runware.ai/assets/inputs/dc6809b6-4a67-4fc4-863c-c6e16492d54d.jpg{
"taskType": "imageMasking",
"taskUUID": "9ae05adf-c239-4598-b862-ca4b1b21066f",
"model": "runware:35@7",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/dc6809b6-4a67-4fc4-863c-c6e16492d54d.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "9ae05adf-c239-4598-b862-ca4b1b21066f",
"maskImageURL": "https://im.runware.ai/image/os/a04d20/ws/4/ii/2682b0c9-489f-4d2c-b53a-75378d039f56.jpg",
"cost": 0.0006,
"maskImageUUID": "2682b0c9-489f-4d2c-b53a-75378d039f56"
}