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