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
Bicycle Workshop Candid 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@8',
settings: {
confidence: 0.72,
maxDetections: 1,
maskPadding: 14,
maskBlur: 6
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/0681ff78-ddcb-4a61-89e7-a5235428b86e.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",
"settings": {
"confidence": 0.72,
"maxDetections": 1,
"maskPadding": 14,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/0681ff78-ddcb-4a61-89e7-a5235428b86e.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": "e4dc0896-39fd-4166-8674-709787871ce2",
"model": "runware:35@8",
"settings": {
"confidence": 0.72,
"maxDetections": 1,
"maskPadding": 14,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/0681ff78-ddcb-4a61-89e7-a5235428b86e.jpg"
}
}
]'runware run runware:35@8 \
settings.confidence=0.72 \
settings.maxDetections=1 \
settings.maskPadding=14 \
settings.maskBlur=6 \
inputs.image=https://assets.runware.ai/assets/inputs/0681ff78-ddcb-4a61-89e7-a5235428b86e.jpg{
"taskType": "imageMasking",
"taskUUID": "e4dc0896-39fd-4166-8674-709787871ce2",
"model": "runware:35@8",
"settings": {
"confidence": 0.72,
"maxDetections": 1,
"maskPadding": 14,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/0681ff78-ddcb-4a61-89e7-a5235428b86e.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "e4dc0896-39fd-4166-8674-709787871ce2",
"maskImageURL": "https://im.runware.ai/image/os/a04d20/ws/4/ii/eb953b07-59de-4c78-9575-5b69b902421d.jpg",
"cost": 0.0006,
"maskImageUUID": "eb953b07-59de-4c78-9575-5b69b902421d"
}Laundromat Folding Table 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@8',
settings: {
confidence: 0.65,
maxDetections: 1,
maskPadding: 8,
maskBlur: 4
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/2658508b-df9b-4b5c-8d36-cb7bf00a1773.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",
"settings": {
"confidence": 0.65,
"maxDetections": 1,
"maskPadding": 8,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/2658508b-df9b-4b5c-8d36-cb7bf00a1773.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": "78bd0168-c60a-4a76-83e0-6480ad9c09a6",
"model": "runware:35@8",
"settings": {
"confidence": 0.65,
"maxDetections": 1,
"maskPadding": 8,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/2658508b-df9b-4b5c-8d36-cb7bf00a1773.jpg"
}
}
]'runware run runware:35@8 \
settings.confidence=0.65 \
settings.maxDetections=1 \
settings.maskPadding=8 \
settings.maskBlur=4 \
inputs.image=https://assets.runware.ai/assets/inputs/2658508b-df9b-4b5c-8d36-cb7bf00a1773.jpg{
"taskType": "imageMasking",
"taskUUID": "78bd0168-c60a-4a76-83e0-6480ad9c09a6",
"model": "runware:35@8",
"settings": {
"confidence": 0.65,
"maxDetections": 1,
"maskPadding": 8,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/2658508b-df9b-4b5c-8d36-cb7bf00a1773.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "78bd0168-c60a-4a76-83e0-6480ad9c09a6",
"maskImageURL": "https://im.runware.ai/image/os/a03d21/ws/4/ii/c8e423b5-4bf2-4c78-bc44-e094d39981c4.jpg",
"cost": 0.0006,
"maskImageUUID": "c8e423b5-4bf2-4c78-bc44-e094d39981c4"
}Harbor Net Repair 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@8',
settings: {
confidence: 0.6,
maxDetections: 1,
maskPadding: 14,
maskBlur: 6
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/90debe36-44aa-47b2-9da2-498f11855dad.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",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 14,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/90debe36-44aa-47b2-9da2-498f11855dad.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": "8511fc6a-dd03-4489-8f79-cb6a9a711595",
"model": "runware:35@8",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 14,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/90debe36-44aa-47b2-9da2-498f11855dad.jpg"
}
}
]'runware run runware:35@8 \
settings.confidence=0.6 \
settings.maxDetections=1 \
settings.maskPadding=14 \
settings.maskBlur=6 \
inputs.image=https://assets.runware.ai/assets/inputs/90debe36-44aa-47b2-9da2-498f11855dad.jpg{
"taskType": "imageMasking",
"taskUUID": "8511fc6a-dd03-4489-8f79-cb6a9a711595",
"model": "runware:35@8",
"settings": {
"confidence": 0.6,
"maxDetections": 1,
"maskPadding": 14,
"maskBlur": 6
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/90debe36-44aa-47b2-9da2-498f11855dad.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "8511fc6a-dd03-4489-8f79-cb6a9a711595",
"maskImageURL": "https://im.runware.ai/image/os/a01d21/ws/4/ii/54d87125-2dc6-4f88-b727-9f2cc1de44af.jpg",
"cost": 0.0006,
"maskImageUUID": "54d87125-2dc6-4f88-b727-9f2cc1de44af"
}Orchard Ladder Worker 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@8',
settings: {
confidence: 0.7,
maxDetections: 1,
maskPadding: 12,
maskBlur: 4
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/ec1aa745-59b1-4251-9053-245460bda241.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",
"settings": {
"confidence": 0.7,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/ec1aa745-59b1-4251-9053-245460bda241.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": "98bc255f-7ae8-452d-bdb4-8120ce3b00cb",
"model": "runware:35@8",
"settings": {
"confidence": 0.7,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/ec1aa745-59b1-4251-9053-245460bda241.jpg"
}
}
]'runware run runware:35@8 \
settings.confidence=0.7 \
settings.maxDetections=1 \
settings.maskPadding=12 \
settings.maskBlur=4 \
inputs.image=https://assets.runware.ai/assets/inputs/ec1aa745-59b1-4251-9053-245460bda241.jpg{
"taskType": "imageMasking",
"taskUUID": "98bc255f-7ae8-452d-bdb4-8120ce3b00cb",
"model": "runware:35@8",
"settings": {
"confidence": 0.7,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/ec1aa745-59b1-4251-9053-245460bda241.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "98bc255f-7ae8-452d-bdb4-8120ce3b00cb",
"maskImageURL": "https://im.runware.ai/image/os/a06dlim3/ws/4/ii/2f968367-fd7f-48ed-9b4d-c58c052f00e4.jpg",
"cost": 0.0006,
"maskImageUUID": "2f968367-fd7f-48ed-9b4d-c58c052f00e4"
}