Flux Image Generation

Generate and edit images through AceDataCloud's Flux API.

Authentication

export ACEDATACLOUD_API_TOKEN="your-token-here"

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", "wait": true}'

Models

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

Task Polling

POST /flux/tasks
{"task_id": "your-task-id"}

MCP Server

pip install mcp-flux

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

Key tools: flux_generate_image, flux_edit_image

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 — use "wait": true or poll /flux/tasks