Deprecation announcement
The Remove Background V1 API (/sensei/cutout) and the Mask API (/sensei/mask) are being deprecated in favor of the Remove Background V2 API (/v2/remove-background).
Remove Background V2 now supports both cutout and mask workflows through a single endpoint. The Remove Background V1 API and Mask API will reach End of Life (EOL) on October 15, 2025. After this date, they will no longer be supported or accessible.
Please begin migration to Remove Background V2 as soon as possible to ensure uninterrupted service.
For guidance about this change, refer to the FAQs below.
Migrate to the Remove Background V2 API before October 15, 2025 to avoid service disruptions.
Remove Background V2 now handles both cutout and mask workflows using a single endpoint. To specify which operation you want, set the "mode" parameter in your request to "cutout" for background removal or "mask" for generating a mask. This allows a single API to support both workflows while ensuring consistent, high-quality results.
We're moving to the Remove Background V2 API because it delivers:
- Cleaner cutouts - The improved post-processing reduces matting and creates sharper edges.
- Higher quality automation - Outputs with V2 are optimized for production pipelines and automated workflows.
- Ongoing support - V2 is the actively supported service that will receive updates and improvements.
Deprecation Notice: September 2, 2025.
End of Life (EOL): October 15, 2025.
The latest comprehensive information about all Photoshop APIs is available on the API Reference page.
For technical details specifically about the Remove Background V2 API, refer to the Remove Background V2 endpoint.
Your Adobe Customer Success Manager and Support Team are available to answer questions and guide you through the transition.
Cutout workflow
Copied to your clipboardcurl -i -X POST \https://image.adobe.io/v2/remove-background \-H 'Authorization: string' \-H 'Content-Type: application/json' \-H 'x-api-key: YOUR_API_KEY_HERE' \-d '{"image": {"source": {"url": "string"}},// Set "mode:" to "cutout" for background removal"mode": "cutout","output": {"mediaType": "image/jpeg"},"trim": false,"backgroundColor": {"red": 255,"green": 255,"blue": 255,"alpha": 1},"colorDecontamination": 1}'
Mask workflow
Copied to your clipboardcurl -i -X POST \https://image.adobe.io/v2/remove-background \-H 'Authorization: string' \-H 'Content-Type: application/json' \-H 'x-api-key: YOUR_API_KEY_HERE' \-d '{"image": {"source": {"url": "string"}},// Set "mode:" to "mask" to generate a mask of the subject"mode": "mask","output": {"mediaType": "image/png"},"trim": false,"backgroundColor": {"red": 255,"green": 255,"blue": 255,"alpha": 1},"colorDecontamination": 1}'

