Skip to main content
FLUX.1 Kontext [pro] is a context-aware image generation model from Black Forest Labs, available through Starrise AI. It can generate images from text descriptions or edit existing images using text instructions. Both endpoints use synchronous calls — they directly return Base64-encoded image data.
  • Text-to-image — POST JSON to /v1/images/generations
  • Image editing — POST multipart form to /v1/images/edits

​
Key Capabilities

  • Image editing — Modify existing images using text instructions (e.g., “Change the red car to blue”)
  • Text-to-image — Generate images from text descriptions
  • Context-aware — Understands and preserves the context of reference images
  • Reproducible — Use seed for deterministic generation

​
Quick Example

​
Text-to-image

curl https://ai.alad.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-1-kontext-pro",
    "prompt": "A cute baby polar bear",
    "size": "1024x1024"
  }'

​
Image Editing

curl https://ai.alad.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=flux-1-kontext-pro" \
  -F "image=@/path/to/photo.jpg" \
  -F "prompt=Change the background to a sunset beach" \
  -F "size=1024x1024"

​
Text-to-image Parameters

ParameterTypeRequiredDescription
modelstringYesFixed value: flux-1-kontext-pro
promptstringYesImage description. ⚠️ Prompt must be in English
nintegerNoNumber of images to generate. Only 1 is supported
sizestringNoOutput resolution, e.g. 1024x1024
output_formatstringNojpeg or png
seedintegerNoRandom seed for reproducibility

​
Image Editing Parameters

ParameterTypeRequiredDescription
modelstringYesFixed value: flux-1-kontext-pro
imagefileYesImage file to edit (multipart upload)
promptstringYesEditing instruction. ⚠️ Prompt must be in English
nintegerNoNumber of images to generate. Only 1 is supported
sizestringNoOutput resolution, e.g. 1024x1024

​
Response Fields

FieldDescription
data[].b64_jsonBase64-encoded image data
createdCreation timestamp

API Reference

View the interactive API Playground for FLUX.1 Kontext [pro].