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