flux-image

Flux Image Generation

Generate and edit images through AceDataCloud's Flux API.

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

Model	Quality	Speed	Sizes	Best For
flux-dev	Good	Fast	256–1440px	Quick generation (default)
flux-pro	High	Medium	256–1440px	Production work
flux-2-flex	High	Fast	256–1440px	Faster high-quality generation
flux-2-pro	Higher	Medium	256–1440px	Better prompt following
flux-2-max	Highest	Slow	256–1440px	Maximum quality generation
flux-kontext-pro	High	Medium	Aspect ratios	Image editing
flux-kontext-max	Highest	Slow	Aspect ratios	Complex editing

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-max produces highest quality but is slowest — use dev/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