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 {"task_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-pro-1.1	Higher	Medium	256–1440px	Better prompt following
flux-pro-1.1-ultra	Highest	Slow	Aspect ratios	Maximum quality
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-pro-1.1",
  "size": "1024x1024",
  "count": 1
}

Size Options

For dev/pro/pro-1.1 (pixel dimensions):

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

For ultra/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 models, aspect ratios (e.g., "16:9") with ultra/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)
• Ultra model produces highest quality but is slowest — use dev for iteration, ultra for final output
• All generation is async — always set "callback_url" to get a task_id immediately, then poll /flux/tasks

MCP: pip install mcp-flux-pro | Hosted: https://flux.mcp.acedata.cloud/mcp | See all MCP servers