MediaPipe Face Mesh
MediaPipe Face Mesh is a face masking model built on dense facial landmark topology. It produces black-and-white masks with more contour awareness than simple bounding-box detectors, making it useful for precision face inpainting, facial retouching, and detail enhancement pipelines.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
face-mask
Roller Derby Archive 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@8',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/7269eff5-7a02-45b7-b73d-3e081443fb9f.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@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7269eff5-7a02-45b7-b73d-3e081443fb9f.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": "f967289d-7854-48d1-a46e-639dd4d42c12",
"model": "runware:35@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7269eff5-7a02-45b7-b73d-3e081443fb9f.jpg"
}
}
]'runware run runware:35@8 \
inputs.image=https://assets.runware.ai/assets/inputs/7269eff5-7a02-45b7-b73d-3e081443fb9f.jpg{
"taskType": "imageMasking",
"taskUUID": "f967289d-7854-48d1-a46e-639dd4d42c12",
"model": "runware:35@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7269eff5-7a02-45b7-b73d-3e081443fb9f.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "f967289d-7854-48d1-a46e-639dd4d42c12",
"maskImageURL": "https://im.runware.ai/image/os/a02d21/ws/4/ii/b1d1bf95-4a2b-413c-8efe-3f96106f0c84.jpg",
"cost": 0.0006,
"maskImageUUID": "b1d1bf95-4a2b-413c-8efe-3f96106f0c84"
}face-mask
Opera Key Art Face Holdout$0.0013~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@8',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/2fc4db43-d71f-43b2-a661-9fe0fede97ba.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@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/2fc4db43-d71f-43b2-a661-9fe0fede97ba.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": "84011664-8da9-4a53-ae2b-c317add478b7",
"model": "runware:35@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/2fc4db43-d71f-43b2-a661-9fe0fede97ba.jpg"
}
}
]'runware run runware:35@8 \
inputs.image=https://assets.runware.ai/assets/inputs/2fc4db43-d71f-43b2-a661-9fe0fede97ba.jpg{
"taskType": "imageMasking",
"taskUUID": "84011664-8da9-4a53-ae2b-c317add478b7",
"model": "runware:35@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/2fc4db43-d71f-43b2-a661-9fe0fede97ba.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "84011664-8da9-4a53-ae2b-c317add478b7",
"maskImageURL": "https://im.runware.ai/image/os/a04d20/ws/4/ii/cdc3a82f-33e6-40b7-8e02-7e9e85bbf744.jpg",
"cost": 0.0013,
"maskImageUUID": "cdc3a82f-33e6-40b7-8e02-7e9e85bbf744"
}face-mask
Emergency Interpreter Composite 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@8',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/f2777ffe-2e14-4545-8bb9-d9e931887920.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@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/f2777ffe-2e14-4545-8bb9-d9e931887920.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": "29999a28-ad96-4fda-b680-5789e420531e",
"model": "runware:35@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/f2777ffe-2e14-4545-8bb9-d9e931887920.jpg"
}
}
]'runware run runware:35@8 \
inputs.image=https://assets.runware.ai/assets/inputs/f2777ffe-2e14-4545-8bb9-d9e931887920.jpg{
"taskType": "imageMasking",
"taskUUID": "29999a28-ad96-4fda-b680-5789e420531e",
"model": "runware:35@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/f2777ffe-2e14-4545-8bb9-d9e931887920.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "29999a28-ad96-4fda-b680-5789e420531e",
"maskImageURL": "https://im.runware.ai/image/os/a02d21/ws/4/ii/de4f0d53-1e4f-4ebf-9794-a7064d2057a1.jpg",
"cost": 0.0006,
"maskImageUUID": "de4f0d53-1e4f-4ebf-9794-a7064d2057a1"
}face-mask
Planetarium Director Headshot Retouch 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@8',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/8c23b676-e151-420b-9c8b-acb00e619b96.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@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8c23b676-e151-420b-9c8b-acb00e619b96.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": "0c5d0b0a-555f-4c16-9a42-4b245741977e",
"model": "runware:35@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8c23b676-e151-420b-9c8b-acb00e619b96.jpg"
}
}
]'runware run runware:35@8 \
inputs.image=https://assets.runware.ai/assets/inputs/8c23b676-e151-420b-9c8b-acb00e619b96.jpg{
"taskType": "imageMasking",
"taskUUID": "0c5d0b0a-555f-4c16-9a42-4b245741977e",
"model": "runware:35@8",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8c23b676-e151-420b-9c8b-acb00e619b96.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "0c5d0b0a-555f-4c16-9a42-4b245741977e",
"maskImageURL": "https://im.runware.ai/image/os/a10dlim3/ws/4/ii/af3f1ce9-71dc-4bac-a02f-dd07216469e4.jpg",
"cost": 0.0006,
"maskImageUUID": "af3f1ce9-71dc-4bac-a02f-dd07216469e4"
}