Agent Skills
› NeverSight/learn-skills.dev
› flux-image
flux-image
GitHub通过AceDataCloud API使用Flux模型生成和编辑图像。支持文本生成、基于指令的图像编辑，涵盖dev、pro及kontext等多种模型，适用于快速创作与高质量生产场景。
Trigger Scenarios
根据文本提示词生成图像
对现有图像进行文字指令编辑
需要高保真度图像生成
Install
npx skills add NeverSight/learn-skills.dev --skill flux-image -g -y
SKILL.md
Frontmatter
{
"name": "flux-image",
"license": "Apache-2.0",
"metadata": {
"author": "acedatacloud",
"version": "1.0"
},
"description": "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.",
"compatibility": "Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared\/authentication.md). Optionally pair with mcp-flux-pro for tool-use."
}
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/taskswith{"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-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-proorflux-kontext-max) — other models only support generation countparameter generates multiple images in one request (increases cost proportionally)flux-2-maxproduces highest quality but is slowest — use dev/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/tasksusing{"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
Version History
- e0220ca Current 2026-07-05 22:53
