Use this guide along with the Onboarding and Quickstart for Imagen API.
You must edit your photos to use the AI tools.
AI tools offer more photo processing that improves the editing of the photos in the project. You can mix and match the AI tools according to your needs. Some AI tools are mutually exclusive, so you must choose one or the other, as the table below explains. Others are geared to specific photography types like real estate or sports.
| AI tool parameter | Description | Default value |
| crop | Crops to a 2x3 aspect ratio for optimal composition in many types of photography. It can’t be used together with headshot_crop or portrait_crop. |
Boolean false |
| crop_aspect_ratio |
Changes the aspect ratio from the default aspect ratio for crop, headshot_crop, and portrait_crop. Example: “crop_aspect_ratio”: “2X3” |
2X3 |
| headshot_crop |
Aligns and sizes all your headshots consistently, making it ideal for yearbook and professional headshots. It centers the subject and aligns the eyes to the same horizontal line, across photos. It can’t be used together with crop or portrait_crop. Use crop_aspect_ratio to change the aspect ratio to 1 x 1, 2 x 3, or 5 x 7. |
Boolean false |
| hdr_merge |
Important: Only use with real estate photography. Combines multiple photos with different exposures into one photo so that the exposure for the outside and the inside are both correct. It is used primarily for real estate photography. See HDR Merge for real estate for the requirements. With HDR Merge, DNG photos must contain RAW data. DNG photos with JPEG data are not supported. |
Boolean false |
| hdr_output_compression |
Used with hdr_merge. The default compression is LOSSY, which best balances editing speed with high quality. To remove compression without a significant increase in quality, change this param to LOSSLESS. Processing time will increase dramatically with this compression type. Example: “hdr_output_compression”: “LOSSY” |
LOSSY |
| perspective_correction | Corrects distortions in real estate photography caused by wide-angle lenses or imperfect shooting angles so that vertical and horizontal lines are straight. It can’t be used together with straighten. |
Boolean false |
| portrait_crop |
Centers the main subject of each photo and then crops with a 4 x 5 aspect ratio. It keeps optimal spacing above the head and other key details. Recommended for portrait and studio shoots as well as school and sports. It can’t be used together with crop or headshot_crop. Use crop_aspect_ratio to change the aspect ratio to 2 x 3 or 5 x 7. |
Boolean false |
| straighten | Rotates each photo according to its horizon. It can’t be used together with perspective_correction. |
Boolean false |
| subject_mask | Selects the photo's main subject in a similar way to Lightroom, applies a mask using brushes, and then applies a local AI edit to that mask. |
Boolean false |
| smooth_skin | Reduces the visibility of imperfections in the skin, such as fine lines and blemishes, resulting in a more polished and visually appealing complexion. |
Boolean false |
| sky_replacement |
Important: Only use with real estate photography. Choose between different skies for your photos. Used with sky_replacement_template_id to choose the sky. These changes to the sky are saved in the XMP metadata. When you review the photos, you can adjust the sky in Adobe editing software. See Download and review edited photos in Adobe software for more info. |
Boolean false |
| sky_replacement_template_id |
Important: Only use with real estate photography. Identifier for the sky. To see the choices for a new sky, you need to open the app, create a project for real estate photography, and choose the Sky Replacement AI tool. Here is the key: 1: Sky 1 2: Sky 2 3: Sky 3 4: Sky 4 5: Sky 5 6: Sky 6 7: Sky 7 8: Sky 8 9: Sky 9 10: Sky 10 11: Sky 11 12: Sky 12 Example: “sky_replacement_template_id”: ”5” |
null |
| window_pull | Optimizes exposure to balance interior and exterior lighting. It works with HDR bracketed shots and post-HDR merged photos, eliminating hours of manual window masking. Recommended for real estate photography. |
Boolean false |
Mutually exclusive AI tools
Some similar AI tools are mutually exclusive from each other. Choose:
- crop, headshot_crop, or portrait_crop
- perspective_correction or straighten.
AI tools for different photography types
Real estate
For real estate photography, use hdr_merge, perspective_correction, sky_replacement, and window_pull. Make sure you don't use the Straighten AI tool.
School and sports
For school and sports photography, use portrait_crop or headshot_crop.
General for all types
These AI tools are good for most photography types.
- crop
- straighten
- subject_mask
- smooth_skin