Skip to content
HiAPI Docs
HiAPI
Playground Get API Key
English
English 中文

Recraft Remove Background API

POST Base URL: https://api.hiapi.ai /v1/tasks

Image, video, and audio models are called through the Unified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model name recraft/remove-background
Type Image editing (background removal)
Endpoint POST /v1/tasks
Pricing See HiAPI Pricing

Recraft background removal: one image URL in, transparent-background PNG out — hair and fur-level edges preserved, built for product photos, portraits and design assets at scale.

Production guidance

Production guidance
  • For production, pass callback.url at the top level of the request body so HiAPI can notify your service when the task reaches a terminal state.
  • GET /v1/tasks/:id is better for local debugging, low-volume jobs, or fallback reconciliation if a callback is missed.
  • Result URLs expire — copy the output to your own storage once the task succeeds.
  • Validate the input format, size and dimensions before submitting; requests beyond the limits fail.

Best suited for

Product photos

Drop the cutout straight onto any new backdrop — built for batch runs.

image_url
Portraits & pets

Hair and fur-level edge detail is preserved, no manual feathering.

image_url
Automated pipelines

One parameter, no prompt — trivially easy to wire into batch jobs.

image_url

Request parameters

model string required

Fixed value recraft/remove-background.

example recraft/remove-background
input object required

Business parameters. recraft/remove-background takes a single input field.

image_url string required

Publicly accessible https URL of the image to cut out. PNG/JPG/WebP; up to 5MB; 256-4096 px per side; up to 16 megapixels.

callback object optional

Optional callback configuration. When set, HiAPI notifies your service when the task reaches a terminal state.

url string required

Required when callback is set; HTTPS URL that receives terminal task notifications.

example https://your-domain.com/hiapi/callback
when enum optional

Callback trigger timing. Use final.

default final enum: final

Example requests

Backlit fur cutout

Tested on a backlit puppy against a busy flower-market background — flyaway fur preserved in the transparent PNG output.

Request body
{
  "model": "recraft/remove-background",
  "input": {
    "image_url": "https://static.hiapi.ai/model-covers/recraft-remove-background/2026/09/01/golden-input-2048.jpg"
  }
}

Getting the result

  1. The response returns a taskId immediately without waiting for generation to finish.
  2. In production, prefer waiting for callback.url to receive the terminal notification. For local debugging, poll GET /v1/tasks/:id.
  3. When status=success, download the transparent-background PNG from output[].url.
  4. When status=fail, fix the request based on the returned error instead of retrying the same invalid payload.

FAQ

What is the output format?

Always a transparent-background PNG (RGBA), regardless of the input format.

What are the input requirements?

PNG/JPG/WebP, up to 5MB, 256-4096 px per side, up to 16 megapixels. Requests beyond these limits fail — validate before submitting.

Do I need a prompt?

No. The model takes a single image URL and has no text parameters.

Next steps