Claude GitHub Copilot Skill

flux-image

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 te

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download AceDataCloud-Skills-skills_flux-image-57df236.zip · 2 KB

Install

skills CLI npx skills add https://github.com/AceDataCloud/Skills/tree/main/skills/flux-image
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install acedatacloud-skills@llmmart
Git git clone https://github.com/AceDataCloud/Skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole acedatacloud/skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

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, 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 · Token details

Quick Start

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. 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

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:

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

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.

Files (skills)
  • SKILL.md 5.8 KB
    ---
    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.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.