---
title: "Edit an image with a prompt at lower cost and latency"
method: POST
path: "/v1/edit-lite"
tags: ["generate"]
---

# Edit an image with a prompt at lower cost and latency

`POST /v1/edit-lite`

Edit an image using a text prompt, optimized for lower cost and
latency. Upload the image being edited via the `image` field. Up to 9
additional `reference_images` may be supplied to guide the edit.

Output is always generated at 1K resolution. Input images larger than
1024px on their long edge are downscaled before processing. The
`aspect_ratio` field controls the output aspect ratio only; when
omitted, the output follows the aspect ratio of the image being
edited.

Supported image formats include JPEG, PNG, and WebP.

Images links are available for a limited period of time; if you would like to keep the image, you must download it.

## Response `200`

Image edits generated successfully.

- V1EditImagesResponse — The response which contains information about the edited image, including the download link. Images links are available for a limited period of time; if you would like to keep the image, you must download it.
  - `created` string, date-time, required — The time the request was created.
  - `data` V1EditImageObject[], required — A list of ImageObjects that contain the edited image(s).
    - `url` string, uri, nullable — The direct link to the image generated.
    - `prompt` string, required — The prompt used for the generation. This may be different from the original prompt.
    - `resolution` string, required — Output resolution, only used if operations alters image dimensions, such as upscale, crop etc.
    - `upscaled_resolution` string — Output resolution, only used if operations alters image dimensions, such as upscale, crop etc.
    - `is_image_safe` boolean, required — Whether this request passes safety checks. If false, the url field will be empty.
    - `seed` integer, required — Random seed. Set for reproducible generation.
    - `style_type` 'AUTO' | 'GENERAL' | 'REALISTIC' | 'DESIGN' | 'CUSTOM' | 'FICTION' | 'STYLIZED' — The style type to generate with.

## Other responses

- `400` — Invalid input provided.
- `401` — Not authorized to generate an image.
- `402` — Insufficient credits or quota.
- `422` — Prompt or provided image failed safety checks.
- `429` — Too many requests.
- `503` — Image generation service temporarily unavailable.

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/versions/bcc2d45be91e/schema)