API Overview
The Ideogram API brings Ideogram’s image and video models into your product. Every v2 endpoint follows one pattern, POST /v2/{content}/{action}/{model}, so the model you call is always in the URL: for example /v2/image/generate/ideogram-4-5.
Edit precisely with Ideogram 4.5
Tell Ideogram 4.5 what to change and the edit targets what you describe. With Precise Edit, the result comes back at your image’s own width and height. Check the areas outside the edit before you use the result.
Original, then “Change the product’s color and finish to slate-blue knit”, then two edits later with a gum sole and a pale lilac backdrop. In this example the shoes keep their shape and position across the edits.



What you can build
Quickstart
Create an API key by following the Setup guide and store it in the IDEOGRAM_API_KEY environment variable. Then generate an image with Ideogram 4.5 and make a precise edit to it. Both requests return their results directly. Image URLs expire after 24 hours, so download anything you want to keep. The Quickstart walks through one request step by step.
Python
TypeScript
cURL
Long-running requests
Video, tool and SVG endpoints, Replace Background, Remove Objects and Reframe with Nano Banana 2 always run asynchronously, and other image endpoints do too when you set async or supply a webhook_url. They return a generation_id straight away: poll GET /v2/generations/{generation_id} until status is completed or failed, or receive the result at your webhook. See Responses and metadata for what to store, and Build a reliable production integration for the whole lifecycle. To edit one area of an image, see Edit one region with a mask.
Moving from v1
The v1 API keeps working, and its reference stays available under v1 in the version switcher. Most v1 endpoints have a v2 replacement with the model in the path; Model lifecycle and deprecations lists all of them. Request fields differ in places (for example, v1’s text_prompt is v2’s prompt), so check each endpoint’s reference. Custom model training (datasets and training runs) is available only in v1; v2 generates with a model you have already trained. See the v1 training tutorial.
Higher limits
Your organization can have 10 images and videos in progress at once by default. To raise the limit, contact partnership@ideogram.ai. See Rate limits.