Remix with Ideogram 4.0 | Ideogram

{
  "created": "2024-01-15T09:30:00Z",
  "data": [
    {
      "prompt": "prompt",
      "resolution": "1024x1024",
      "is_image_safe": true,
      "seed": 12345,
      "url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89"
    },
    {
      "prompt": "prompt",
      "resolution": "1024x1024",
      "is_image_safe": true,
      "seed": 12345,
      "url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89"
    }
  ],
  "response_type": "url"
}

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.

Authentication

Api-Keystring

API key for access control. Use in the header with the name "Api-Key"

Request

A request to remix an image with Ideogram 4.0.

imagefileRequired

The initial image binary (max 25MB); only JPEG, WebP and PNG formats are supported.

text_promptstringRequired

The text prompt that guides the remix.

image_weightintegerOptional1-100

Optional. How strongly the output should resemble the input image. Higher values keep the input image's structure; lower values allow the prompt to drive the output more. When omitted, the weight is chosen automatically from the edit instruction; supplying a value overrides that automatic choice. Only accepted when the output keeps the input image's shape: combining image_weight with a resolution whose aspect ratio differs from the input image's is rejected with a 400.

resolutionenumOptional

Optional. When supplied, the images are generated at this resolution. When omitted, the input image's shape is kept. A resolution whose aspect ratio differs from the input image's cannot be combined with image_weight.

rendering_speedenumOptionalDefaults to DEFAULT

The rendering speed to use.

Allowed values:

enable_copyright_detectionboolean or nullOptional

Optional. Opt this request into post-generation copyright detection (Hive likeness + logo checks). See GenerateImageRequestV3 for details.

Response

Image(s) generated successfully.

createddatetime

The time the request was created.

datalist of objects

A list of ImageObjects that contain the generated image(s).

response_typeenumOptional

Discriminator for the postGenerateDesignV4 oneOf response. Always "url" for this shape.

Allowed values:

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error