Shadow Remove API

Reduce unwanted shadows in a portrait image. This endpoint is useful when lighting is uneven but the original photo still contains recoverable detail.

Shadow removal is a focused edit. It does not select a passport or visa specification, resize the photo to document dimensions, or replace the complete Passport Photo API workflow.

API endpoint

• https://api-us.idphotoapp.com — US region
• https://api-eu.idphotoapp.com — EU region

POST /v2/removeShadow

Request

Field	Type	Required	Default	Description
apiKey	string	Yes	—	Your API key.
apiSecret	string	Yes	—	Your API secret.
imageBase64	string	Yes	—	Base64 image data, with or without a data URI prefix.
outputFormat	string	No	JPEG	JPEG or PNG.
outputType	string	No	IMAGE_BASE64	Output representation.

{
  "apiKey": "your-api-key",
  "apiSecret": "your-api-secret",
  "imageBase64": "data:image/jpeg;base64,...",
  "outputFormat": "JPEG",
  "outputType": "IMAGE_BASE64"
}

Response

{
  "output": "/9j/4AAQSkZJRgABAQ..."
}

Decode output as binary image data before saving or passing it to another image-processing step.

Usage notes

• Results are best when facial detail remains visible in the shadowed area.
• Clipped highlights and completely black regions may not contain recoverable detail.
• Review the processed image before passing it to a document-photo workflow.
• Removing a shadow does not by itself determine whether a photo meets a particular document specification.