flux-image

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Flux Image Generation

Flux 图片生成

Generate and edit images through AceDataCloud's Flux API.

Setup: See authentication for token setup.

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

设置： 请查看身份验证了解令牌设置方法。

Quick Start

快速开始

bash

curl -X POST https://api.acedata.cloud/flux/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cat wearing a space helmet, photorealistic", "model": "flux-dev", "callback_url": "https://api.acedata.cloud/health"}'

Async: See async task polling. Poll via
POST /flux/tasks
with
{"id": "..."}
.

bash

curl -X POST https://api.acedata.cloud/flux/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cat wearing a space helmet, photorealistic", "model": "flux-dev", "callback_url": "https://api.acedata.cloud/health"}'

异步处理： 请查看异步任务轮询。通过
POST /flux/tasks
接口并传入
{"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	256–1440px	Faster high-quality generation
`flux-2-pro`	Higher	Medium	256–1440px	Better prompt following
`flux-2-max`	Highest	Slow	256–1440px	Maximum quality generation
`flux-kontext-pro`	High	Medium	Aspect ratios	Image editing
`flux-kontext-max`	Highest	Slow	Aspect ratios	Complex editing

模型	画质	速度	尺寸	适用场景
`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`	最高	缓慢	宽高比	复杂编辑

Generate Images

生成图片

json

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

json

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

Size Options

尺寸选项

For dev/pro/flux-2 (pixel dimensions):

"1024x1024"

"1344x768"

"768x1344"

"1024x576"

"576x1024"

For kontext (aspect ratios):

"1:1"

"16:9"

"9:16"

"4:3"

"3:4"

"3:2"

"2:3"

"21:9"

"9:21"

适用于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"

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"
}

使用kontext模型进行文本引导的图片编辑：

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"
}

Gotchas

注意事项

Use pixel dimensions (e.g.,
```
"1024x1024"
```
) with dev/pro/flux-2 models, aspect ratios (e.g.,
```
"16:9"
```
) with kontext models
Editing requires kontext models (
```
flux-kontext-pro
```
or
```
flux-kontext-max
```
) — other models only support generation
```
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

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服务器