{"id":"b540ea85-b5cf-4bd7-af39-2d6b02e06a08","shortId":"ntqnLm","kind":"skill","title":"flux-image","tagline":"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, ultra, and k","description":"# Flux Image Generation\n\nGenerate and edit images through AceDataCloud's Flux API.\n\n> **Setup:** See [authentication](../_shared/authentication.md) for token setup.\n\n## Quick Start\n\n```bash\ncurl -X POST https://api.acedata.cloud/flux/images \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"prompt\": \"a cat wearing a space helmet, photorealistic\", \"model\": \"flux-dev\", \"callback_url\": \"https://api.acedata.cloud/health\"}'\n```\n\n> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /flux/tasks` with `{\"task_id\": \"...\"}`.\n\n## Models\n\n| Model | Quality | Speed | Sizes | Best For |\n|-------|---------|-------|-------|----------|\n| `flux-dev` | Good | Fast | 256–1440px | Quick generation (default) |\n| `flux-pro` | High | Medium | 256–1440px | Production work |\n| `flux-pro-1.1` | Higher | Medium | 256–1440px | Better prompt following |\n| `flux-pro-1.1-ultra` | Highest | Slow | Aspect ratios | Maximum quality |\n| `flux-kontext-pro` | High | Medium | Aspect ratios | Image editing |\n| `flux-kontext-max` | Highest | Slow | Aspect ratios | Complex editing |\n\n## Generate Images\n\n```json\nPOST /flux/images\n{\n  \"prompt\": \"a minimalist logo of a mountain\",\n  \"action\": \"generate\",\n  \"model\": \"flux-pro-1.1\",\n  \"size\": \"1024x1024\",\n  \"count\": 1\n}\n```\n\n### Size Options\n\n**For dev/pro/pro-1.1** (pixel dimensions):\n- `\"1024x1024\"`, `\"1344x768\"`, `\"768x1344\"`, `\"1024x576\"`, `\"576x1024\"`\n\n**For ultra/kontext** (aspect ratios):\n- `\"1:1\"`, `\"16:9\"`, `\"9:16\"`, `\"4:3\"`, `\"3:4\"`, `\"3:2\"`, `\"2:3\"`, `\"21:9\"`, `\"9:21\"`\n\n## Edit Images\n\nUse kontext models for text-guided image editing:\n\n```json\nPOST /flux/images\n{\n  \"prompt\": \"change the background to a beach sunset\",\n  \"action\": \"edit\",\n  \"image_url\": \"https://example.com/photo.jpg\",\n  \"model\": \"flux-kontext-pro\"\n}\n```\n\n## Gotchas\n\n- Use pixel dimensions (e.g., `\"1024x1024\"`) with dev/pro models, aspect ratios (e.g., `\"16:9\"`) with ultra/kontext models\n- Editing requires kontext models (`flux-kontext-pro` or `flux-kontext-max`) — other models only support generation\n- `count` parameter generates multiple images in one request (increases cost proportionally)\n- Ultra model produces highest quality but is slowest — use dev for iteration, ultra for final output\n- All generation is async — always set `\"callback_url\"` to get a `task_id` immediately, then poll `/flux/tasks`\n\n> **MCP:** `pip install mcp-flux-pro` | Hosted: `https://flux.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)","tags":["flux","image","skills","acedatacloud","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code"],"capabilities":["skill","source-acedatacloud","skill-flux-image","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/flux-image","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (2,539 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:01.907Z","embedding":null,"createdAt":"2026-05-18T13:21:32.207Z","updatedAt":"2026-05-18T19:14:01.907Z","lastSeenAt":"2026-05-18T19:14:01.907Z","tsv":"'/_shared/async-tasks.md':110 '/_shared/authentication.md':63 '/_shared/mcp-servers.md':370 '/flux/images':75,190,255 '/flux/tasks':114,354 '/health':104 '/mcp':365 '/photo.jpg':270 '1':208,224,225 '1.1':147,158,204 '1024x1024':206,215,281 '1024x576':218 '1344x768':216 '1440px':131,141,151 '16':226,229,288 '2':235,236 '21':238,241 '256':130,140,150 '3':231,232,234,237 '4':230,233 '576x1024':219 '768x1344':217 '9':227,228,239,240,289 'acedatacloud':14,56,79 'action':198,264 'alway':342 'api':15,59,80 'api.acedata.cloud':74,103 'api.acedata.cloud/flux/images':73 'api.acedata.cloud/health':102 'application/json':86 'aspect':162,172,182,222,285 'async':105,107,341 'authent':62 'author':77 'background':259 'bash':69 'beach':262 'bearer':78 'best':123 'better':152 'black':10 'callback':100,344 'cat':90 'chang':257 'complex':184 'content':84 'content-typ':83 'cost':320 'count':207,311 'creat':18 'curl':70 'd':87 'default':134 'dev':43,99,127,331 'dev/pro':283 'dev/pro/pro-1.1':212 'dimens':214,279 'e.g':280,287 'edit':6,23,53,175,185,242,252,265,293 'example.com':269 'example.com/photo.jpg':268 'exist':24 'fast':129 'final':336 'flux':2,9,40,48,58,98,126,136,145,156,167,177,202,273,298,303,360 'flux-dev':97,125 'flux-imag':1 'flux-kontext-max':176,302 'flux-kontext-pro':166,272,297 'flux-pro':135,144,155,201 'flux.mcp.acedata.cloud':364 'flux.mcp.acedata.cloud/mcp':363 'follow':154 'forest':11 'generat':4,35,50,51,133,186,199,310,313,339 'get':347 'good':128 'gotcha':276 'guid':250 'h':76,82 'helmet':94 'high':32,138,170 'high-qual':31 'higher':148 'highest':160,180,325 'host':362 'id':117,350 'imag':3,7,19,25,34,49,54,174,187,243,251,266,315 'immedi':351 'includ':42 'increas':319 'instal':357 'instruct':28 'iter':333 'json':188,253 'k':47 'kontext':168,178,245,274,295,299,304 'lab':12 'logo':194 'max':179,305 'maximum':164 'mcp':355,359,368 'mcp-flux-pro':358 'medium':139,149,171 'minimalist':193 'model':41,96,118,119,200,246,271,284,292,296,307,323 'mountain':197 'multipl':39,314 'need':37 'one':317 'option':210 'output':337 'paramet':312 'photorealist':95 'pip':356 'pixel':213,278 'poll':109,111,353 'post':72,113,189,254 'pro':44,137,146,157,169,203,275,300,361 'produc':324 'product':142 'prompt':22,88,153,191,256 'proport':321 'qualiti':33,120,165,326 'quick':67,132 'ratio':163,173,183,223,286 'request':318 'requir':294 'see':61,106,366 'server':369 'set':343 'setup':60,66 'size':122,205,209 'skill' 'skill-flux-image' 'slow':161,181 'slowest':329 'source-acedatacloud' 'space':93 'speed':121 'start':68 'sunset':263 'support':38,309 'task':108,116,349 'text':21,27,249 'text-guid':248 'token':65,81 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'type':85 'ultra':45,159,322,334 'ultra/kontext':221,291 'url':101,267,345 'use':16,244,277,330 'via':13,112 'wear':91 'work':143 'x':71","prices":[{"id":"a1f0739b-67f0-43d2-8fa0-86d4b38ac90b","listingId":"b540ea85-b5cf-4bd7-af39-2d6b02e06a08","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:32.207Z"}],"sources":[{"listingId":"b540ea85-b5cf-4bd7-af39-2d6b02e06a08","source":"github","sourceId":"AceDataCloud/Skills/flux-image","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/flux-image","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:32.207Z","lastSeenAt":"2026-05-18T19:14:01.907Z"}],"details":{"listingId":"b540ea85-b5cf-4bd7-af39-2d6b02e06a08","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"flux-image","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"f7b3b4acd2d7fffa35a0969a5ae2eb6777847179","skill_md_path":"skills/flux-image/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/flux-image"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"flux-image","license":"Apache-2.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, ultra, 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."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/flux-image"},"updatedAt":"2026-05-18T19:14:01.907Z"}}