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" \

Async: See async task polling. Poll via POST /flux/tasks with {"id": "..."}.

Models

Generate Images

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:

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

FLUX 3 video tools

POST /flux/videos generates videos with action=generate (default). Use mode=t2v/i2v/v2v/draft_enhance. T2V needs prompt; I2V also needs keyframes; V2V also needs start_video. Normal video requests support hd/fhd/qhd/uhd, integer duration 5–20 seconds (V2V up to 15) or auto, draft and generate_audio flags. Preserve explicit false.

Draft enhancement uses an owned platform draft_task_id and requires its temporary cache to remain available. It does not promise indefinite retention.

Companion MCP tool: flux_generate_video. CLI command: flux video --request-file. MCP/CLI requests submit asynchronously by default and are polled through the existing /flux/tasks endpoint. For raw HTTP requests, set async=true to receive a task ID immediately. Generation charges use actual output seconds; do not substitute requested duration for measured final usage.