Generates and edits images with Black Forest Labs' Flux models via AceDataCloud API. Supports multiple model variants (dev, pro, Flux 2, kontext) for different quality/speed tradeoffs and image editing.
How this skill is triggered — by the user, by Claude, or both
Slash command
/acedatacloud-ai-media:flux-imageThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Generate and edit images through AceDataCloud's Flux API.
Generate and edit images through AceDataCloud's Flux API.
Setup: See authentication for token setup.
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/taskswith{"id": "..."}.
| 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 |
POST /flux/images
{
"prompt": "a minimalist logo of a mountain",
"action": "generate",
"model": "flux-2-pro",
"size": "1024x1024",
"count": 1
}
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"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"
}
"1024x1024") with dev/pro/flux-2 models, aspect ratios (e.g., "16:9") with kontext modelsflux-kontext-pro or flux-kontext-max) — other models only support generationcount 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"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
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub acedatacloud/skills --plugin acedatacloud-ai-tools