Skip to content

Ideogram V4.0q Image to Image

Integrate

Model id ideogram/v4/image-to-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/v4/image-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Files like the example: $0.015 15 API credits your files are measured before the run Run it on this page

Get API key
Ideogram Image Editing #realism#typography#stylized

V4 image-to-image restyling that keeps structure, with auto size matching and strength control

Ideogram · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required

Prompt that guides image generation.

•required image_url
Drop a file, or

Source image URL used for image-to-image generation.

image_size default auto

Set the output dimensions, or select 'auto' to retain the input dimensions within these limits: approximately 25MP total and 8192px maximum on either side.

rendering_speed default BALANCED

Rendering speed setting; faster options perform fewer denoising steps.

num_images default 1

Count of images to produce.

Advanced expansion_model · acceleration · output_format · strength · seed · enable_safety_checker
expansion_model default Medium

Choose the prompt-expansion model: 'Large' provides the highest quality through Ideogram's Magic Prompt, while 'Medium' prioritizes speed. Select 'None' to leave the prompt unexpanded.

acceleration default none

Acceleration setting for generating images.

output_format default jpeg

File format for the resulting image.

default 0.8

Degree of image transformation: smaller settings keep the result nearer the source, whereas at 1.0 the source has no influence.

Seed for generation, selected randomly unless you supply a value.

POST /run/ideogram/v4/image-to-image?wait=20 quote → $0.015
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/v4/image-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Ideogram V4.0q Image to Image

Transforms an input image (`image_url`) with a `prompt`. `strength` ranges 0 to 1 (default 0.8), where 1.0 ignores the input. `image_size` defaults to auto, matching the source image. Also offers `expansion_model`, `rendering_speed`, `acceleration`, 1 to 4 outputs and JPEG or PNG format.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
Prompt that guides image generation.
expansion_modeloptional
Typeenum
DefaultMedium
NoneMediumLarge
Choose the prompt-expansion model: 'Large' provides the highest quality through Ideogram's Magic Prompt, while 'Medium' prioritizes speed. Select 'None' to leave the prompt unexpanded.
image_sizeoptional
Typeobject
Defaultauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Set the output dimensions, or select 'auto' to retain the input dimensions within these limits: approximately 25MP total and 8192px maximum on either side.
rendering_speedoptional
Typeenum
DefaultBALANCED
TURBOBALANCEDQUALITY
Rendering speed setting; faster options perform fewer denoising steps.
accelerationoptional
Typeenum
Defaultnone
nonelowregularhigh
Acceleration setting for generating images.
num_imagesoptional num_outputs
Typeinteger
Default1
1 – 4
Count of images to produce.
seedoptional
Typeinteger | null
Seed for generation, selected randomly unless you supply a value.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Safety-checking switch whose off setting requires account authorization. Without that authorization, every request is checked regardless of the setting; true enables the checker.
output_formatoptional
Typeenum
Defaultjpeg
jpegpng
File format for the resulting image.
image_urlrequired image
Typeurl · image
Source image URL used for image-to-image generation.
strengthoptional
Typenumber
Default0.8
0 – 1
Degree of image transformation: smaller settings keep the result nearer the source, whereas at 1.0 the source has no influence.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v4/image-to-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 15,
    "usd": "0.015",
    "charged": 15,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
images
array of object {url, content_type, file_name, file_size, width, height}Images produced by the model.
timings
object
seed
integerImage-generation seed, including the randomly chosen value if the input omitted a seed; otherwise, it repeats the supplied value.
has_nsfw_concepts
array of booleanIndicates whether NSFW concepts appear in the generated images.
prompt
stringPrompt used during image generation.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/developers/models/ideogram/v4/image-to-image.md. All models and guides: https://doitong.com/developers/llms.txt