YOLOv8n Hand
YOLOv8n Hand is a lightweight image masking model for detecting hands in realistic 2D imagery and returning black-and-white masks for each detection. It is useful for automated hand-focused inpainting, hand detail enhancement, and batch masking workflows.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
hand-mask
Cabin Twilight Relight Hand Masks$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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/8f759ab6-3b33-4404-85ff-58937da52644.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8f759ab6-3b33-4404-85ff-58937da52644.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": "8a12a9d3-a00f-4995-9f38-0660d6ce7ded",
"model": "runware:35@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8f759ab6-3b33-4404-85ff-58937da52644.jpg"
}
}
]'runware run runware:35@3 \
inputs.image=https://assets.runware.ai/assets/inputs/8f759ab6-3b33-4404-85ff-58937da52644.jpg{
"taskType": "imageMasking",
"taskUUID": "8a12a9d3-a00f-4995-9f38-0660d6ce7ded",
"model": "runware:35@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8f759ab6-3b33-4404-85ff-58937da52644.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "8a12a9d3-a00f-4995-9f38-0660d6ce7ded",
"maskImageURL": "https://im.runware.ai/image/os/a01d21/ws/4/ii/8454f905-fdcb-4a99-a3e2-ef5116b52cf2.jpg",
"detections": [
{
"x_min": 196,
"y_min": 503,
"x_max": 290,
"y_max": 609
},
{
"x_min": 744,
"y_min": 498,
"x_max": 834,
"y_max": 603
},
{
"x_min": 625,
"y_min": 854,
"x_max": 1024,
"y_max": 1024
}
],
"cost": 0.0006,
"maskImageUUID": "8454f905-fdcb-4a99-a3e2-ef5116b52cf2"
}hand-mask
Antarctic Radio Archive Hand Masks$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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/3ee3ee0e-7b0a-4a79-8e7f-b247b4b6e6e4.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/3ee3ee0e-7b0a-4a79-8e7f-b247b4b6e6e4.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": "8121b11b-1f56-45c0-b0a9-c4c7bce19b3a",
"model": "runware:35@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/3ee3ee0e-7b0a-4a79-8e7f-b247b4b6e6e4.jpg"
}
}
]'runware run runware:35@3 \
inputs.image=https://assets.runware.ai/assets/inputs/3ee3ee0e-7b0a-4a79-8e7f-b247b4b6e6e4.jpg{
"taskType": "imageMasking",
"taskUUID": "8121b11b-1f56-45c0-b0a9-c4c7bce19b3a",
"model": "runware:35@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/3ee3ee0e-7b0a-4a79-8e7f-b247b4b6e6e4.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "8121b11b-1f56-45c0-b0a9-c4c7bce19b3a",
"maskImageURL": "https://im.runware.ai/image/os/a07dlim3/ws/4/ii/e230908a-e8a4-4096-872e-988cd300e213.jpg",
"detections": [
{
"x_min": 145,
"y_min": 561,
"x_max": 333,
"y_max": 727
},
{
"x_min": 653,
"y_min": 490,
"x_max": 884,
"y_max": 649
}
],
"cost": 0.0013,
"maskImageUUID": "e230908a-e8a4-4096-872e-988cd300e213"
}hand-mask
Seaweed Herbarium Hand Cleanup$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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/1eaae798-b728-48d7-a19a-44e489135eee.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1eaae798-b728-48d7-a19a-44e489135eee.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": "33fa2100-4a12-4302-926f-79db2fc22b26",
"model": "runware:35@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1eaae798-b728-48d7-a19a-44e489135eee.jpg"
}
}
]'runware run runware:35@3 \
inputs.image=https://assets.runware.ai/assets/inputs/1eaae798-b728-48d7-a19a-44e489135eee.jpg{
"taskType": "imageMasking",
"taskUUID": "33fa2100-4a12-4302-926f-79db2fc22b26",
"model": "runware:35@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1eaae798-b728-48d7-a19a-44e489135eee.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "33fa2100-4a12-4302-926f-79db2fc22b26",
"maskImageURL": "https://im.runware.ai/image/os/a08dlim3/ws/4/ii/9d7c96d8-f05a-440d-aac3-bb872b322cb6.jpg",
"detections": [
{
"x_min": 32,
"y_min": 363,
"x_max": 351,
"y_max": 842
},
{
"x_min": 1172,
"y_min": 363,
"x_max": 1516,
"y_max": 850
}
],
"cost": 0.0013,
"maskImageUUID": "9d7c96d8-f05a-440d-aac3-bb872b322cb6"
}hand-mask
Avant-Garde Jewelry Hand Cutouts$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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/924bf9f0-02f0-4a19-b46b-6d96a74025b8.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/924bf9f0-02f0-4a19-b46b-6d96a74025b8.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": "b3791c7b-c7be-4481-b521-8919ce530cff",
"model": "runware:35@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/924bf9f0-02f0-4a19-b46b-6d96a74025b8.jpg"
}
}
]'runware run runware:35@3 \
inputs.image=https://assets.runware.ai/assets/inputs/924bf9f0-02f0-4a19-b46b-6d96a74025b8.jpg{
"taskType": "imageMasking",
"taskUUID": "b3791c7b-c7be-4481-b521-8919ce530cff",
"model": "runware:35@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/924bf9f0-02f0-4a19-b46b-6d96a74025b8.jpg"
}
}Response
{
"taskType": "imageMasking",
"taskUUID": "b3791c7b-c7be-4481-b521-8919ce530cff",
"maskImageURL": "https://im.runware.ai/image/os/a05d22/ws/4/ii/51e84872-0aea-4fc6-b87c-326834cc4edd.jpg",
"detections": [
{
"x_min": 175,
"y_min": 163,
"x_max": 493,
"y_max": 660
},
{
"x_min": 523,
"y_min": 144,
"x_max": 880,
"y_max": 646
}
],
"cost": 0.0013,
"maskImageUUID": "51e84872-0aea-4fc6-b87c-326834cc4edd"
}