Login Sign up
Ideogram API · Capability

Edit with a prompt

Edit an existing image by describing the change in natural language. The scene is preserved while the prompted change is added.

POST /v1/edit

Get an API key Read the docs

Examples

Each call takes a request and returns a hosted image URL you can route into your product.

Request
Input
A plain white mug on a table
POST /v1/edit { "images": "mug.png" , "prompt": "add a slice of cake on a plate beside the mug" }
Response 200
Output
The mug with a slice of cake beside it
{ "created": "2026-06-02T16:24:11Z", "data": [ { "url": "https://api.ideogram.ai/images/ephemeral/…-edit.png" , "resolution": "1024x1024" , "is_image_safe": true } ] }
Request
Input
A potted plant on a windowsill
POST /v1/edit { "images": "plant.png" , "prompt": "add a small orange cat sitting next to the plant" }
Response 200
Output
The plant with an orange cat beside it
{ "created": "2026-06-02T16:24:11Z", "data": [ { "url": "https://api.ideogram.ai/images/ephemeral/…-edit.png" , "resolution": "1024x1024" , "is_image_safe": true } ] }

More capabilities

Generate Transparent backgrounds Remix Reframe Remove background Layerized text Custom models Upscale

Back to the API overview

Start building with Ideogram today

Build with API Try in App