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
Examples4
CODE
Ready-to-use code snippets for common workflows
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"
}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"
}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"
}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"
}