---
title: "Remix with Ideogram 4.0"
method: POST
path: "/v1/ideogram-v4/remix"
tags: ["generate"]
---

# Remix with Ideogram 4.0

`POST /v1/ideogram-v4/remix`

Remix an image synchronously using the Ideogram 4.0 model with an initial image and a prompt.

Mirrors `/v1/ideogram-v3/remix` semantics (including `image_weight` for how strongly the
output should resemble the input image) but routes the request through the V_4_0 model.

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

## Headers

- `Api-Key` string, required

## Response `200`

Image(s) generated successfully.

- ImageGenerationResponseV4 — The response which contains information about the generated 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.
  - `response_type` 'url' — Discriminator for the postGenerateDesignV4 oneOf response. Always "url" for this shape.
  - `created` string, date-time, required — The time the request was created.
  - `data` ImageGenerationObjectV4[], 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` string, required — The output resolution of the image, in the format WIDTHxHEIGHT (e.g. 1024x1024). Not limited to the request resolution presets, since some endpoints accept custom output sizes.
    - `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.

## Changes

- **2026-08-28** `d4cec35f719f` — 1 info
  - api operation id `post-remix-image-v-4` removed and replaced with `post_remix_image_v4`
- **2026-08-21** `5b667dae2a60` — 2 warning
  - the `image_weight` request property's max was set to `100.00`
  - the `image_weight` request property's min was set to `1.00`

[Change history](https://skmtc.dev/ideogram/apis/api-reference/changes/v1/ideogram-v4/remix/post.md)

---

[API](https://skmtc.dev/ideogram/apis/api-reference.md) · [All operations](https://skmtc.dev/ideogram/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideogram/api-reference/revisions/d4cec35f719f/schema)