BiRefNet Dis
BiRefNet Dis focuses on binary object segmentation tasks where clear separation between subject and background is required. The model emphasizes structural consistency and minimizes foreground leakage through dual reference guidance.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples8
CODE
Ready-to-use code snippets for common workflows
remove-background
Resort Parasol Colorway 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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/bf9620f2-539b-4707-bfe2-0d93601f84e1.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/bf9620f2-539b-4707-bfe2-0d93601f84e1.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": "18caffb8-60a3-4fd6-a333-4c39377cc3de",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/bf9620f2-539b-4707-bfe2-0d93601f84e1.jpg"
}
}
]'runware run runware:112@3 \
inputs.image=https://assets.runware.ai/assets/inputs/bf9620f2-539b-4707-bfe2-0d93601f84e1.jpg{
"taskType": "removeBackground",
"taskUUID": "18caffb8-60a3-4fd6-a333-4c39377cc3de",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/bf9620f2-539b-4707-bfe2-0d93601f84e1.jpg"
}
}Response
{
"taskType": "imageBackgroundRemoval",
"taskUUID": "18caffb8-60a3-4fd6-a333-4c39377cc3de",
"imageUUID": "4ce4b510-1b13-4d64-8edd-34710d7ea4de",
"imageURL": "https://im.runware.ai/image/os/a09dlim3/ws/5/ii/4ce4b510-1b13-4d64-8edd-34710d7ea4de.png",
"cost": 0.0006,
"inputImageUUID": "62da80ee-aa08-459e-96a9-dc6293bbe68f"
}remove-background
Twilight Balloon Relighting 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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/fc2b0964-aaee-4c4d-be74-839fe5ba5f2c.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/fc2b0964-aaee-4c4d-be74-839fe5ba5f2c.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": "8f72678d-4476-4474-bc3a-f598c420f2de",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/fc2b0964-aaee-4c4d-be74-839fe5ba5f2c.jpg"
}
}
]'runware run runware:112@3 \
inputs.image=https://assets.runware.ai/assets/inputs/fc2b0964-aaee-4c4d-be74-839fe5ba5f2c.jpg{
"taskType": "removeBackground",
"taskUUID": "8f72678d-4476-4474-bc3a-f598c420f2de",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/fc2b0964-aaee-4c4d-be74-839fe5ba5f2c.jpg"
}
}Response
{
"taskType": "imageBackgroundRemoval",
"taskUUID": "8f72678d-4476-4474-bc3a-f598c420f2de",
"imageUUID": "3531dd6b-3d19-4460-bdc8-a00ef8f5cb6f",
"imageURL": "https://im.runware.ai/image/os/a04d20/ws/5/ii/3531dd6b-3d19-4460-bdc8-a00ef8f5cb6f.png",
"cost": 0.0006,
"inputImageUUID": "d2b1fa1d-5d0d-41ea-82a9-5f58df995ecd"
}remove-background
Panoramic Ballet Campaign Expansion$0.0006~5s
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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/16974dc8-26dc-4017-a302-951d74eef482.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/16974dc8-26dc-4017-a302-951d74eef482.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": "cffbdcbd-bb1e-48ac-b132-03b6a24216b2",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/16974dc8-26dc-4017-a302-951d74eef482.jpg"
}
}
]'runware run runware:112@3 \
inputs.image=https://assets.runware.ai/assets/inputs/16974dc8-26dc-4017-a302-951d74eef482.jpg{
"taskType": "removeBackground",
"taskUUID": "cffbdcbd-bb1e-48ac-b132-03b6a24216b2",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/16974dc8-26dc-4017-a302-951d74eef482.jpg"
}
}Response
{
"taskType": "imageBackgroundRemoval",
"taskUUID": "cffbdcbd-bb1e-48ac-b132-03b6a24216b2",
"imageUUID": "12ad4782-06ed-4ae5-a2ca-15cc45dce313",
"imageURL": "https://im.runware.ai/image/os/a09dlim3/ws/5/ii/12ad4782-06ed-4ae5-a2ca-15cc45dce313.png",
"cost": 0.0006,
"inputImageUUID": "33aba2d9-80d3-4050-a5de-3b40a0b88743"
}remove-background
Chainmail Coif Virtual Try-On 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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/00348e57-7968-4459-bcbd-cd802af71d39.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/00348e57-7968-4459-bcbd-cd802af71d39.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": "7ef88ab9-1183-4a5e-ad7d-a9e4246f0a35",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/00348e57-7968-4459-bcbd-cd802af71d39.jpg"
}
}
]'runware run runware:112@3 \
inputs.image=https://assets.runware.ai/assets/inputs/00348e57-7968-4459-bcbd-cd802af71d39.jpg{
"taskType": "removeBackground",
"taskUUID": "7ef88ab9-1183-4a5e-ad7d-a9e4246f0a35",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/00348e57-7968-4459-bcbd-cd802af71d39.jpg"
}
}Response
{
"taskType": "imageBackgroundRemoval",
"taskUUID": "7ef88ab9-1183-4a5e-ad7d-a9e4246f0a35",
"imageUUID": "90ff5196-8df3-40a2-86c2-a242d2a7fdfd",
"imageURL": "https://im.runware.ai/image/os/a02d21/ws/5/ii/90ff5196-8df3-40a2-86c2-a242d2a7fdfd.png",
"cost": 0.0006,
"inputImageUUID": "db46e345-8dfa-4c40-b1ca-e488d401f21d"
}
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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/a5a86919-d2d7-4cca-aabd-d0c27d2ab0eb.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/a5a86919-d2d7-4cca-aabd-d0c27d2ab0eb.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": "c3628f4b-39e2-4d58-9e8f-f923e677b652",
"outputFormat": "PNG",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/a5a86919-d2d7-4cca-aabd-d0c27d2ab0eb.jpg"
}
}
]'runware run runware:112@3 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/a5a86919-d2d7-4cca-aabd-d0c27d2ab0eb.jpg{
"taskType": "removeBackground",
"taskUUID": "c3628f4b-39e2-4d58-9e8f-f923e677b652",
"outputFormat": "PNG",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/a5a86919-d2d7-4cca-aabd-d0c27d2ab0eb.jpg"
}
}Response
{
"taskType": "imageBackgroundRemoval",
"taskUUID": "c3628f4b-39e2-4d58-9e8f-f923e677b652",
"imageUUID": "960301f2-cba9-4b96-88e4-d823d58e4f11",
"imageURL": "https://im.runware.ai/image/os/a15d18/ws/4/ii/960301f2-cba9-4b96-88e4-d823d58e4f11.png",
"cost": 0.0006,
"inputImageUUID": "8cb2a5a0-0fb2-484e-998f-5a2585d886a9"
}
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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/feb81715-8bec-420d-9fb2-c35051ac30e7.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/feb81715-8bec-420d-9fb2-c35051ac30e7.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": "e7ec9ad7-b62a-4dd1-a2bf-b219c82f772c",
"outputFormat": "PNG",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/feb81715-8bec-420d-9fb2-c35051ac30e7.jpg"
}
}
]'runware run runware:112@3 \
outputFormat=PNG \
inputs.image=https://assets.runware.ai/assets/inputs/feb81715-8bec-420d-9fb2-c35051ac30e7.jpg{
"taskType": "removeBackground",
"taskUUID": "e7ec9ad7-b62a-4dd1-a2bf-b219c82f772c",
"outputFormat": "PNG",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/feb81715-8bec-420d-9fb2-c35051ac30e7.jpg"
}
}Response
{
"taskType": "imageBackgroundRemoval",
"taskUUID": "e7ec9ad7-b62a-4dd1-a2bf-b219c82f772c",
"imageUUID": "f9c16b5e-70e1-4d6f-8ddf-e06a2b20cce1",
"imageURL": "https://im.runware.ai/image/os/a07d11/ws/4/ii/f9c16b5e-70e1-4d6f-8ddf-e06a2b20cce1.png",
"cost": 0.0006,
"inputImageUUID": "74e96891-abec-43f6-a623-a1f84cd761cc"
}
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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/38dc83c7-1755-4688-89ec-c7dd523346cc.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/38dc83c7-1755-4688-89ec-c7dd523346cc.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": "d4387b0a-fbcd-496a-a8bb-53c0caf13c80",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/38dc83c7-1755-4688-89ec-c7dd523346cc.jpg"
}
}
]'runware run runware:112@3 \
inputs.image=https://assets.runware.ai/assets/inputs/38dc83c7-1755-4688-89ec-c7dd523346cc.jpg{
"taskType": "removeBackground",
"taskUUID": "d4387b0a-fbcd-496a-a8bb-53c0caf13c80",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/38dc83c7-1755-4688-89ec-c7dd523346cc.jpg"
}
}Response
{
"taskType": "imageBackgroundRemoval",
"taskUUID": "d4387b0a-fbcd-496a-a8bb-53c0caf13c80",
"imageUUID": "4740f198-adf2-4c66-bca8-6948aef3a927",
"imageURL": "https://im.runware.ai/image/os/a07dlim3/ws/5/ii/4740f198-adf2-4c66-bca8-6948aef3a927.png",
"cost": 0.0006,
"inputImageUUID": "26ca3c33-000c-4804-885d-48c437e513d7"
}
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@3',
inputs: {
image: 'https://assets.runware.ai/assets/inputs/86dff1ae-c390-45e7-a449-a50ef1c0e8af.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@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/86dff1ae-c390-45e7-a449-a50ef1c0e8af.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": "60a87ceb-63cc-4183-aa67-3a7b8bb97b45",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/86dff1ae-c390-45e7-a449-a50ef1c0e8af.jpg"
}
}
]'runware run runware:112@3 \
inputs.image=https://assets.runware.ai/assets/inputs/86dff1ae-c390-45e7-a449-a50ef1c0e8af.jpg{
"taskType": "removeBackground",
"taskUUID": "60a87ceb-63cc-4183-aa67-3a7b8bb97b45",
"model": "runware:112@3",
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/86dff1ae-c390-45e7-a449-a50ef1c0e8af.jpg"
}
}Response
{
"taskType": "imageBackgroundRemoval",
"taskUUID": "60a87ceb-63cc-4183-aa67-3a7b8bb97b45",
"imageUUID": "ace2d804-91a1-4be6-9458-8a02540749c8",
"imageURL": "https://im.runware.ai/image/os/a03d21/ws/5/ii/ace2d804-91a1-4be6-9458-8a02540749c8.png",
"cost": 0.0006,
"inputImageUUID": "2ed6de7c-e0fd-484b-8d49-e7b2daa2f982"
}