Skip to content

Illusion Diffusion

Integrate

Model id illusion-diffusion
# 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/illusion-diffusion?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

This request: ≈$0.022 22 API credits Run it on this page

Get API key
Open model Text to Image #composition#stylized

Generates illusion-style images by conditioning a text prompt on an input image through ControlNet

Open model · 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

Describe the image you want generated, using as much detail as possible to get the best results.

•required image_url
Drop a file, or

URL of the input image.

image_size default square_hd

Output image dimensions, selected from presets or specified as custom width and height. Both custom dimensions must be divisible by 8.

Advanced negative_prompt · scheduler · guidance_scale · controlnet_conditioning_scale · control_guidance_start · control_guidance_end · num_inference_steps · seed · enable_safety_checker
default

Negative prompt specifying image details to exclude, including colors, objects, scenery, or finer features. Examples include a moustache, blur, or low resolution.

scheduler default Euler

Scheduler or sampler used to denoise the image.

default 7.5

Prompt-adherence strength for image selection, expressed as CFG (Classifier Free Guidance).

default 1

Scale applied to ControlNet conditioning.

default 0
default 1
default 40

Control how many generation steps Stable Diffusion performs; additional steps may yield a more detailed final image.

Image-generation seed, including the randomly chosen value if the input omitted a seed; otherwise, it repeats the supplied value.

POST /run/illusion-diffusion?wait=20 quote → $0.022
# 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/illusion-diffusion?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 Illusion Diffusion

Takes a required `image_url` and `prompt` and blends the image's shapes into the generated picture, which suits optical-illusion art. Adjust `controlnet_conditioning_scale`, `control_guidance_start` and `control_guidance_end` to set how strongly the source guides the result. It also offers `negative_prompt`, `guidance_scale` from 0 to 50, 0 to 80 inference steps, and Euler or DPM++ Karras SDE schedulers.

Parameters

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

NameType DefaultAllowed Description
image_urlrequired image
Typeurl · image
URL of the input image.
promptrequired
Typestring
Describe the image you want generated, using as much detail as possible to get the best results.
negative_promptoptional
Typestring
Default
Negative prompt specifying image details to exclude, including colors, objects, scenery, or finer features. Examples include a moustache, blur, or low resolution.
guidance_scaleoptional
Typenumber
Default7.5
≤ 50> 0
Prompt-adherence strength for image selection, expressed as CFG (Classifier Free Guidance).
controlnet_conditioning_scaleoptional
Typenumber
Default1
Scale applied to ControlNet conditioning.
control_guidance_startoptional
Typenumber
Default0
0 – 1
control_guidance_endoptional
Typenumber
Default1
0 – 1
seedoptional
Typeinteger | null
Image-generation seed, including the randomly chosen value if the input omitted a seed; otherwise, it repeats the supplied value.
scheduleroptional
Typeenum
DefaultEuler
DPM++ Karras SDEEuler
Scheduler or sampler used to denoise the image.
num_inference_stepsoptional
Typeinteger
Default40
0 – 80
Control how many generation steps Stable Diffusion performs; additional steps may yield a more detailed final image.
image_sizeoptional
Typeobject
Defaultsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Output image dimensions, selected from presets or specified as custom width and height. Both custom dimensions must be divisible by 8.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Screening can be relaxed by setting false, provided the caller is authorized.
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": "illusion-diffusion",
  "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": 22,
    "usd": "0.022",
    "charged": 22,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "image": {
      "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
    },
    "seed": 42
  },
  "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
image
object {url, content_type, file_name, file_size, width, height}File information for the generated image.
seed
integerImage-generation seed, including the randomly chosen value if the input omitted a seed; otherwise, it repeats the supplied value.

For AI agents: this page as Markdown is at https://doitong.com/en-GB/developers/models/illusion-diffusion.md. All models and guides: https://doitong.com/developers/llms.txt