Flux image

Skill AceDataCloud/Skills/skills/flux-image

Generate and edit images with Flux (Black Forest Labs) via AceDataCloud API. Use when creating images from text prompts, editing existing images with text instructions, or when high-quality image generation is needed. Supports multiple Flux models including dev, pro, Flux 2 variants, and kontext for editing.From its SKILL.md

Install

npx -y skills add AceDataCloud/Skills --skill flux-image

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
13 stars13 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.4 KB, 867 tokens by cl100k_base, as published. Nobody here has run it

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-klein`	Good	Fastest	256–1440px	Compact / lowest-latency Flux 2 generation
`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-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

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.