black-forest-labs flux-kontext-max
text-to-imageimage-to-image
Endpoint
POST /v1/black-forest-labs/flux-kontext-max/predictions
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Required | Text description for image generation |
| input_image | string | Optional | Optional input image for context |
| aspect_ratio | enum 1:116:99:16 | Optional | Image aspect ratio Default: match_input_image |
JSON
{
"input": {
"prompt": "People inside the hot air balloon"
},
"image_count": 1
}
// Available parameters:
// - prompt (required): Text description for image generation
// - input_image (optional): Optional input image for context
// - aspect_ratio (optional): "1:1", "16:9", "9:16" (default: "match_input_image")JSON
{
"id": 789,
"user_id": "abc123",
"model": "black-forest-labs",
"model_version": "flux-kontext-max",
"input_parameters": {},
"output_data": {
"urls": [
"https://cdn.deepcreativelabs.com/...image.png"
]
},
"status": "processing",
"credits_used": "2.5",
"created_at": "2026-01-07T11:28:02.069Z",
"updated_at": "2026-01-07T11:28:02.069Z"
}
// Pricing:
// Fixed price: $0.12/image - 8 images for $1bash
curl -X POST https://api.deepcreativelabs.com/v1/black-forest-labs/flux-kontext-max/predictions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "accept: application/json" \
-d '{
"input": {
"prompt": "People inside the hot air balloon"
},
"image_count": 1
}'