К основному содержанию
скилл CX Codex

flux-image · acedatacloud — скилл для Claude Code: генерация изображений Flux

Скилл flux-image генерирует и редактирует изображения через API AceDataCloud: текст в картинку, правки по описанию, видео FLUX 3. Работает через OpenClaw Gateway с ключом ACEDATACLOUD_API_TOKEN в .env.

Apache-2.0 238 установок ★ 17 обновлён 2026-11-07

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill flux-image -a claude-code
Открыть на GitHub

Что делает flux-image

Скилл вызывает модели Flux (flux-dev, flux-2-pro, flux-2-max, flux-kontext-pro) для создания картинок из промпта или редактирования загруженных файлов. Для генерации указываешь action: generate, модель и размер — пиксели для flux-dev и flux-2-klein (1024x1024, 768x1344), соотношения сторон для остальных (1:1, 16:9, 3:2). Редактирование (action: edit) требует image_url и одну из kontext-моделей. Все запросы асинхронные: ставь async: true, получаешь ID задачи, опрашиваешь POST /flux/tasks с {"id": "..."} — не запускай вторую генерацию, чтобы проверить статус первой.

Для видео используется POST /flux/videos с mode=t2v (текст в видео), i2v (изображение в видео) или v2v (видео в видео). Длительность 5–20 секунд, разрешение hd/fhd/qhd/uhd. Без ключа API в ~/.openclaw/.env скилл не запустится — бери его в разделе Applications на platform.acedata.cloud, проверь доступ к /flux/images и /flux/tasks, не коммить .env.

Параметр count умножает стоимость на число картинок за запрос. flux-2-klein быстрее всех, но только генерация. flux-2-max даёт максимальное качество, но медленнее: итерируй на dev/klein/flex, финал делай на max.

Какие задачи решает

  • сгенерировать картинку из текстового описания
  • отредактировать фон или детали на загруженном изображении
  • создать видео из промпта или ключевых кадров
  • получить несколько вариантов за один запрос
  • подобрать модель по балансу скорости и качества

Примеры запросов агенту

  • Сделай логотип горы в минималистичном стиле, flux-2-pro, соотношение 1:1
  • Замени фон на этой фотографии на закат на пляже через flux-kontext-pro
  • Сгенерируй видео кота в космическом шлеме, 10 секунд, t2v, разрешение fhd

Как установить flux-image

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/flux-image/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о flux-image

Как установить flux-image в Claude Code?

Выполни npx skills add AceDataCloud/Skills --skill flux-image -a claude-code. Скилл появится в ~/.claude/skills/flux-image/SKILL.md.

Что делает flux-image?

Генерирует изображения из текста и редактирует загруженные картинки через Flux API. Поддерживает модели от flux-dev до flux-2-max и kontext для правок, плюс создание видео FLUX 3.

Какой ключ нужен для работы flux-image?

Токен ACEDATACLOUD_API_TOKEN из раздела Applications на platform.acedata.cloud. Положи его в ~/.openclaw/.env, перезапусти Gateway, не коммить файл .env. Проверь доступ к /flux/images и /flux/tasks в настройках ключа.

Исходный текст

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

Похожие скиллы

Все скиллы по теме «ИИ и ML» →

Сначала — flux-image от других авторов.

flux-image 101-skills Скилл flux-image запускает модели FLUX через CLI belt: он подходит для генерации по тексту, преобразования изображения и работы с пользовательскими стилями LoRA. CX Codex +1 238установок eachlabs-image-generation eachlabs Скилл eachlabs-image-generation для Claude Code генерирует изображения по текстовому описанию через EachLabs Predictions API. Агент отслеживает статус и возвращает ссылку на готовый файл. CX Codex +1 351установок invokeai-image-gen sammcj Скилл invokeai-image-gen для генерации изображений через локальный API InvokeAI с поддержкой FLUX.2 Klein, Z-Image Turbo и SDXL. Автоматически подбирает параметры под модель, сохраняет результат в файл. CX Codex +1 ★ 173звёзд репо black-forest-labs-flux calesthio Скилл black-forest-labs-flux для Claude Code планирует и запускает генерацию и редактирование изображений FLUX.2. Он также помогает с API, моделями и правами. CX Codex +1 137установок videoagent-image-studio wells Скилл videoagent-image-studio даёт доступ к Midjourney, Flux, Ideogram и ещё пяти моделям через один интерфейс, без необходимости хранить API-ключи. Агент сам выбирает подходящую модель и справляется с асинхронностью Midjourney. CX Codex +1 5 600установок flux-2-klein prime-skills Генерация картинок через Flux 2 Klein на RunComfy с готовыми паттернами промптов для быстрых итераций и финального рендера. CX Codex +1 446 700установок flux-best-practices Black Forest Labs Скилл flux-best-practices для Claude Code помогает составлять промпты для моделей FLUX.1 и FLUX.2: описывать сцены, настраивать типографику и указывать точные оттенки. CX Codex +1 1 200установок

Из того же набора67

Весь набор →
luma-video Скилл luma-video создаёт видео через Luma Dream Machine и AceDataCloud API: из текста, референсных изображений или готового ролика. CX Codex +1 251установок seedance-video Скилл seedance-video даёт агенту генерацию видео через API AceDataCloud: текст или картинка на входе, клип на выходе, плюс правка и продление готовых роликов. CX Codex +1 241установок veo-video Скилл veo-video для Claude Code, Codex, Cursor и других платформ, генерирующий видео через API Google Veo. Запускается по промпту, превращает картинки в анимацию, смешивает референсы и апскейлит до 1080p. CX Codex +1 241установок kling-video Скилл kling-video генерирует видео через API Kuaishou Kling в AceDataCloud. Помогает собирать ролики по тексту, оживлять картинки, продлевать клипы и настраивать синхронизацию губ. CX Codex +1 240установок wan-video Скилл wan-video генерирует видео по тексту или анимирует картинки через API AceDataCloud с моделями Wan от Alibaba. CX Codex +1 238установок producer-music Скилл producer-music генерирует музыку через AceDataCloud API: песни, тексты, каверы и инструментальные треки. Работает с продолжением, заменой фрагментов и разделением дорожек. CX Codex +1 236установок hailuo-video Скилл hailuo-video генерирует видео из текста или анимирует картинки через API Hailuo (MiniMax) от AceDataCloud. Работает через три модели: текст-в-видео, картинка-в-видео и режим режиссёра для точного контроля над камерой. CX Codex +1 235установок seedream-image Скилл seedream-image для Claude Code подключает Seedream 5.0 для генерации, редактирования и разложения изображений на слои. Обрабатывает референсы, создаёт изображения с прозрачным фоном и серии картинок. CX Codex +1 235установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой