Model API

FLUX.1 Kontext [pro]

The FLUX.1 Kontext [pro] text-to-image delivers state-of-the-art image generation results with unprecedented prompt following, photorealistic rendering, and flawless typography.

Model id

Use this in every request
flux-pro/kontext/text-to-image

This model has other modes with their own ids: flux-pro/kontext, flux-pro/kontext/multi.

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": "flux-pro/kontext/text-to-image",
  "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": "flux-pro/kontext/text-to-image", "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 flux-pro/kontext/text-to-image
NameTypeDescription
promptrequiredstring
The prompt to generate an image from.
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: 3.5

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

num_imagesinteger
The number of images to generate.

Default: 1

output_formatstring (enum)
The format of the generated image.

Default: jpeg

One of: jpeg, png

safety_tolerancestring (enum)
The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.

Default: 2

One of: 1, 2, 3, 4, 5, 6

enhance_promptboolean
Whether to enhance the prompt for better results.

Default: false

aspect_ratiostring (enum)
The aspect ratio of the generated image.

Default: 1:1

One of: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21

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 image$0.07/ image

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