Skip to main content
skill CX Codex

flux-image · acedatacloud — Claude Code skill: Flux image generation and editing

flux-image is a Claude Code skill for generating and editing images through the AceDataCloud Flux API, including text-to-image, instruction-based edits, and FLUX 3 video.

Apache-2.0 238 installs ★ 17 updated 2026-11-07

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AceDataCloud/Skills --skill flux-image -a claude-code
Open on GitHub

What flux-image does

The skill calls Flux models (flux-dev, flux-2-pro, flux-2-max, flux-kontext-pro) to create images from prompts or edit uploaded files. For generation, set action: generate, pick a model and size — pixel dimensions for flux-dev and flux-2-klein (1024x1024, 768x1344), aspect ratios for the rest (1:1, 16:9, 3:2). Editing (action: edit) needs image_url and a kontext model. All requests are async: set async: true, get a task ID, poll POST /flux/tasks with {"id": "..."} — do not start a second billable generation just to check the first.

For video, use POST /flux/videos with mode=t2v (text to video), i2v (image to video) or v2v (video to video). Duration 5–20 seconds, resolution hd/fhd/qhd/uhd. Without an API key in ~/.openclaw/.env, the skill will not start — grab it from the Applications section on platform.acedata.cloud, confirm access to /flux/images and /flux/tasks, never commit .env.

The count parameter multiplies cost by the number of images per request. flux-2-klein is fastest but generation-only. flux-2-max delivers top quality but is slower: iterate on dev/klein/flex, run final output on max.

What it helps with

  • generate an image from a text description
  • edit background or details in an uploaded photo
  • create a video from a prompt or keyframes
  • get multiple variations in one request
  • pick a model by speed-quality tradeoff

Example prompts for the agent

  • Generate a minimalist mountain logo with flux-2-pro, aspect ratio 1:1
  • Replace the background in this photo with a beach sunset using flux-kontext-pro
  • Generate a 10-second video of a cat in a space helmet, t2v mode, fhd resolution

How to install flux-image

1Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill flux-image -a claude-code

2Manually: put the files in place

~/.claude/skills/flux-image/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/flux-image/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about flux-image

How to install flux-image in Claude Code?

Run npx skills add AceDataCloud/Skills --skill flux-image -a claude-code. The skill will appear in ~/.claude/skills/flux-image/SKILL.md.

What does flux-image do?

Generates images from text and edits uploaded pictures via Flux API. Supports models from flux-dev to flux-2-max and kontext for editing, plus FLUX 3 video creation.

Which key does flux-image need?

An ACEDATACLOUD_API_TOKEN from the Applications section on platform.acedata.cloud. Put it in ~/.openclaw/.env, restart Gateway, never commit the .env file. Confirm access to /flux/images and /flux/tasks in the key settings.

Source text

SKILL.md · Apache-2.0
---
name: flux-image
description: Generate and edit Flux images or generate FLUX 3 videos 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 image models plus text/image/video generation and temporary owned video drafts.
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (get an API key at https://platform.acedata.cloud/console/applications). Optionally pair with mcp-flux-pro for tool-use.
---

# Flux Image Generation

Generate and edit images through AceDataCloud's Flux API.

## First-time setup

1. Install the official Skill with `clawhub install @acedatacloud/flux`. Check that the ClawHub publisher is **@acedatacloud**.
2. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications), open **General application**, and check Flux access, balance, and current pricing. Copy its API key, or select **Manage Keys → Create** for a separate key. Copy the key value without `Bearer `; a `platform-...` management token is not a service API key.
3. If you enable **Allowed APIs** restrictions, include `/flux/images` and `/flux/tasks`. Advanced workflows below may call additional routes.
4. On the OpenClaw Gateway host, put `ACEDATACLOUD_API_TOKEN=your_api_key_here` in `~/.openclaw/.env`, then restart the Gateway and start a new session. For a direct terminal test, run `export ACEDATACLOUD_API_TOKEN="your_api_key_here"` in that shell. Never put the key in a prompt or commit an `.env` file.
5. Run the **Quick Start** below. If it returns a task ID, query that same task until it finishes; do not submit a second billable generation just to check progress.

[Illustrated key setup, first run, and troubleshooting](https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw) · [Token details](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/authentication.md)

## Quick Start

```bash
curl -X POST https://api.acedata.cloud/flux/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "a cat wearing a space helmet, photorealistic", "model": "flux-dev", "size": "1024x1024", "async": true}'
```

> **Async:** See [async task polling](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/async-tasks.md). 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 | Aspect ratios | Faster high-quality generation |
| `flux-2-pro` | Higher | Medium | Aspect ratios | Better prompt following |
| `flux-2-max` | Highest | Slow | Aspect ratios | Maximum quality generation |
| `flux-kontext-pro` | High | Medium | Aspect ratios | Image editing |
| `flux-kontext-max` | Highest | Slow | Aspect ratios | Complex editing |

## Generate Images

```json
POST /flux/images
{
  "prompt": "a minimalist logo of a mountain",
  "action": "generate",
  "model": "flux-2-pro",
  "size": "1:1",
  "count": 1
}
```

### Size Options

**For `flux-dev`, `flux-pro`, and `flux-2-klein`** (pixel dimensions):
- `"1024x1024"`, `"1344x768"`, `"768x1344"`, `"1024x576"`, `"576x1024"`

**For `flux-2-flex`, `flux-2-pro`, `flux-2-max`, and Kontext models** (aspect ratios, not pixel dimensions):
- `"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:

```json
POST /flux/images
{
  "prompt": "change the background to a beach sunset",
  "action": "edit",
  "image_url": "https://example.com/photo.jpg",
  "model": "flux-kontext-pro",
  "size": "1:1"
}
```

## Gotchas

- Send `size` explicitly: pixel dimensions for `flux-dev`, `flux-pro`, and `flux-2-klein`; aspect ratios for `flux-2-flex`, `flux-2-pro`, `flux-2-max`, and Kontext
- For MCP `flux_edit_image`, select a model from its live schema; `flux-2-klein` supports generation only and is not an edit-model choice
- `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](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/mcp-servers.md)

## FLUX 3 video tools

`POST /flux/videos` generates videos with `action=generate` (default). Use `mode=t2v/i2v/v2v/draft_enhance`. T2V needs prompt; I2V also needs keyframes; V2V also needs start_video. Normal video requests support hd/fhd/qhd/uhd, integer duration 5–20 seconds (V2V up to 15) or auto, draft and generate_audio flags. Preserve explicit false.

Draft enhancement uses an owned platform draft_task_id and requires its temporary cache to remain available. It does not promise indefinite retention.

Companion MCP tool: flux_generate_video. CLI command: flux video --request-file. MCP/CLI requests submit asynchronously by default and are polled through the existing /flux/tasks endpoint. For raw HTTP requests, set async=true to receive a task ID immediately. Generation charges use actual output seconds; do not substitute requested duration for measured final usage.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Similar skills

All skills for AI and ML →

flux-image by other authors comes first.

flux-image 101-skills flux-image is a Claude Code skill that runs FLUX models through the belt CLI for text-to-image generation, image transformation, and custom LoRA styles. CX Codex +1 238installs eachlabs-image-generation eachlabs eachlabs-image-generation is a Claude Code skill that creates images from text prompts via the EachLabs Predictions API. It polls for completion and returns the output image URL. CX Codex +1 351installs invokeai-image-gen sammcj invokeai-image-gen — a skill for generating images via local InvokeAI API, supporting FLUX.2 Klein, Z-Image Turbo, and SDXL. Auto-detects models and applies appropriate parameters, saves output as PNG. CX Codex +1 ★ 173repo stars black-forest-labs-flux calesthio black-forest-labs-flux is a Claude Code skill for planning and running FLUX image generation and editing. It covers model choice, API work, and rights checks. CX Codex +1 137installs videoagent-image-studio wells The videoagent-image-studio skill provides one-command access to Midjourney, Flux, Ideogram, and five other image models without storing API keys. The agent picks the best model and handles Midjourney's async workflow automatically. CX Codex +1 5,600installs flux-2-klein prime-skills Generates images using Black Forest Labs' Flux 2 Klein via RunComfy with tailored prompting patterns for fast iteration and polish. CX Codex +1 446,700installs flux-best-practices Black Forest Labs flux-best-practices is a Claude Code skill for prompting FLUX.1 and FLUX.2 image models. It helps structure scene descriptions, handle typography, and specify colors. CX Codex +1 1,200installs

From the same set67

The whole set →
luma-video luma-video is a Claude Code skill that generates videos through Luma Dream Machine and the AceDataCloud API from text, reference images, or existing videos. CX Codex +1 251installs seedance-video seedance-video generates video from text or images through AceDataCloud's Seedance API, and lets the agent poll the task, edit or extend a clip. CX Codex +1 241installs veo-video veo-video — a skill for Claude Code, Codex, Cursor and other platforms that generates videos via Google Veo API. Triggered by a prompt, animates still images, blends references, and upscales to 1080p. CX Codex +1 241installs kling-video kling-video generates AI video via the AceDataCloud Kuaishou Kling API. Use it to render text prompts, animate still frames, extend existing clips, and run lip sync. CX Codex +1 240installs wan-video wan-video generates AI videos from text prompts and animates images using Alibaba Wan models through the AceDataCloud API. CX Codex +1 238installs producer-music producer-music creates AI music through the AceDataCloud Producer API, including songs, lyrics, covers, and instrumentals. It also edits existing tracks and separates stems. CX Codex +1 236installs hailuo-video hailuo-video generates video from text or animates images via AceDataCloud's Hailuo (MiniMax) API. Supports text-to-video, image-to-video, and director mode for precise camera and motion control. CX Codex +1 235installs seedream-image The seedream-image skill connects Seedream 5.0 for image generation, editing, streaming, and layer extraction. Use it for reference images, transparent backgrounds, or related image sets. CX Codex +1 235installs

Project sponsors

Companies that keep this analytics open