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
remove-background
Lighthouse Keeper Portrait Repair$0.0006~7s
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"
}
}Response
{
"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"
}remove-background
Winter Carnival Horse Relight Cutout$0.0006~6s
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"
}
}Response
{
"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"
}remove-background
Winter Lights Topiary Cutout$0.0006~6s
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"
}
}Response
{
"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"
}remove-background
Glass Condenser Catalog Cutout$0.0006~6s
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"
}
}Response
{
"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"
}
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"
}
}Response
{
"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"
}
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"
}
}Response
{
"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"
}
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"
}
}Response
{
"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"
}
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"
}
}Response
{
"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"
}