Skip to main content
ArtEmotion
Image

BiRefNet V2 (BG Remove)

Credit-based pricing. Supports reference images.

BiRefNet V2 (BG Remove) preview
Output
image

Inputs

  • Reference image (required)

Example prompt

Upload any image — BiRefNet V2 precisely cuts out the subject and removes the background, leaving a clean transparent PNG ready for compositing.
Try this prompt →
LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/birefnet/v2.

POST/api/v1/generate14 fields · 2 required
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
promptstringOptionalOptional model input.
modelstringOptionalModel to use for background removal. · Allowed: General Use (Light), General Use (Light 2K), General Use (Heavy), Matting, Portrait, General Use (Dynamic) · Default: General Use (Light)
operating_resolutionstringOptionalThe resolution to operate on. 2304x2304 is only available with General Use (Dynamic). · Allowed: 1024x1024, 2048x2048, 2304x2304 · Default: 1024x1024
output_formatstringOptionalThe format of the output image. · Allowed: webp, png, gif · Default: png
refine_foregroundbooleanOptionalWhether to refine the foreground using the estimated mask. · Default: true
mask_onlybooleanOptionalReturn only the segmentation mask without applying it to the image. Skips foreground refinement. · Default: false
output_maskbooleanOptionalWhether to output the mask used to remove the background. · Default: false
reference_image_urlstringRequiredFormat: uri
Minimal request example
{
  "model_id": "fal-ai/birefnet/v2",
  "reference_image_url": "https://example.com/reference_image"
}
Raw JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbirefnet%2Fv2",
  "title": "BiRefNet V2 (BG Remove) generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/birefnet/v2.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/birefnet/v2",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "model": {
      "title": "Model",
      "description": "Model to use for background removal.",
      "default": "General Use (Light)",
      "type": "string",
      "enum": [
        "General Use (Light)",
        "General Use (Light 2K)",
        "General Use (Heavy)",
        "Matting",
        "Portrait",
        "General Use (Dynamic)"
      ]
    },
    "operating_resolution": {
      "title": "Operating Resolution",
      "description": "The resolution to operate on. 2304x2304 is only available with General Use (Dynamic).",
      "default": "1024x1024",
      "type": "string",
      "enum": [
        "1024x1024",
        "2048x2048",
        "2304x2304"
      ]
    },
    "output_format": {
      "title": "Output Format",
      "description": "The format of the output image.",
      "default": "png",
      "type": "string",
      "enum": [
        "webp",
        "png",
        "gif"
      ]
    },
    "refine_foreground": {
      "title": "Refine Foreground",
      "description": "Whether to refine the foreground using the estimated mask.",
      "default": true,
      "type": "boolean"
    },
    "mask_only": {
      "title": "Mask Only",
      "description": "Return only the segmentation mask without applying it to the image. Skips foreground refinement.",
      "default": false,
      "type": "boolean"
    },
    "output_mask": {
      "title": "Output Mask",
      "description": "Whether to output the mask used to remove the background.",
      "default": false,
      "type": "boolean"
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "reference_image_url"
  ],
  "additionalProperties": false
}

FAQ

How much does BiRefNet V2 (BG Remove) cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if BiRefNet V2 (BG Remove) fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call BiRefNet V2 (BG Remove) from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/birefnet/v2". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with BiRefNet V2 (BG Remove)?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.