Model API

Creative Upscaler

Create creative upscaled images.

Model id

Use this in every request
creative-upscaler

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": "creative-upscaler",
  "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": "creative-upscaler", "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 creative-upscaler
NameTypeDescription
model_typestring (enum)
The type of model to use for the upscaling. Default is SD_1_5

Default: SD_1_5

One of: SD_1_5, SDXL

image_urlrequiredstring (image URL)
The image to upscale.
promptstring
The prompt to use for generating the image. Be as descriptive as possible for best results. If no prompt is provide BLIP2 will be used to generate a prompt.
scalenumber
The scale of the output image. The higher the scale, the bigger the output image will be.

Default: 2

creativitynumber
How much the output can deviate from the original

Default: 0.5

detailnumber
How much detail to add

Default: 1

shape_preservationnumber
How much to preserve the shape of the original image

Default: 0.25

prompt_suffixstring
The suffix to add to the prompt. This is useful to add a common ending to all prompts such as 'high quality' etc or embedding tokens.

Default: high quality, highly detailed, high resolution, sharp

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

Default: blurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy

seedinteger
The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.
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

num_inference_stepsinteger
The number of inference steps to use for generating the image. The more steps the better the image will be but it will also take longer to generate.

Default: 20

skip_ccsrboolean
If set to true, the image will not be processed by the CCSR model before being processed by the creativity model.

Default: false

override_size_limitsboolean
Allow for large uploads that could take a very long time.

Default: false

base_model_urlstring (URL)
The URL to the base model to use for the upscaling
additional_lora_urlstring (URL)
The URL to the additional LORA model to use for the upscaling. Default is None
additional_lora_scalenumber
The scale of the additional LORA model to use for the upscaling. Default is 1.0

Default: 1

additional_embedding_urlstring (URL)
The URL to the additional embeddings to use for the upscaling. Default is None

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