BiRefNet General
BiRefNet General is trained for broad segmentation use cases, providing stable and consistent object masks across a wide variety of image domains without task-specific specialization.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples8
CODE
Ready-to-use code snippets for common workflows
Hand-Spliced Marine Fender 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@5',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/7520be84-0435-45cd-a5a4-5727dbc9d8c5.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@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7520be84-0435-45cd-a5a4-5727dbc9d8c5.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": "228fddae-e876-45c6-a5b6-7ee6aebb7a13",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7520be84-0435-45cd-a5a4-5727dbc9d8c5.jpg"
}
}
]'runware run runware:112@5 \
inputs.image=https://assets.runware.ai/assets/inputs/7520be84-0435-45cd-a5a4-5727dbc9d8c5.jpg{
"taskType": "removeBackground",
"taskUUID": "228fddae-e876-45c6-a5b6-7ee6aebb7a13",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7520be84-0435-45cd-a5a4-5727dbc9d8c5.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "228fddae-e876-45c6-a5b6-7ee6aebb7a13",
"imageUUID": "b8078508-5121-482b-97f5-3a108be5ff1f",
"imageURL": "https://im.runware.ai/image/os/a03d21/ws/5/ii/b8078508-5121-482b-97f5-3a108be5ff1f.png",
"cost": 0.0006,
"inputImageUUID": "38e912f7-7b3d-4c2e-a81e-996fc7838e28"
}Beekeeper Orchard Background-Swap 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@5',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/bd6dd22d-c14b-488c-b7b2-9573cf1cb014.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@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/bd6dd22d-c14b-488c-b7b2-9573cf1cb014.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": "59204411-2975-427c-aae1-145c76ed7cdb",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/bd6dd22d-c14b-488c-b7b2-9573cf1cb014.jpg"
}
}
]'runware run runware:112@5 \
inputs.image=https://assets.runware.ai/assets/inputs/bd6dd22d-c14b-488c-b7b2-9573cf1cb014.jpg{
"taskType": "removeBackground",
"taskUUID": "59204411-2975-427c-aae1-145c76ed7cdb",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/bd6dd22d-c14b-488c-b7b2-9573cf1cb014.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "59204411-2975-427c-aae1-145c76ed7cdb",
"imageUUID": "e5927433-7856-462c-abc5-19224b0f6016",
"imageURL": "https://im.runware.ai/image/os/a02d21/ws/5/ii/e5927433-7856-462c-abc5-19224b0f6016.png",
"cost": 0.0006,
"inputImageUUID": "17d52554-37af-49c8-828a-11d5387825d1"
}Geothermal Engineer Press Headshot

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@5',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/e270981b-60de-43d1-8fc1-eae2999671e8.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@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/e270981b-60de-43d1-8fc1-eae2999671e8.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": "5226a621-7274-45b1-a114-0959de34e125",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/e270981b-60de-43d1-8fc1-eae2999671e8.jpg"
}
}
]'runware run runware:112@5 \
inputs.image=https://assets.runware.ai/assets/inputs/e270981b-60de-43d1-8fc1-eae2999671e8.jpg{
"taskType": "removeBackground",
"taskUUID": "5226a621-7274-45b1-a114-0959de34e125",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/e270981b-60de-43d1-8fc1-eae2999671e8.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "5226a621-7274-45b1-a114-0959de34e125",
"imageUUID": "64b29c4e-d520-4cc7-88fd-15dcc698bdae",
"imageURL": "https://im.runware.ai/image/os/a03d21/ws/5/ii/64b29c4e-d520-4cc7-88fd-15dcc698bdae.png",
"cost": 0.0006,
"inputImageUUID": "a85d2971-6f22-444f-bb1b-f3c7f3853f0d"
}Circus Portrait Restyle 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@5',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/fad3354d-2cc0-4436-a4b6-bc4979d37eac.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@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/fad3354d-2cc0-4436-a4b6-bc4979d37eac.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": "fd658b61-4b9a-460c-b942-72dc4ca4cd1d",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/fad3354d-2cc0-4436-a4b6-bc4979d37eac.jpg"
}
}
]'runware run runware:112@5 \
inputs.image=https://assets.runware.ai/assets/inputs/fad3354d-2cc0-4436-a4b6-bc4979d37eac.jpg{
"taskType": "removeBackground",
"taskUUID": "fd658b61-4b9a-460c-b942-72dc4ca4cd1d",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/fad3354d-2cc0-4436-a4b6-bc4979d37eac.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "fd658b61-4b9a-460c-b942-72dc4ca4cd1d",
"imageUUID": "fa2af59a-b39b-4d4e-9013-02fd878e165f",
"imageURL": "https://im.runware.ai/image/os/a07dlim3/ws/5/ii/fa2af59a-b39b-4d4e-9013-02fd878e165f.png",
"cost": 0.0006,
"inputImageUUID": "4ba4e4e6-80c1-4eac-9dd0-e5811b16b92d"
}Vintage Violin on Velvet

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@5',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/8f8c5b36-fded-4cf1-a60b-3f50b40ea1a1.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@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8f8c5b36-fded-4cf1-a60b-3f50b40ea1a1.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": "9ee8b3ab-a09b-4d7f-af31-2a122b4f8877",
"outputFormat": "PNG",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8f8c5b36-fded-4cf1-a60b-3f50b40ea1a1.jpg"
}
}
]'runware run runware:112@5 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/8f8c5b36-fded-4cf1-a60b-3f50b40ea1a1.jpg{
"taskType": "removeBackground",
"taskUUID": "9ee8b3ab-a09b-4d7f-af31-2a122b4f8877",
"outputFormat": "PNG",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/8f8c5b36-fded-4cf1-a60b-3f50b40ea1a1.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "9ee8b3ab-a09b-4d7f-af31-2a122b4f8877",
"imageUUID": "e0ca962b-805a-4a9b-93c0-6dbf842aeef9",
"imageURL": "https://im.runware.ai/image/os/a15d18/ws/4/ii/e0ca962b-805a-4a9b-93c0-6dbf842aeef9.png",
"cost": 0.0006,
"inputImageUUID": "4b399a16-aaf9-4d93-a57b-4ac373dba565"
}Ceramic Koi Teapot Silhouette

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@5',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/1c4bfa2d-5dd9-4b02-bf5e-5c08d61dc40e.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@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1c4bfa2d-5dd9-4b02-bf5e-5c08d61dc40e.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": "e99e8ae1-50d4-457d-9b38-4a7960b8b50d",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1c4bfa2d-5dd9-4b02-bf5e-5c08d61dc40e.jpg"
}
}
]'runware run runware:112@5 \
inputs.image=https://assets.runware.ai/assets/inputs/1c4bfa2d-5dd9-4b02-bf5e-5c08d61dc40e.jpg{
"taskType": "removeBackground",
"taskUUID": "e99e8ae1-50d4-457d-9b38-4a7960b8b50d",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1c4bfa2d-5dd9-4b02-bf5e-5c08d61dc40e.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "e99e8ae1-50d4-457d-9b38-4a7960b8b50d",
"imageUUID": "a7305f61-347d-4a9a-8073-abcb78c9d7be",
"imageURL": "https://im.runware.ai/image/os/a07dlim3/ws/5/ii/a7305f61-347d-4a9a-8073-abcb78c9d7be.png",
"cost": 0.0006,
"inputImageUUID": "fa2e26c9-3ae2-44b4-956f-4b5f34247d9b"
}Antique Violin Velvet Lining

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@5',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/b7b3bed5-528b-4384-8646-478b917c80ee.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@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/b7b3bed5-528b-4384-8646-478b917c80ee.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": "6bf6b9a8-b5eb-4bdc-a169-792cf60ab153",
"outputFormat": "PNG",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/b7b3bed5-528b-4384-8646-478b917c80ee.jpg"
}
}
]'runware run runware:112@5 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/b7b3bed5-528b-4384-8646-478b917c80ee.jpg{
"taskType": "removeBackground",
"taskUUID": "6bf6b9a8-b5eb-4bdc-a169-792cf60ab153",
"outputFormat": "PNG",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/b7b3bed5-528b-4384-8646-478b917c80ee.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "6bf6b9a8-b5eb-4bdc-a169-792cf60ab153",
"imageUUID": "41422574-b1da-420a-bd80-e6ea027abc4e",
"imageURL": "https://im.runware.ai/image/os/a04d20/ws/4/ii/41422574-b1da-420a-bd80-e6ea027abc4e.png",
"cost": 0.0006,
"inputImageUUID": "dabf328d-9b8c-4269-9caa-c904dd5b6cca"
}Vintage Carousel Horse 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@5',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/1f41f596-4cae-42a3-932c-017ae9ea7162.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@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1f41f596-4cae-42a3-932c-017ae9ea7162.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": "aa872c7d-1f2e-47be-b7f6-9e882207c5fe",
"outputFormat": "PNG",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1f41f596-4cae-42a3-932c-017ae9ea7162.jpg"
}
}
]'runware run runware:112@5 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/1f41f596-4cae-42a3-932c-017ae9ea7162.jpg{
"taskType": "removeBackground",
"taskUUID": "aa872c7d-1f2e-47be-b7f6-9e882207c5fe",
"outputFormat": "PNG",
"model": "runware:112@5",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/1f41f596-4cae-42a3-932c-017ae9ea7162.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "aa872c7d-1f2e-47be-b7f6-9e882207c5fe",
"imageUUID": "83f0c2fb-254e-416e-9fff-15436a4e9880",
"imageURL": "https://im.runware.ai/image/os/a12d13/ws/4/ii/83f0c2fb-254e-416e-9fff-15436a4e9880.png",
"cost": 0.0006,
"inputImageUUID": "e0bc0c75-fb17-474a-a8ca-02fd6c71fb77"
}