Remix (legacy) | Ideogram

1 curl -X POST https://api.ideogram.ai/remix \ 2 -H "Api-Key: <apiKey>" \ 3 -H "Content-Type: multipart/form-data" \ 4 -F image_request='{ 5 "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.", 6 "aspect_ratio": "ASPECT_10_16", 7 "image_weight": 50, 8 "magic_prompt_option": "ON", 9 "model": "V_2" 10 }' \ 11 -F image_file=@string

1 { 2 "created": "2000-01-23 04:56:07+00:00", 3 "data": [ 4 { 5 "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there's an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.", 6 "resolution": "1024x1024", 7 "is_image_safe": true, 8 "seed": 12345, 9 "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g", 10 "upscaled_resolution": "4096x4096", 11 "style_type": "REALISTIC" 12 } 13 ] 14 }

Remix provided images synchronously based on a given prompt and optional parameters.

Input images are cropped to the chosen aspect ratio before being remixed.

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.

Authentication

Api-Keystring

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

Request

A request to remix a provided image with Ideogram. Input images are cropped to the chosen aspect ratio before being remixed.

image_requestobjectRequired

A request to generate a new image using a provided image and a prompt.

image_filefileRequired

An image binary (max size 10MB); only JPEG, WebP and PNG formats are supported at this time.

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).

Authentication

Request

Response

Errors