Photoshop APIs

Auto crop

Changed on

Generates smart crops, subject bounding boxes, and detects objects for an input image. The request is processed asynchronously. Poll GET /v2/status/{jobId} with the returned jobId for completion.

post/v1/auto-crop

Request

  • Base URL: https://image.adobe.io
  • URL: https://image.adobe.io/v1/auto-crop
  • Auth: HTTP bearer and API key in header X-Api-Key

Request body

focusstring[]

Focus labels, ordered by preference, used to prioritize objects during cropping or as detection targets. Required for 'subjectCrop' and 'objectDetection'; must be empty for 'smartCrop' and 'fullSceneDetection'.

mode'smartCrop' | 'subjectCrop' | 'fullSceneDetection' | 'objectDetection' required

Mode for the auto crop operation. 'smartCrop' and 'subjectCrop' generate crops using aspectRatio with optional zoom. 'fullSceneDetection' and 'objectDetection' detect subjects or objects in the scene.

outputType'images' | 'boundingBoxes'

Output type for the auto crop operation. 'images' returns cropped images with presigned URLs (default). 'boundingBoxes' returns only bounding box coordinates.

Example request

{
  "focus": [
    "logo",
    "person"
  ]
}

Response

Job accepted for processing

jobIdstring
statusUrlstring

Changes