BiRefNet v1 Base
BiRefNet v1 Base is the core model of the BiRefNet family, designed for dichotomous image segmentation. It produces clean foreground–background masks with strong boundary precision by leveraging bilateral reference cues that preserve spatial structure and object integrity across diverse scenes.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples8
CODE
Ready-to-use code snippets for common workflows
Glass Condenser 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@1',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/7cb6cd05-bc5c-4fc4-ab07-75edff189f31.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@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7cb6cd05-bc5c-4fc4-ab07-75edff189f31.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": "d71bce06-4714-4cc6-8da8-cc4891e5104d",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7cb6cd05-bc5c-4fc4-ab07-75edff189f31.jpg"
}
}
]'runware run runware:112@1 \
inputs.image=https://assets.runware.ai/assets/inputs/7cb6cd05-bc5c-4fc4-ab07-75edff189f31.jpg{
"taskType": "removeBackground",
"taskUUID": "d71bce06-4714-4cc6-8da8-cc4891e5104d",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/7cb6cd05-bc5c-4fc4-ab07-75edff189f31.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "d71bce06-4714-4cc6-8da8-cc4891e5104d",
"imageUUID": "c0a18830-90ab-43ef-8d49-f11abf12c430",
"imageURL": "https://im.runware.ai/image/os/a09dlim3/ws/5/ii/c0a18830-90ab-43ef-8d49-f11abf12c430.png",
"cost": 0.0006,
"inputImageUUID": "9f9b5a11-6c92-458e-a7b0-6d813dfcad25"
}Lighthouse Keeper Portrait Repair

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@1',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/d6dab857-59f2-4358-907e-9e50704aab1a.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@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/d6dab857-59f2-4358-907e-9e50704aab1a.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": "133f6843-7f6f-435e-aa23-7289bddf1932",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/d6dab857-59f2-4358-907e-9e50704aab1a.jpg"
}
}
]'runware run runware:112@1 \
inputs.image=https://assets.runware.ai/assets/inputs/d6dab857-59f2-4358-907e-9e50704aab1a.jpg{
"taskType": "removeBackground",
"taskUUID": "133f6843-7f6f-435e-aa23-7289bddf1932",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/d6dab857-59f2-4358-907e-9e50704aab1a.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "133f6843-7f6f-435e-aa23-7289bddf1932",
"imageUUID": "9105e588-8b3a-48e3-aa39-397296df1f2e",
"imageURL": "https://im.runware.ai/image/os/a10dlim3/ws/5/ii/9105e588-8b3a-48e3-aa39-397296df1f2e.png",
"cost": 0.0006,
"inputImageUUID": "3e713c2b-6139-42f7-bff2-9a18b122c8d3"
}Winter Carnival Horse Relight 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@1',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/27ad5f26-33b9-4249-a0c6-af8b32cee3ed.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@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/27ad5f26-33b9-4249-a0c6-af8b32cee3ed.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": "79fa6054-0fa9-4e35-b13a-b235a48b74c7",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/27ad5f26-33b9-4249-a0c6-af8b32cee3ed.jpg"
}
}
]'runware run runware:112@1 \
inputs.image=https://assets.runware.ai/assets/inputs/27ad5f26-33b9-4249-a0c6-af8b32cee3ed.jpg{
"taskType": "removeBackground",
"taskUUID": "79fa6054-0fa9-4e35-b13a-b235a48b74c7",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/27ad5f26-33b9-4249-a0c6-af8b32cee3ed.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "79fa6054-0fa9-4e35-b13a-b235a48b74c7",
"imageUUID": "6e100e28-480d-488b-bd00-31dc124f791b",
"imageURL": "https://im.runware.ai/image/os/a02d21/ws/5/ii/6e100e28-480d-488b-bd00-31dc124f791b.png",
"cost": 0.0006,
"inputImageUUID": "a2a940ad-da74-4253-ade5-5c593fda8bc0"
}Winter Lights Topiary 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@1',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/489076d0-fd2f-4610-8d10-87f8a206c950.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@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/489076d0-fd2f-4610-8d10-87f8a206c950.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": "ecb11e04-5581-42e4-b018-46096dcb7a63",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/489076d0-fd2f-4610-8d10-87f8a206c950.jpg"
}
}
]'runware run runware:112@1 \
inputs.image=https://assets.runware.ai/assets/inputs/489076d0-fd2f-4610-8d10-87f8a206c950.jpg{
"taskType": "removeBackground",
"taskUUID": "ecb11e04-5581-42e4-b018-46096dcb7a63",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/489076d0-fd2f-4610-8d10-87f8a206c950.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "ecb11e04-5581-42e4-b018-46096dcb7a63",
"imageUUID": "452bc5b5-703a-4c07-8b3a-c38f7e9fbcab",
"imageURL": "https://im.runware.ai/image/os/a10dlim3/ws/5/ii/452bc5b5-703a-4c07-8b3a-c38f7e9fbcab.png",
"cost": 0.0006,
"inputImageUUID": "1c90d4d3-2fd3-4dbd-8e93-9d6e175d9027"
}Ornate Masquerade Feathered Headpiece

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@1',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/b1a19a69-7506-432d-a720-a6e6eccd3ce3.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@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/b1a19a69-7506-432d-a720-a6e6eccd3ce3.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": "3af04188-f83c-4650-87c0-40afe13e8e07",
"outputFormat": "PNG",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/b1a19a69-7506-432d-a720-a6e6eccd3ce3.jpg"
}
}
]'runware run runware:112@1 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/b1a19a69-7506-432d-a720-a6e6eccd3ce3.jpg{
"taskType": "removeBackground",
"taskUUID": "3af04188-f83c-4650-87c0-40afe13e8e07",
"outputFormat": "PNG",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/b1a19a69-7506-432d-a720-a6e6eccd3ce3.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "3af04188-f83c-4650-87c0-40afe13e8e07",
"imageUUID": "94ec8d0e-c30f-40c7-b479-d8ca719f44fd",
"imageURL": "https://im.runware.ai/image/os/a21d05/ws/4/ii/94ec8d0e-c30f-40c7-b479-d8ca719f44fd.png",
"cost": 0.0006,
"inputImageUUID": "5018a301-4691-491a-a2d9-9179b0574cb2"
}Weathered Toy Robot 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@1',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/6510bc3a-41e3-4461-a0e3-59f1240b6522.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@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6510bc3a-41e3-4461-a0e3-59f1240b6522.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": "e49aa691-12d5-4e74-881b-1df23bc77a47",
"outputFormat": "PNG",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6510bc3a-41e3-4461-a0e3-59f1240b6522.jpg"
}
}
]'runware run runware:112@1 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/6510bc3a-41e3-4461-a0e3-59f1240b6522.jpg{
"taskType": "removeBackground",
"taskUUID": "e49aa691-12d5-4e74-881b-1df23bc77a47",
"outputFormat": "PNG",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6510bc3a-41e3-4461-a0e3-59f1240b6522.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "e49aa691-12d5-4e74-881b-1df23bc77a47",
"imageUUID": "890f9d50-8614-4259-a01e-b77a08364bcb",
"imageURL": "https://im.runware.ai/image/os/a15d18/ws/4/ii/890f9d50-8614-4259-a01e-b77a08364bcb.png",
"cost": 0.0006,
"inputImageUUID": "4a41ffb3-d730-41eb-914a-2cd702ce2361"
}Dewy Mushroom Cluster 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@1',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/58c85004-6b03-4323-a784-9a41e90d74f5.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@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/58c85004-6b03-4323-a784-9a41e90d74f5.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": "978ac604-6afd-4d69-b183-f6646a038a5b",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/58c85004-6b03-4323-a784-9a41e90d74f5.jpg"
}
}
]'runware run runware:112@1 \
inputs.image=https://assets.runware.ai/assets/inputs/58c85004-6b03-4323-a784-9a41e90d74f5.jpg{
"taskType": "removeBackground",
"taskUUID": "978ac604-6afd-4d69-b183-f6646a038a5b",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/58c85004-6b03-4323-a784-9a41e90d74f5.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "978ac604-6afd-4d69-b183-f6646a038a5b",
"imageUUID": "898efe02-a2cb-4bb6-a039-73c957783355",
"imageURL": "https://im.runware.ai/image/os/a04d20/ws/5/ii/898efe02-a2cb-4bb6-a039-73c957783355.png",
"cost": 0.0006,
"inputImageUUID": "0725e315-e9cb-488d-b5f9-61091394987c"
}Antique Violin Velvet Case

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@1',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/38451971-8f48-4d3a-b6ff-f75599c739a8.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@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/38451971-8f48-4d3a-b6ff-f75599c739a8.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": "c541d870-b291-4cc7-864e-a83064d91c5d",
"outputFormat": "PNG",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/38451971-8f48-4d3a-b6ff-f75599c739a8.jpg"
}
}
]'runware run runware:112@1 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/38451971-8f48-4d3a-b6ff-f75599c739a8.jpg{
"taskType": "removeBackground",
"taskUUID": "c541d870-b291-4cc7-864e-a83064d91c5d",
"outputFormat": "PNG",
"model": "runware:112@1",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/38451971-8f48-4d3a-b6ff-f75599c739a8.jpg"
}
}{
"taskType": "imageBackgroundRemoval",
"taskUUID": "c541d870-b291-4cc7-864e-a83064d91c5d",
"imageUUID": "3580be88-4e6d-4696-964d-75d6962cfa72",
"imageURL": "https://im.runware.ai/image/os/a21d05/ws/4/ii/3580be88-4e6d-4696-964d-75d6962cfa72.png",
"cost": 0.0006,
"inputImageUUID": "b27998e7-183e-40c4-b1ca-7983a5e2a3fc"
}