YOLOv8n Person Seg
YOLOv8n Person Seg is a lightweight person segmentation model that generates black-and-white masks for detected people in an image. It is useful for subject-isolated inpainting, person-targeted enhancement, and automated mask generation where speed and low compute cost matter.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
Riverside Kayak Launch Assistant

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@4',
settings: {
confidence: 0.55,
maxDetections: 1,
maskPadding: 12,
maskBlur: 4
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/0d4cfdce-2df0-4cac-b229-c6d1fabe5c9e.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@4",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/0d4cfdce-2df0-4cac-b229-c6d1fabe5c9e.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": "e441ed66-e40b-4426-a8e6-0437af64be5b",
"model": "runware:35@4",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/0d4cfdce-2df0-4cac-b229-c6d1fabe5c9e.jpg"
}
}
]'runware run runware:35@4 \
settings.confidence=0.55 \
settings.maxDetections=1 \
settings.maskPadding=12 \
settings.maskBlur=4 \
inputs.image=https://assets.runware.ai/assets/inputs/0d4cfdce-2df0-4cac-b229-c6d1fabe5c9e.jpg{
"taskType": "imageMasking",
"taskUUID": "e441ed66-e40b-4426-a8e6-0437af64be5b",
"model": "runware:35@4",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/0d4cfdce-2df0-4cac-b229-c6d1fabe5c9e.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "e441ed66-e40b-4426-a8e6-0437af64be5b",
"maskImageURL": "https://im.runware.ai/image/os/a07dlim3/ws/4/ii/faf49cef-d4c5-4580-a5b8-40c9d210171e.jpg",
"detections": [
{
"x_min": 445,
"y_min": 226,
"x_max": 731,
"y_max": 614
}
],
"cost": 0.0006,
"maskImageUUID": "faf49cef-d4c5-4580-a5b8-40c9d210171e"
}Urban Crosswalk Courier 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@4',
settings: {
confidence: 0.55,
maxDetections: 1,
maskPadding: 12,
maskBlur: 4
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/980e9070-00fb-44b1-bcd1-5de4ddf708c7.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@4",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/980e9070-00fb-44b1-bcd1-5de4ddf708c7.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": "e2f674d1-8bec-4435-a6d2-e88eb4b3c212",
"model": "runware:35@4",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/980e9070-00fb-44b1-bcd1-5de4ddf708c7.jpg"
}
}
]'runware run runware:35@4 \
settings.confidence=0.55 \
settings.maxDetections=1 \
settings.maskPadding=12 \
settings.maskBlur=4 \
inputs.image=https://assets.runware.ai/assets/inputs/980e9070-00fb-44b1-bcd1-5de4ddf708c7.jpg{
"taskType": "imageMasking",
"taskUUID": "e2f674d1-8bec-4435-a6d2-e88eb4b3c212",
"model": "runware:35@4",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/980e9070-00fb-44b1-bcd1-5de4ddf708c7.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "e2f674d1-8bec-4435-a6d2-e88eb4b3c212",
"maskImageURL": "https://im.runware.ai/image/os/a09dlim3/ws/4/ii/a4c4b0be-760d-4b59-9f84-16066bd6a548.jpg",
"detections": [
{
"x_min": 487,
"y_min": 137,
"x_max": 779,
"y_max": 731
}
],
"cost": 0.0006,
"maskImageUUID": "a4c4b0be-760d-4b59-9f84-16066bd6a548"
}Snowy Rail Yard Signal Worker

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@4',
settings: {
confidence: 0.55,
maxDetections: 1,
maskPadding: 12,
maskBlur: 4
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/f8c12097-61d8-4ce4-942b-9220906836eb.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@4",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/f8c12097-61d8-4ce4-942b-9220906836eb.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": "f3d17055-7281-45b2-a2c2-6262688ca4a6",
"model": "runware:35@4",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/f8c12097-61d8-4ce4-942b-9220906836eb.jpg"
}
}
]'runware run runware:35@4 \
settings.confidence=0.55 \
settings.maxDetections=1 \
settings.maskPadding=12 \
settings.maskBlur=4 \
inputs.image=https://assets.runware.ai/assets/inputs/f8c12097-61d8-4ce4-942b-9220906836eb.jpg{
"taskType": "imageMasking",
"taskUUID": "f3d17055-7281-45b2-a2c2-6262688ca4a6",
"model": "runware:35@4",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/f8c12097-61d8-4ce4-942b-9220906836eb.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "f3d17055-7281-45b2-a2c2-6262688ca4a6",
"maskImageURL": "https://im.runware.ai/image/os/a01d21/ws/4/ii/bdd6aced-592b-4608-8803-96ae6a0efc37.jpg",
"detections": [
{
"x_min": 501,
"y_min": 190,
"x_max": 742,
"y_max": 752
}
],
"cost": 0.0006,
"maskImageUUID": "bdd6aced-592b-4608-8803-96ae6a0efc37"
}Bouldering Gym Route Setter

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@4',
settings: {
confidence: 0.45,
maxDetections: 1,
maskPadding: 12,
maskBlur: 4
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/2a0c70a8-8036-4fa7-8967-28db6b41012d.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@4",
"settings": {
"confidence": 0.45,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/2a0c70a8-8036-4fa7-8967-28db6b41012d.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": "192e6981-99a2-45c9-ac1c-76a7657b08cd",
"model": "runware:35@4",
"settings": {
"confidence": 0.45,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/2a0c70a8-8036-4fa7-8967-28db6b41012d.jpg"
}
}
]'runware run runware:35@4 \
settings.confidence=0.45 \
settings.maxDetections=1 \
settings.maskPadding=12 \
settings.maskBlur=4 \
inputs.image=https://assets.runware.ai/assets/inputs/2a0c70a8-8036-4fa7-8967-28db6b41012d.jpg{
"taskType": "imageMasking",
"taskUUID": "192e6981-99a2-45c9-ac1c-76a7657b08cd",
"model": "runware:35@4",
"settings": {
"confidence": 0.45,
"maxDetections": 1,
"maskPadding": 12,
"maskBlur": 4
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/2a0c70a8-8036-4fa7-8967-28db6b41012d.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "192e6981-99a2-45c9-ac1c-76a7657b08cd",
"maskImageURL": "https://im.runware.ai/image/os/a04d20/ws/4/ii/4dbc6774-7a32-4640-b04c-eb2bc631e2a0.jpg",
"detections": [
{
"x_min": 421,
"y_min": 167,
"x_max": 689,
"y_max": 739
}
],
"cost": 0.0006,
"maskImageUUID": "4dbc6774-7a32-4640-b04c-eb2bc631e2a0"
}