Model API

Lumina Image 2

Lumina-Image-2.0 is a 2 billion parameter flow-based diffusion transforer which features improved performance in image quality, typography, complex prompt understanding, and resource-efficiency.

Model id

Use this in every request
lumina-image/v2

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": "lumina-image/v2",
  "input": {
    "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": "lumina-image/v2", "quote_id": "QUOTE_ID", "input": {"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 lumina-image/v2
NameTypeDescription
promptrequiredstring
The prompt to generate an image from.
image_sizestring (enum)
The size of the generated image.

Default: landscape_4_3

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

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).
system_promptstring
The system prompt to use.

Default: You are an assistant designed to generate superior images with the superior degree of image-text alignment based on textual prompts or user prompts.

seedinteger
The same seed and the same prompt given to the same version of the model 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: 4

num_inference_stepsinteger
The number of inference steps to perform.

Default: 30

cfg_normalizationboolean
Whether to apply normalization-based guidance scale.

Default: true

cfg_trunc_rationumber
The ratio of the timestep interval to apply normalization-based guidance scale.

Default: 1

num_imagesinteger
The number of images to generate.

Default: 1

sync_modeboolean
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

output_formatstring (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

  • 1 megapixel$0.12/ megapixel

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