Product overview
Imagen is an AI-powered solution that eliminates hours of busy work from post-production for professional photographers.
How does it work?
Photographers choose an AI Profile for editing and upload photos to Imagen. Imagen edits the photos with the AI Profile in a fraction of the time that the manual process takes.
Imagen API streamlines and automates the photographer’s post-production editing workflow, similar to the Imagen app. This document explains the flow and the endpoints you need to call. Some of the functionality in the Imagen app isn’t yet in the API. This documentation covers the endpoints supported by Imagen API.
Get started
Review the information in this section to make sure your environment is ready and you understand the basics of working with the API.
Sign-up and choose a profile in the Imagen app
You need to sign up for Imagen on the Business plan before you can use Imagen API. Then, email support to ask for an API key. In your email, include the email address you used to sign up for Imagen.
We suggest trying out Imagen in the app first to pick an AI Profile or create your own. After you have a profile, you can start automating your editing with our API.
Imagen base URL
The base URL for the Imagen API is https://api.imagen-ai.com/v1/.
Authentication
Imagen API uses an API key for authentication. Add it as a header to your requests in text format. The header name is x-api-key.
Here is an example:
curl --location ‘https://api-beta.imagen-ai.com/v1/profiles/’ \
--header ‘x-api-key: <api_key>’ \
--header ‘Content-Type: application/json’
Supported file formats for editing photos
Imagen API supports these file formats for editing photos:
- RAW: NEF, CR2, CR3, ARW, NRW, CRW, SRF, SR2, ORF, RW2, RAF, PTX, PEF, RWL, SRW, 3FR, and FFF
- DNG: For HDR Merge, DNG photos must contain RAW data. DNG photos with JPEG data are not supported.
- JPEG
Ways to try Imagen API
Start using Imagen API in minutes with the SDK in Python
Use the Imagen API with only one line of code with our SDK in Python. Before you begin, make sure to read the README.md. If you have any questions, check Quickstart to Imagen API and AI tool reference for Imagen API for help.
Try our code samples
Use our quickstart
Use our quickstart to learn how the Imagen API works and to customize your flow with code samples and links to our reference API documentation.
Start with a Python code sample
Our Python code sample shows you how to call the Imagen API endpoints to edit photos. It also demonstrates threading, which lets you upload or download the photos in a project concurrently rather than one by one.
Test with our Postman collection
Use our Postman collection to test the Imagen API endpoints.
- Download the Postman collection to your computer.
- Open Postman.
- Go to File > Import to open the collection in Postman.