Generation Tools

Remove Background

Removes the background from a product or on-model photo, leaving a clean cutout — the cheapest tool in the catalog, deterministic, with no creative controls.

toolId: "remove_background" 2 credits deterministic

Remove Background result — clean cutout with transparent background

What it does

Fashio strips the background out of the photo you send in, leaving a clean cutout of the product or model. Output preserves the input's framing exactly — the background simply becomes transparent/removed. There's no prompt and no selectors, just the image.

Request body

Field	Type		Description
`toolId`	string	required	Always `"remove_background"`.
`images.user_photo`	string	required	URL of the photo to remove the background from (from `POST /v1/uploads` or your own hosting).

No pose, no ratio, no prompt fields — same minimal shape as Enhance / Upscale.

Example request

curl -X POST https://api.fashiolabs.com/v1/generations \
  -H "Authorization: Bearer fio_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "toolId": "remove_background",
    "images": {
      "user_photo": "https://your-cdn.com/photo.jpg"
    }
  }'

const res = await fetch("https://api.fashiolabs.com/v1/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.FASHIO_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    toolId: "remove_background",
    images: {
      user_photo: "https://your-cdn.com/photo.jpg",
    },
  }),
});
const { id } = await res.json();

import os, requests

res = requests.post(
    "https://api.fashiolabs.com/v1/generations",
    headers={"Authorization": f"Bearer {os.environ['FASHIO_API_KEY']}"},
    json={
        "toolId": "remove_background",
        "images": {
            "user_photo": "https://your-cdn.com/photo.jpg",
        },
    },
)
job_id = res.json()["id"]

Response

202 Accepted{ "success": true, "id": "8b1e...", "status": "processing" }

Poll GET /v1/generations/:id (see Quickstart) until it completes:

200 · completed{
  "success": true,
  "id": "8b1e...",
  "status": "completed",
  "resultUrls": ["https://.../result.jpg"],
  "errorMessage": null
}

Common errors

Status	Meaning
400	`remove_background: missing required image "user_photo"` — required image field wasn't resolvable.
402	`Insufficient diamonds. Required 2, have <n>.`
429	Daily request cap reached for this key — see Rate Limits.

Enhance / Upscale — another deterministic, no-prompt pass on an existing photo.
Mannequin to Flat Lay — a more involved product-photo transform.