Flux Image Generation

Setup: See authentication for token setup.

Quick Start

curl -X POST https://api.acedata.cloud/flux/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cat wearing a space helmet, photorealistic", "model": "flux-dev", "callback_url": "https://api.acedata.cloud/health"}'

Async: See async task polling. Poll via

POST /flux/tasks

with

{"id": "..."}

.

Models

flux-dev

flux-pro

flux-2-klein

flux-2-flex

flux-2-pro

flux-2-max

flux-kontext-pro

flux-kontext-max

Generate Images

POST /flux/images
{
  "prompt": "a minimalist logo of a mountain",
  "action": "generate",
  "model": "flux-2-pro",
  "size": "1024x1024",
  "count": 1
}

Size Options

• "1024x1024"

  ,

  "1344x768"

  ,

  "768x1344"

  ,

  "1024x576"

  ,

  "576x1024"

• "1:1"

  ,

  "16:9"

  ,

  "9:16"

  ,

  "4:3"

  ,

  "3:4"

  ,

  "3:2"

  ,

  "2:3"

  ,

  "21:9"

  ,

  "9:21"

Edit Images

POST /flux/images
{
  "prompt": "change the background to a beach sunset",
  "action": "edit",
  "image_url": "https://example.com/photo.jpg",
  "model": "flux-kontext-pro"
}

Gotchas

• Use pixel dimensions (e.g.,

  "1024x1024"

  ) with dev/pro/flux-2 models, aspect ratios (e.g.,

  "16:9"

  ) with kontext models
• Editing requires kontext models (

  flux-kontext-pro

  or

  flux-kontext-max

  ) — other models only support generation

• count

  parameter generates multiple images in one request (increases cost proportionally)

• flux-2-klein

  is the lightest Flux 2 model — useful when latency matters more than peak quality

• flux-2-max

  produces highest quality but is slowest — use dev/klein/flex for iteration and max for final output
• All generation is async — always set

  "callback_url"

  to get a task id immediately, then poll

  /flux/tasks

  using

  {"id":"<task_id>"}

  or

  {"ids":[...],"action":"retrieve_batch"}

MCP:

pip install mcp-flux-pro

| Hosted:

https://flux.mcp.acedata.cloud/mcp

| See all MCP servers