Limits
Check file size, resolution and input grouping before submitting a shoot.
Uploads
| Constraint | Limit |
|---|---|
| File size | 150 MiB per file; 20 MiB for HEIC images. |
| Input resolution | Up to 64 megapixels (width × height ≤ 64,000,000). |
| Standard image normalization | Images exceeding 6000 pixels on the longest edge are downscaled, preserving aspect ratio. |
| Camera RAW | Stored without image normalization at upload; developed when ordered, with a longest-edge cap of 6144 pixels. |
One MiB is 1,048,576 bytes. The pixel ceiling is checked before normalization: an image above 64 megapixels is refused rather than downscaled. An image within that ceiling can exceed the longest-edge cap and be resized. These caps are maximums, not a promise that every feature returns the input dimensions.
Supported inputs are JPEG, PNG, WebP, single-page TIFF, AVIF, HEIC/HEIF still images and camera RAW. RAW extensions include NEF, CR2, CR3, ARW, DNG, RAF, RW2, ORF, PEF and SRW. Animated images, multi-page TIFF, GIF, SVG, PDF and video are not supported photo inputs.
A successful upload declaration does not mean the image is ready. Confirm the upload and wait for ready. On failed, inspect data.code and data.reason from GET /v1/assets/:id/status. See the upload walkthrough.
Orders and batches
- Each order accepts 1–5 ready, uploaded assets belonging to your API key: exposure brackets of one scene.
- Camera RAW and standard images cannot be mixed in the same order.
- Magic Eraser takes exactly one input image and a separately uploaded mask. White marks the region to erase.
- A batch accepts 1–100 scenes; the same input rules apply to each scene.
Delivery and export IDs can be downloaded or exported. They are currently not accepted directly as new order inputs. To process a result again, download it and upload it as a new asset.
Delivery and exports
Orders deliver JPEG, PNG or WebP in 8-bit sRGB. The quality option is an integer from 1 to 100 (default 92) for JPEG/WebP encoding; it does not select a generation tier.
Exports accept max_edge from 16 to 10,000 pixels. They preserve aspect ratio and never enlarge the source. See Exports for the request and download flow.
Processing and requests
Processing time depends on the inputs, selected features, generation tier and current load. Follow progress events and handle every terminal state. A client timeout does not cancel an order; use the cancellation endpoint. Request quotas are covered under Rate limits.