Troubleshoot a failed or incomplete cutout

Separate file-opening, model-download, memory, and edge problems. Find the next useful check without repeatedly changing unrelated settings.

Updated · Maintained by Arunvpp

First identify where the problem happens: opening the file, loading the AI engine, finding the subject, or using the downloaded file. A failed model download and a pale fringe need different fixes. Keep your source file and note the selected mode before retrying.

The file will not open

Try the supplied Logo sample in Plain background mode. If it works, the page can decode and process at least that sample without an AI download. Next try a small JPG or PNG copy of your own source. Keep the original unchanged so a conversion does not become your only copy.

The AI model will not download or initialize

  1. Check the phase shown by the editor. A model download requires a working connection unless its file is already cached. Best quality is about 94 MB, with a separate runtime also needed; a page loading successfully does not prove those resources are reachable.
  2. Try Fast on a small photo. If Fast works and Best quality fails, keep the successful result while investigating the larger mode. Plain background is a useful download-free test for a logo or evenly lit signature, but it does not replace subject detection in a busy photo.
  3. If the editor switches from GPU to CPU, allow it to continue. SansBG retries supported GPU failures through WebAssembly. CPU use can be slower; the fallback message is not itself a failed cutout.
  4. For memory or worker errors, close other demanding tabs and try a smaller source with Fast. Retry one file before opening a batch. A supported browser can still run out of memory on a particular device.
  5. If a download is blocked, use the browser’s Network panel to identify the failed resource and host. The network check explains the distinction between a model request and an image upload. Do not disable security protections as a blanket fix.

A download that does not match the expected model file is rejected. Repeated integrity errors need investigation; there is no user setting to bypass the check. Record the error and try again later rather than downloading an unknown replacement model.

Before clearing site data, save any results you need. Clearing site data can delete Recent downloads and the cached models, causing another download. It is a poor first step when the actual issue is a blocked model host.

Processing finishes, but the outline is wrong

Choose a correction that matches the defect
What you seeWhat to checkUseful next step
A large region of the subject is missingCompare with the original: is the region visible and distinct from the background?Compare Fast and Best quality, then Restore a localized visible part. Use another source if the part is hidden or outside the frame.
A halo or old backdrop color remainsSet Background to Black, then White, and inspect the same edge.Erase an isolated remnant carefully. Source pixels can contain mixed subject and backdrop color; a brush does not reconstruct their original color.
Hair, fur, or whiskers break upInspect focus, contrast, and the detail actually present in the source.Compare Best quality. Retake an out-of-focus or low-contrast source when the required fine detail is not visible.
A reflection survives inside a productDetermine whether it is a real surface reflection or background outside the object.Keep real surface and shape information. Reshoot against a suitable backdrop when the old scene reflected inside the object is unacceptable.
Plain background removes part of the artworkDoes that part share the chosen backdrop color or brightness?Lower Strength or compare Auto with Remove a color. Auto protects enclosed areas only when they are disconnected from the removable border region.
Paper remains when faint ink is preservedCheck for a shadow or gradient across the signature paper.Use more even light. One brightness threshold cannot reliably separate ink and paper that have overlapping brightness.

Choose another photo when the important detail is blurred, occluded, or indistinguishable from its surroundings. Erase and Restore change what is visible from the source; they do not generate new subject detail. For a small repair, follow the Touch up walkthrough.

A batch is incomplete or inconsistent

The batch accepts the first 10, 20, or 40 supported images according to the device profile. Check its accepted file list before Start. Files run sequentially, and one error does not mean the entire folder succeeded or failed.

Match Done rows with the contents of the ZIP. Error rows have no exported file. Retry those source files separately, and reopen any result needing Touch up in the single-image editor. A shared mode and canvas size do not guarantee the same quality or apparent product size across different source photos.

Batch results stay in the open panel and are not saved to Recent downloads. Download the ZIP before closing or reloading. For format or transparency problems, check the saved-file tests rather than rerunning the model.

Send a reproducible problem report

Use Contact with the page URL, browser version, device type, selected mode, source dimensions and format, the phase that failed, and the exact error. State whether a supplied sample also fails. A small non-sensitive reproduction is more useful than a private original; a description is enough to start an investigation.