SEEDANCE 2.5 IS NOW LIVE!

GENERATE YOUR VIDEOS WITH UNLIMITED SEEDANCE 2.5 TODAY.

NO EXTRA SUBSCRIPTION
REVIRAL
Get API key
Browse API docs

Models · Image

Flux Kontext Max API

Was this page helpful?

Flux Kontext Max is good for generating still images when you need its listed output sizes and aspect ratios.

Pricing

Default example: 1 image at Standard costs 8 credits, or $0.16 at the shared USD reference.

ResolutionUnitCreditsUSD
StandardPer image8 cr$0.16

Accepted inputs

Kind
image
Durations
Not applicable
Resolutions
Standard
Aspect ratios
1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 9:21
Defaults
Standard · 1:1 · count 1

Sample request

The request uses the current default settings for this model and the public GenerateMediaRequest schema.

curl -X POST "https://reviral.ai/api/v1/generate-media" \
  -H "Authorization: Bearer $REVIRAL_API_KEY" \
  -H "Idempotency-Key: first-video" \
  -H "Content-Type: application/json" \
  --data '{"model":"flux-kontext-max","prompt":"A clean product photograph on a warm neutral background","size":"Standard","aspectRatio":"1:1","count":1,"maxCredits":8}'

Response and output

Accepted job
{
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "kind": "image",
    "model": "flux-kontext-max",
    "creditsCharged": 8,
    "status": "queued",
    "statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000"
  }
}
Ready job
{
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "kind": "image",
    "model": "flux-kontext-max",
    "creditsCharged": 8,
    "status": "ready",
    "statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000",
    "outputUrls": [
      "https://reviral.ai/signed-output"
    ]
  }
}

Error cases

  • 404 model_not_available: the ID is no longer in the live catalog.
  • 409 price_changed: the current cost differs from maxCredits.
  • 422 validation_error: duration, resolution, aspect ratio, size, or count is not accepted.
  • 429 rate_limit_exceeded: wait for Retry-After before retrying.

Frequently asked questions

How much does the Flux Kontext Max API cost?
The default 1 image at Standard costs 8 credits, about $0.16 at the shared USD reference. Read the live models endpoint before submitting.
Which inputs does Flux Kontext Max accept?
It accepts a prompt, listed size and aspect ratio, and an image count from 1 to 4 subject to the model limit. Reference inputs are not available through this v1 endpoint.
How do I retrieve Flux Kontext Max output?
Poll the returned status URL until the job is ready, then download the signed output URL or URLs before they expire.