Deprecation announcement

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

Copy
curl -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
  }'
Copied to your clipboard
curl -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

Copy
curl -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
  }'
Copied to your clipboard
curl -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
  }'