---
title: "Image-to-image with Ideogram 4.0"
method: POST
path: "/v1/ideogram-v4/image-to-image"
tags: ["generate"]
---

# Image-to-image with Ideogram 4.0

`POST /v1/ideogram-v4/image-to-image`

Generates images synchronously using the Ideogram 4.0 model with an initial image as input.

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(s) generated successfully.

- ImageGenerationResponseV4ImageToImage — The response which contains information about the generated image-to-image output, 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.
  - `response_type` 'url' — Always "url" for this shape.
  - `created` string, date-time, required — The time the request was created.
  - `data` ImageGenerationObjectV4ImageToImage[], required — A list of ImageObjects that contain the generated 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` '2048x2048' | '1440x2880' | '2880x1440' | '1664x2496' | '2496x1664' | '1792x2240' | '2240x1792' | '1440x2560' | '2560x1440' | '1600x2560' | '2560x1600' | '1728x2304' | '2304x1728' | '1296x3168' | '3168x1296' | '1152x2944' | '2944x1152' | '1248x3328' | '3328x1248' | '1280x3072' | '3072x1280' | '1024x3072' | '3072x1024' | '1024x1024' | '896x1120' | '1120x896' | '864x1152' | '1152x864' | '832x1248' | '1248x832' | '800x1280' | '1280x800' | '720x1280' | '1280x720' | '720x1440' | '1440x720' | '512x512' | '768x384' | '384x768', required — Output resolutions for Ideogram 4.0 image-to-image. Superset of ResolutionV4 (the 1K/2K t2im set) plus the small 512-tier (512x512, 768x384, 384x768).
    - `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.

## Other responses

- `400` — Invalid input provided.
- `401` — Not authorized.
- `422` — Prompt failed the safety check.
- `429` — Too many requests.

---

[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/revisions/bd40f367a834/schema)