POST/api/v1/imagine8 creditsSynchronousRequires image_url

Flux Kontext Max

Provider · Black Forest LabsType · EditModel ID · flux-kontext-maxUpstream ID · flux-kontext-max

Flux Kontext Max by Black Forest Labs (via BLTCY). The highest quality context-aware editing model. Handles complex, multi-element scene modifications that Pro struggles with. Most expensive model on the platform. Requires `image_url`.

Request Parameters

Parameter	Type	Required	Description
prompt	`string`	Required	The text prompt describing the image to generate.
model	`string`	Optional	Set to `flux-kontext-max` to use this model.Default: `flux-kontext-max`
image_url	`string`	Required	Source image URL. Required for this edit model — the request will fail without it.
aspect_ratio	`string`	Optional	Output aspect ratio. Allowed: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3.Default: `1:1`
webhook_url	`string`	Optional	URL where we POST the completed task result.
webhook_secret	`string`	Optional	Sent as x-webhook-secret header in webhook delivery for verification.

Example Request

cURL

curl -X POST https://api.journeyapi.com/api/v1/imagine \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-max",
    "prompt": "change the car color to matte black and add rain reflections on the road",
    "image_url": "https://example.com/car-photo.jpg"
  }'

Response

This model is synchronous — the response includes the finished image_url directly. No polling required.

200 OK

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "finished",
  "image_url": "https://cdn.example.com/output.png"
}

Tips

1Use Max over Pro when the edit involves multiple overlapping elements or the Pro output is inconsistent.

Quirks & Gotchas

English-only prompts. Non-English text may produce unexpected results.

Output images expire after 14 days — download and store results promptly.

At 8 credits, reserve for complex edits that justify the cost.