mcpField
F
flux-image

flux-image

github.com/acedatacloud创意与媒体17230 次安装2 天前更新
代码仓库

关于 flux-image

flux-image 是通过 AceDataCloud Flux API 生成和编辑图像的 Skill。它提供多个 Flux 模型系列，Kontext 模型用于文本引导编辑，并可设置图像尺寸和单次生成数量。

主要功能

  1. 01根据文本提示生成图像
  2. 02使用 Kontext 模型进行文本引导编辑
  3. 03多个 Flux 模型系列
  4. 04设置图像尺寸或宽高比
  5. 05单次请求生成多张图像

适用场景

  1. 01根据文字提示生成概念图
  2. 02通过编辑提示更改照片背景
  3. 03按指定尺寸或比例生成图像
  4. 04在一次请求中创建多个图像变体

MCP 相关

README 列出了 `mcp-flux-pro` 包和托管端点 `https://flux.mcp.acedata.cloud/mcp`，也介绍了配套的 MCP 视频生成工具。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/acedatacloud/skills --skill flux-image

安装后在 Claude Code 中输入/flux-image确认已加载。

详细介绍

Flux 图像生成

通过 AceDataCloud 的 Flux API 生成和编辑图像。

首次设置

  1. 使用 clawhub install @acedatacloud/flux 安装官方 Skill。确认 ClawHub 发布者为 @acedatacloud。
  2. 登录 AceDataCloud → Applications，打开 General application，检查 Flux 访问权限、余额和当前定价。复制其 API 密钥，或选择 Manage Keys → Create 创建单独的密钥。复制密钥值，不要带 Bearer ；platform-... 管理令牌不是服务 API 密钥。
  3. 如果启用了 Allowed APIs 限制，请加入 /flux/images 和 /flux/tasks。下文的高级工作流可能会调用其他路由。
  4. 在 OpenClaw Gateway 主机上，将 ACEDATACLOUD_API_TOKEN=your_api_key_here 写入 ~/.openclaw/.env，然后重启 Gateway 并启动新会话。如需直接在终端测试，请在该 shell 中运行 export ACEDATACLOUD_API_TOKEN="your_api_key_here"。切勿将密钥放入提示词或提交 .env 文件。
  5. 运行下方的 快速开始。如果返回任务 ID，请查询同一任务，直到任务完成；不要仅为检查进度而再次提交需要付费的生成请求。

密钥设置、首次运行和故障排除图解 · 令牌详情

快速开始

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", "async": true}'

**异步：**请参阅异步任务轮询。通过 POST /flux/tasks 轮询，并传入 {"id": "..."}。

模型

模型质量速度尺寸适用场景
flux-dev良好快256–1440px快速生成（默认）
flux-pro高中等256–1440px生产工作
flux-2-klein良好最快256–1440px紧凑型／延迟最低的 Flux 2 生成
flux-2-flex高快256–1440px更快地生成高质量图像
flux-2-pro更高中等256–1440px更好地遵循提示词
flux-2-max最高慢256–1440px生成最高质量图像
flux-kontext-pro高中等宽高比图像编辑
flux-kontext-max最高慢宽高比复杂编辑

生成图像

POST /flux/images
{
  "prompt": "a minimalist logo of a mountain",
  "action": "generate",
  "model": "flux-2-pro",
  "size": "1024x1024",
  "count": 1
}
尺寸选项

dev/pro/flux-2 使用（像素尺寸）：

  • "1024x1024"、"1344x768"、"768x1344"、"1024x576"、"576x1024"

kontext 使用（宽高比）：

  • "1:1"、"16:9"、"9:16"、"4:3"、"3:4"、"3:2"、"2:3"、"21:9"、"9:21"

编辑图像

使用 kontext 模型通过文本提示编辑图像：

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

注意事项

  • dev/pro/flux-2 模型使用像素尺寸（例如 "1024x1024"），kontext 模型使用宽高比（例如 "16:9"）
  • 编辑需要使用 kontext 模型（flux-kontext-pro 或 flux-kontext-max）——其他模型仅支持生成
  • count 参数可在单个请求中生成多张图像（费用会按比例增加）
  • flux-2-klein 是最轻量的 Flux 2 模型——适用于延迟比峰值质量更重要的场景
  • flux-2-max 生成的质量最高，但速度最慢——迭代时使用 dev/klein/flex，最终输出时使用 max
  • 所有生成任务均为异步——务必设置 "callback_url" 以立即获取任务 ID，然后使用 {"id":"<task_id>"} 或 {"ids":[...],"action":"retrieve_batch"} 轮询 /flux/tasks

MCP：pip install mcp-flux-pro | 托管服务：https://flux.mcp.acedata.cloud/mcp | 查看所有 MCP 服务

FLUX 3 视频工具

POST /flux/videos 使用 action=generate（默认值）生成视频。使用 mode=t2v/i2v/v2v/draft_enhance。T2V 需要提示词；I2V 还需要关键帧；V2V 还需要 start_video。普通视频请求支持 hd/fhd/qhd/uhd、5–20 秒的整数时长（V2V 最长为 15 秒）或 auto、draft 和 generate_audio 标志。保留显式设置的 false。

草稿增强使用自有平台的 draft_task_id，并要求其临时缓存仍可用。不承诺无限期保留。

配套 MCP 工具：flux_generate_video。CLI 命令：flux video --request-file。MCP/CLI 请求默认异步提交，并通过现有的 /flux/tasks 端点轮询。对于原始 HTTP 请求，设置 async=true 可立即获得任务 ID。生成费用按实际输出时长计费；不要用请求时长替代实测的最终用量。

评论

支持 Markdown