YOLOv8s Person Seg
YOLOv8s Person Seg is a person segmentation model that produces black-and-white masks for detected human subjects with stronger precision than smaller variants. It is better suited to workflows that need cleaner subject contours for inpainting, compositing, or detail enhancement.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
Airport Terminal Traveler Scene

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@5',
settings: {
confidence: 0.45,
maxDetections: 8,
maskPadding: 8,
maskBlur: 3
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/7d61c626-0a15-4315-8598-a55188b83d65.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@5",
"settings": {
"confidence": 0.45,
"maxDetections": 8,
"maskPadding": 8,
"maskBlur": 3
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7d61c626-0a15-4315-8598-a55188b83d65.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": "3e54961a-33a9-4f12-89a1-57df77252920",
"model": "runware:35@5",
"settings": {
"confidence": 0.45,
"maxDetections": 8,
"maskPadding": 8,
"maskBlur": 3
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7d61c626-0a15-4315-8598-a55188b83d65.jpg"
}
}
]'runware run runware:35@5 \
settings.confidence=0.45 \
settings.maxDetections=8 \
settings.maskPadding=8 \
settings.maskBlur=3 \
inputs.image=https://assets.runware.ai/assets/inputs/7d61c626-0a15-4315-8598-a55188b83d65.jpg{
"taskType": "imageMasking",
"taskUUID": "3e54961a-33a9-4f12-89a1-57df77252920",
"model": "runware:35@5",
"settings": {
"confidence": 0.45,
"maxDetections": 8,
"maskPadding": 8,
"maskBlur": 3
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7d61c626-0a15-4315-8598-a55188b83d65.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "3e54961a-33a9-4f12-89a1-57df77252920",
"maskImageURL": "https://im.runware.ai/image/os/a02d21/ws/4/ii/d060282c-5c8f-4a9e-b74f-15f01b499ee4.jpg",
"detections": [
{
"x_min": 277,
"y_min": 105,
"x_max": 528,
"y_max": 720
},
{
"x_min": 1126,
"y_min": 286,
"x_max": 1213,
"y_max": 465
},
{
"x_min": 1010,
"y_min": 305,
"x_max": 1073,
"y_max": 439
},
{
"x_min": 933,
"y_min": 297,
"x_max": 1000,
"y_max": 440
},
{
"x_min": 682,
"y_min": 295,
"x_max": 752,
"y_max": 438
},
{
"x_min": 184,
"y_min": 299,
"x_max": 233,
"y_max": 420
},
{
"x_min": 601,
"y_min": 307,
"x_max": 654,
"y_max": 423
},
{
"x_min": 977,
"y_min": 303,
"x_max": 1029,
"y_max": 436
}
],
"cost": 0.0006,
"maskImageUUID": "d060282c-5c8f-4a9e-b74f-15f01b499ee4"
}Canal Lock Maintenance 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@5',
settings: {
confidence: 0.55,
maxDetections: 1,
maskPadding: 6,
maskBlur: 2
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/bdb12ae6-24e2-4f31-b72d-abc092234995.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@5",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 6,
"maskBlur": 2
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/bdb12ae6-24e2-4f31-b72d-abc092234995.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": "d2c1c08e-b035-4444-bb6a-7bb5a2578087",
"model": "runware:35@5",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 6,
"maskBlur": 2
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/bdb12ae6-24e2-4f31-b72d-abc092234995.jpg"
}
}
]'runware run runware:35@5 \
settings.confidence=0.55 \
settings.maxDetections=1 \
settings.maskPadding=6 \
settings.maskBlur=2 \
inputs.image=https://assets.runware.ai/assets/inputs/bdb12ae6-24e2-4f31-b72d-abc092234995.jpg{
"taskType": "imageMasking",
"taskUUID": "d2c1c08e-b035-4444-bb6a-7bb5a2578087",
"model": "runware:35@5",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 6,
"maskBlur": 2
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/bdb12ae6-24e2-4f31-b72d-abc092234995.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "d2c1c08e-b035-4444-bb6a-7bb5a2578087",
"maskImageURL": "https://im.runware.ai/image/os/a10dlim3/ws/4/ii/152935bf-e9cc-4754-996a-ff1f624b1dde.jpg",
"detections": [
{
"x_min": 570,
"y_min": 265,
"x_max": 703,
"y_max": 626
}
],
"cost": 0.0006,
"maskImageUUID": "152935bf-e9cc-4754-996a-ff1f624b1dde"
}Foggy Rail Yard Courier

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@5',
settings: {
confidence: 0.55,
maxDetections: 1,
maskPadding: 8,
maskBlur: 3
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/481cb6bf-7d52-40b4-b6b9-196dfee6966d.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@5",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 8,
"maskBlur": 3
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/481cb6bf-7d52-40b4-b6b9-196dfee6966d.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": "3ba665ac-39a4-4a6a-bcc3-8f6de72bd9c9",
"model": "runware:35@5",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 8,
"maskBlur": 3
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/481cb6bf-7d52-40b4-b6b9-196dfee6966d.jpg"
}
}
]'runware run runware:35@5 \
settings.confidence=0.55 \
settings.maxDetections=1 \
settings.maskPadding=8 \
settings.maskBlur=3 \
inputs.image=https://assets.runware.ai/assets/inputs/481cb6bf-7d52-40b4-b6b9-196dfee6966d.jpg{
"taskType": "imageMasking",
"taskUUID": "3ba665ac-39a4-4a6a-bcc3-8f6de72bd9c9",
"model": "runware:35@5",
"settings": {
"confidence": 0.55,
"maxDetections": 1,
"maskPadding": 8,
"maskBlur": 3
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/481cb6bf-7d52-40b4-b6b9-196dfee6966d.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "3ba665ac-39a4-4a6a-bcc3-8f6de72bd9c9",
"maskImageURL": "https://im.runware.ai/image/os/a01d21/ws/4/ii/0fd5d703-ba27-4f01-b159-733bcc184cac.jpg",
"detections": [
{
"x_min": 367,
"y_min": 196,
"x_max": 546,
"y_max": 589
}
],
"cost": 0.0006,
"maskImageUUID": "0fd5d703-ba27-4f01-b159-733bcc184cac"
}Printing Press Floor Operator

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@5',
settings: {
confidence: 0.45,
maxDetections: 1,
maskPadding: 6,
maskBlur: 2
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/259053f7-158e-4fd6-b769-9d97f55883fa.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@5",
"settings": {
"confidence": 0.45,
"maxDetections": 1,
"maskPadding": 6,
"maskBlur": 2
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/259053f7-158e-4fd6-b769-9d97f55883fa.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": "875254da-6ef9-46b3-ad1b-cfc68f8b91a9",
"model": "runware:35@5",
"settings": {
"confidence": 0.45,
"maxDetections": 1,
"maskPadding": 6,
"maskBlur": 2
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/259053f7-158e-4fd6-b769-9d97f55883fa.jpg"
}
}
]'runware run runware:35@5 \
settings.confidence=0.45 \
settings.maxDetections=1 \
settings.maskPadding=6 \
settings.maskBlur=2 \
inputs.image=https://assets.runware.ai/assets/inputs/259053f7-158e-4fd6-b769-9d97f55883fa.jpg{
"taskType": "imageMasking",
"taskUUID": "875254da-6ef9-46b3-ad1b-cfc68f8b91a9",
"model": "runware:35@5",
"settings": {
"confidence": 0.45,
"maxDetections": 1,
"maskPadding": 6,
"maskBlur": 2
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/259053f7-158e-4fd6-b769-9d97f55883fa.jpg"
}
}{
"taskType": "imageMasking",
"taskUUID": "875254da-6ef9-46b3-ad1b-cfc68f8b91a9",
"maskImageURL": "https://im.runware.ai/image/os/a04d20/ws/4/ii/fa8efef5-a5cc-4f6e-b61f-b140d257f61f.jpg",
"detections": [
{
"x_min": 403,
"y_min": 125,
"x_max": 607,
"y_max": 768
}
],
"cost": 0.0006,
"maskImageUUID": "fa8efef5-a5cc-4f6e-b61f-b140d257f61f"
}