BiRefNet Portrait
BiRefNet Portrait is tuned for human subject segmentation, focusing on accurate extraction of faces and bodies with clean contours for portrait-centric workflows.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples8
CODE
Ready-to-use code snippets for common workflows
Planetarium Educator Background Cutout

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:112@10',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/f43e5f58-79b5-4449-9c0f-2c5684e88479.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:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/f43e5f58-79b5-4449-9c0f-2c5684e88479.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "removeBackground",
"taskUUID": "8172538d-c605-491b-90c8-855222d72a12",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/f43e5f58-79b5-4449-9c0f-2c5684e88479.jpg"
}
}
]'runware run runware:112@10 \
inputs.image=https://assets.runware.ai/assets/inputs/f43e5f58-79b5-4449-9c0f-2c5684e88479.jpg{
"taskType": "removeBackground",
"taskUUID": "8172538d-c605-491b-90c8-855222d72a12",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/f43e5f58-79b5-4449-9c0f-2c5684e88479.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "8172538d-c605-491b-90c8-855222d72a12",
"imageUUID": "72bfbba5-d108-43f6-ac98-eefd50e9abd5",
"imageURL": "https://im.runware.ai/image/os/a07dlim3/ws/5/ii/72bfbba5-d108-43f6-ac98-eefd50e9abd5.png",
"cost": 0.0006,
"inputImageUUID": "720a32a5-51f4-4e25-8a30-87b42f36988d"
}Horologist Conference Portrait Cutout

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:112@10',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/5c869d7a-8654-4557-aa2b-f90e21f8da1c.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:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/5c869d7a-8654-4557-aa2b-f90e21f8da1c.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "removeBackground",
"taskUUID": "71e8d973-9e82-46f0-bba2-07d7f518ebf6",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/5c869d7a-8654-4557-aa2b-f90e21f8da1c.jpg"
}
}
]'runware run runware:112@10 \
inputs.image=https://assets.runware.ai/assets/inputs/5c869d7a-8654-4557-aa2b-f90e21f8da1c.jpg{
"taskType": "removeBackground",
"taskUUID": "71e8d973-9e82-46f0-bba2-07d7f518ebf6",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/5c869d7a-8654-4557-aa2b-f90e21f8da1c.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "71e8d973-9e82-46f0-bba2-07d7f518ebf6",
"imageUUID": "4412048a-946e-4bed-a518-cbc1f74252c1",
"imageURL": "https://im.runware.ai/image/os/a08dlim3/ws/5/ii/4412048a-946e-4bed-a518-cbc1f74252c1.png",
"cost": 0.0006,
"inputImageUUID": "beae7d2b-dad7-4ad7-b738-d2096f90eb3d"
}Aluminized Foundry Suit Catalog Cutout

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:112@10',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/203dfe91-f7f5-45bd-b0e2-a15d74a1890f.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:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/203dfe91-f7f5-45bd-b0e2-a15d74a1890f.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "removeBackground",
"taskUUID": "3cd6da94-071b-47f4-b685-0d3e5868e1cb",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/203dfe91-f7f5-45bd-b0e2-a15d74a1890f.jpg"
}
}
]'runware run runware:112@10 \
inputs.image=https://assets.runware.ai/assets/inputs/203dfe91-f7f5-45bd-b0e2-a15d74a1890f.jpg{
"taskType": "removeBackground",
"taskUUID": "3cd6da94-071b-47f4-b685-0d3e5868e1cb",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/203dfe91-f7f5-45bd-b0e2-a15d74a1890f.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "3cd6da94-071b-47f4-b685-0d3e5868e1cb",
"imageUUID": "90c7a4a5-df4b-4c83-ad6b-3a2011ef2f18",
"imageURL": "https://im.runware.ai/image/os/a04d20/ws/5/ii/90c7a4a5-df4b-4c83-ad6b-3a2011ef2f18.png",
"cost": 0.0006,
"inputImageUUID": "153c80af-d904-4091-b6a4-6023e92b9a0e"
}Wheelchair Racer Campaign Cutout

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:112@10',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/ed908f93-cad4-474b-af98-ab55b61478d7.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:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/ed908f93-cad4-474b-af98-ab55b61478d7.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "removeBackground",
"taskUUID": "7ea008a8-641f-4f62-b705-52d2a6c8ad5d",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/ed908f93-cad4-474b-af98-ab55b61478d7.jpg"
}
}
]'runware run runware:112@10 \
inputs.image=https://assets.runware.ai/assets/inputs/ed908f93-cad4-474b-af98-ab55b61478d7.jpg{
"taskType": "removeBackground",
"taskUUID": "7ea008a8-641f-4f62-b705-52d2a6c8ad5d",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/ed908f93-cad4-474b-af98-ab55b61478d7.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "7ea008a8-641f-4f62-b705-52d2a6c8ad5d",
"imageUUID": "71e88f2e-5328-41a8-8d30-a83918d3e741",
"imageURL": "https://im.runware.ai/image/os/a08dlim3/ws/5/ii/71e88f2e-5328-41a8-8d30-a83918d3e741.png",
"cost": 0.0006,
"inputImageUUID": "a370ece3-7ad6-4c38-9c5b-7f76bb5fcfce"
}Vintage Velvet Studio Headshot

import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
outputFormat: 'PNG',
model: 'runware:112@10',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/eb905e83-3018-4843-aac8-4d18ee381fea.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({
"outputFormat": "PNG",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/eb905e83-3018-4843-aac8-4d18ee381fea.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "removeBackground",
"taskUUID": "0b736d71-4c9c-4a53-88a6-478090c28b4a",
"outputFormat": "PNG",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/eb905e83-3018-4843-aac8-4d18ee381fea.jpg"
}
}
]'runware run runware:112@10 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/eb905e83-3018-4843-aac8-4d18ee381fea.jpg{
"taskType": "removeBackground",
"taskUUID": "0b736d71-4c9c-4a53-88a6-478090c28b4a",
"outputFormat": "PNG",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/eb905e83-3018-4843-aac8-4d18ee381fea.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "0b736d71-4c9c-4a53-88a6-478090c28b4a",
"imageUUID": "79845ea4-58c8-4805-8a5d-8d54a1d0097c",
"imageURL": "https://im.runware.ai/image/os/a12d13/ws/4/ii/79845ea4-58c8-4805-8a5d-8d54a1d0097c.png",
"cost": 0.0006,
"inputImageUUID": "48589eb0-beae-48dd-8c4d-0395267b0c41"
}Raincoat Botanist Riverside Cutout

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:112@10',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/a76ef2b0-26e7-4d03-862b-f0d1e728eaeb.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:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/a76ef2b0-26e7-4d03-862b-f0d1e728eaeb.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "removeBackground",
"taskUUID": "f30be2b6-62a4-4ff6-8e03-b8646aac2538",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/a76ef2b0-26e7-4d03-862b-f0d1e728eaeb.jpg"
}
}
]'runware run runware:112@10 \
inputs.image=https://assets.runware.ai/assets/inputs/a76ef2b0-26e7-4d03-862b-f0d1e728eaeb.jpg{
"taskType": "removeBackground",
"taskUUID": "f30be2b6-62a4-4ff6-8e03-b8646aac2538",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/a76ef2b0-26e7-4d03-862b-f0d1e728eaeb.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "f30be2b6-62a4-4ff6-8e03-b8646aac2538",
"imageUUID": "ab14700a-c570-4db0-bca2-7ca3c6f5bedc",
"imageURL": "https://im.runware.ai/image/os/a03d21/ws/5/ii/ab14700a-c570-4db0-bca2-7ca3c6f5bedc.png",
"cost": 0.0006,
"inputImageUUID": "c8144d62-3212-43dd-aab9-91af26218f6a"
}Velvet Studio Dancer Cutout

import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
outputFormat: 'PNG',
model: 'runware:112@10',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/6a5a4df6-d536-49e9-a116-193b1b50ff9a.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({
"outputFormat": "PNG",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6a5a4df6-d536-49e9-a116-193b1b50ff9a.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "removeBackground",
"taskUUID": "98d68910-cf87-401f-9581-78ec47c85dea",
"outputFormat": "PNG",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6a5a4df6-d536-49e9-a116-193b1b50ff9a.jpg"
}
}
]'runware run runware:112@10 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/6a5a4df6-d536-49e9-a116-193b1b50ff9a.jpg{
"taskType": "removeBackground",
"taskUUID": "98d68910-cf87-401f-9581-78ec47c85dea",
"outputFormat": "PNG",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6a5a4df6-d536-49e9-a116-193b1b50ff9a.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "98d68910-cf87-401f-9581-78ec47c85dea",
"imageUUID": "9bcad7bc-cdff-48cf-9006-da1527bcbc38",
"imageURL": "https://im.runware.ai/image/os/a19d05/ws/4/ii/9bcad7bc-cdff-48cf-9006-da1527bcbc38.png",
"cost": 0.0006,
"inputImageUUID": "b4ff8cda-6a67-4ec4-b837-3a705260f9c4"
}Sequined Cabaret Singer Cutout

import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
outputFormat: 'PNG',
model: 'runware:112@10',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/38a33ff0-63aa-4017-8899-c185453fd4a8.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({
"outputFormat": "PNG",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/38a33ff0-63aa-4017-8899-c185453fd4a8.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "removeBackground",
"taskUUID": "3e565192-7891-427b-bbfa-3d96c53cca0c",
"outputFormat": "PNG",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/38a33ff0-63aa-4017-8899-c185453fd4a8.jpg"
}
}
]'runware run runware:112@10 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/38a33ff0-63aa-4017-8899-c185453fd4a8.jpg{
"taskType": "removeBackground",
"taskUUID": "3e565192-7891-427b-bbfa-3d96c53cca0c",
"outputFormat": "PNG",
"model": "runware:112@10",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/38a33ff0-63aa-4017-8899-c185453fd4a8.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "3e565192-7891-427b-bbfa-3d96c53cca0c",
"imageUUID": "ca4995fa-556b-4951-b1d1-5e27440f6356",
"imageURL": "https://im.runware.ai/image/os/a19d05/ws/4/ii/ca4995fa-556b-4951-b1d1-5e27440f6356.png",
"cost": 0.0006,
"inputImageUUID": "2b9c4f27-434b-428e-ace1-cdbae6845cb7"
}