Flux Image Generation

Generate and edit images through AceDataCloud's Flux API.

Setup: See [authentication](../_shared/authentication.md) 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 '{"action": "generate", "prompt": "a cat wearing a space helmet, photorealistic", "model": "flux-dev", "callback_url": "https://api.acedata.cloud/health"}'

Async: See [async task polling](../_shared/async-tasks.md). Poll via POST /flux/tasks with {"id": "..."}.

Models

Generate Images

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

Size Options

For dev/pro/flux-2 (pixel dimensions):

• "1024x1024", "1344x768", "768x1344", "1024x576", "576x1024"

For kontext (aspect ratios):

• "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9", "9:21"

Edit Images

Use kontext models for text-guided image editing:

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 "callbackurl" to get a task id immediately, then poll /flux/tasks using {"id":"<taskid>"} or {"ids":[...],"action":"retrieve_batch"}

MCP: pip install mcp-flux-pro | Hosted: https://flux.mcp.acedata.cloud/mcp | See [all MCP servers](../_shared/mcp-servers.md)