Model API

Stable Diffusion XL

Run SDXL at the speed of light

Model id

Use this in every request

fast-sdxl/inpainting

This model has other modes with their own ids: fast-sdxl, fast-sdxl/image-to-image.

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": "fast-sdxl/inpainting",
  "input": {
    "image_url": "https://example.com/input.png",
    "mask_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": "fast-sdxl/inpainting", "quote_id": "QUOTE_ID", "input": {"image_url":"https://example.com/input.png","mask_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 fast-sdxl/inpainting
Name	Type	Description
`image_url`required	string (image URL)	The URL of the image to use as a starting point for the generation.
`mask_url`required	string (image URL)	The URL of the mask to use for inpainting.
`prompt`required	string	The prompt to use for generating the image. Be as descriptive as possible for best results.
`negative_prompt`	string	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).
`image_size`	string (enum)	The size of the generated image. Default: `square_hd` One of: `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9`
`num_inference_steps`	integer	The number of inference steps to perform. Default: `25`
`guidance_scale`	number	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`
`strength`	number	determines how much the generated image resembles the initial image Default: `0.95`
`seed`	integer	The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.
`sync_mode`	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history. Default: `false`
`num_images`	integer	The number of images to generate. Default: `1`
`loras`	array of objects	The list of LoRA weights to use.
`embeddings`	array of objects	The list of embeddings to use.
`enable_prompt_expansion`	boolean	If set to true, the prompt will be expanded with additional prompts. Default: `false`
`format`	string (enum)	The format of the generated image. Default: `jpeg` One of: `jpeg`, `png`

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