Model API

Illusion Diffusion

Create illusions conditioned on image.

Model id

Use this in every request
illusion-diffusion

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "illusion-diffusion",
  "input": {
    "image_url": "https://example.com/input.png",
    "prompt": "A red ceramic cup on a wooden table, soft morning light"
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "illusion-diffusion", "quote_id": "QUOTE_ID", "input": {"image_url":"https://example.com/input.png","prompt":"A red ceramic cup on a wooden table, soft morning light"}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for illusion-diffusion
NameTypeDescription
image_urlrequiredstring (image URL)
Input image url.
promptrequiredstring
The prompt to use for generating the image. Be as descriptive as possible for best results.
negative_promptstring
The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small details (e.g. moustache, blurry, low resolution).
guidance_scalenumber
The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.

Default: 7.5

controlnet_conditioning_scalenumber
The scale of the ControlNet.

Default: 1

control_guidance_startnumber
Control Guidance Start

Default: 0

control_guidance_endnumber
Control Guidance End

Default: 1

seedinteger
Seed of the generated Image. It will be the same value of the one passed in the input or the randomly generated that was used in case none was passed.
schedulerstring (enum)
Scheduler / sampler to use for the image denoising process.

Default: Euler

One of: DPM++ Karras SDE, Euler

num_inference_stepsinteger
Increasing the amount of steps tells Stable Diffusion that it should take more steps to generate your final result which can increase the amount of detail in your image.

Default: 40

image_sizestring (enum)
The size of the generated image. You can choose between some presets or custom height and width that **must be multiples of 8**.

Default: square_hd

One of: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt
"outputs": [
  { "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]

Pricing

  • up to$0.60/ run

The exact charge for your input comes from a quote. How charges settle