Edit（Image Edition）

POST

/ideogram/edit

Image-to-image generation from Ideogram, with its key advantage being the ability to generate accurate text and posters.
Official Documentation：https://api-docs.ideogram.ai/reference/post_remix_image

Price：Ideogram 2.0 - 0.08 PTC/call
Price：Ideogram 2.0 Turbo - 0.05 PTC/call
Price：Ideogram 1.0 - 0.06 PTC/call
Price：Ideogram 1.0 Turbo - 0.02 PTC/call

Request

Header Params

Body Params multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/ideogram/edit' \
--header 'Authorization: Bearer ' \
--form 'image_file=@""' \
--form 'mask=@""' \
--form 'prompt=""' \
--form 'model="V_2_TURBO"' \
--form 'magic_prompt_option="AUTO"' \
--form 'seed=""' \
--form 'style_type="AUTO"'

Responses

🟢200success

application/json

Body

Example

{
    "created": "2026-01-15T03:57:34.656955+00:00",
    "data": [
        {
            "is_image_safe": true,
            "prompt": "A pair of athletic shoes, predominantly in a dark gray color with black accents. The shoes have a breathable mesh upper, a white sole, and a distinctive black swoosh on the side. They are designed with a comfortable lace-up system and appear to be suitable for casual or sports activities.",
            "resolution": "1024x1024",
            "seed": 1099344557,
            "url": "https://file.302.ai/gpt/imgs/20260115/150548faf11a468f921acb283a7e896c.png"
        }
    ]
}

Modified at 2026-01-15 03:58:40

Describe（Image Description）

SeedEdit_v3.0 (Image Command Editing)