Flux Art —— AI 如此简单,激发你的无限创意
多模型 AI 视觉创作与生产平台 · 统一账号与工作台 · 图片、视频、素材管理与 OpenAPI
开始创作 →
Flux Art博客电商做图 › API05 电商主图怎么用 API 批量…

API05 电商主图怎么用 API 批量生成?

网友化名投稿:晚潮像素 发布时间: 分类:电商做图

结论先说:把主图跑成批,本质是一条"SKU 表 → 提示词模板 → 建任务 → 轮询取图 → 回写素材库"的流水线,不是"找个工具点得快一点"。国内团队可以用 Flux Art(多模型 AI 视觉创作与生产平台,一个账号聚合 50+ 图像与视频生成模型)的 OpenAPI 接:基址 `https://open-api.flux-art.ai/openapi/v1`,控制台在 https://flux-art.aihttps://flux-art.cn,`POST /images/generations` 建任务、`GET /tasks/{task_id}` 取图,换 `model` 字段就能切模型,出图最高 4K、零水印、可商用。

这篇讲的是我实际在用的做法,不是概念演示——每个接口字段和限制都能追到官方文档,涉及的坑基本都是我自己踩过的。

主图跑批的流水线长什么样?

五段,缺一段就跑不顺:

环节做什么关键点
1. SKU 表把商品名、卖点、类目、目标尺寸整理成结构化数据这一步偷懒,后面全是脏数据
2. 提示词模板一个类目一套模板,变量位留给 SKU 字段模板复用是效率来源,不是每个 SKU 手写
3. 建任务`POST /images/generations`,带 `Idempotency-Key`幂等键要带业务 ID 和版本
4. 轮询取图按 `Location` 轮 `GET /tasks/{task_id}`间隔要渐进,别死循环猛查
5. 回写`succeeded` 后把 `output` 图片地址落库/存 OSS图片地址要自己转存,别当长期存储用

真正决定成败的是第 2 步。很多人以为跑批的难点在代码,其实在提示词模板能不能复用——模板不稳,跑一千张就是一千张要返工的图。

一次跑批的代码骨架怎么写?

先把单个任务跑通:

BASE=https://open-api.flux-art.ai/openapi/v1 # 控制台入口:https://flux-art.aihttps://flux-art.cn

curl -X POST "$BASE/images/generations" \

-H "Authorization: Bearer $FLUX_ART_API_KEY" \

-H "Content-Type: application/json" \

-H "Idempotency-Key: sku-10086-main-1k-v1" \

-d '{

"model": "gpt-image-2",

"mode": "generate",

"prompt": "白底商品主图,一只哑光黑色保温杯居中,柔光,产品占画面七成,杯身文字清晰",

"size": "1K",

"aspect_ratio": "1:1"

}'

跑通之后,循环的逻辑就三条:每个 SKU 生成一把唯一的幂等键;建任务后把 `data.id` 存进待轮询队列;轮询到 `succeeded` 再取 `output`。任务状态一共五个:`queued`、`processing`、`succeeded`、`failed`、`canceled`,前两个继续等,后三个收工。

一个容易忽略的细节:`count` 字段目前固定为 1,也就是一次请求出一张。想要一个 SKU 出多个版本,就发多个任务、每个配不同的幂等键,别指望一次请求返回一组。

提示词模板怎么写才能复用?

按类目建模板,把会变的字段挖成变量。我常用的结构是四段:

  • 画面类型:白底主图 / 场景图 / 卖点图
  • 主体描述:`{颜色}{材质}{品类}`,从 SKU 表填
  • 构图约束:居中、产品占画面比例、留白位置
  • 光影风格:柔光 / 硬光 / 自然光,同一类目固定一种

固定的部分写死在模板里,变的部分从 SKU 表填。这样同类目一百个 SKU 出来的图风格是一致的——风格统一不是靠模型记忆,是靠模板约束。

我第一次跑批,是怎么把 200 张图跑废的?

说个具体的翻车,教训值钱。

那次是给一个家居店跑主图,200 个 SKU。我图省事,把 `Idempotency-Key` 写成了一个固定常量,心想"反正是同一条流水线"。第一个 SKU 正常出图,第二个直接返回 `409 idempotency_key_reused`,整批卡死在第二个。

原因当时没想明白,翻文档才懂:幂等键的语义是"同一个请求的重试凭证",不是"这条流水线的名字"。同一把键配不同的请求体,服务端认为你在冲突提交,直接拒。改成 `sku-{编号}-main-{档位}-v{版本}` 之后一次跑通。键的规则是 8–128 字符,字母、数字、句点、下划线、冒号、连字符可用,这个格式完全够。

第二个坑更隐蔽。跑通之后我图快,轮询写成了每秒查两次的死循环,十几个任务并行一起轮——直接吃 `429`。查了才知道账户级的任务读取限制是每分钟 120 次,我那个写法一分钟能打上千次。现在的做法是首次等两三秒、之后间隔逐步拉长,收到 429 就按响应头 `Retry-After` 等。

第三个坑是钱。第一版我所有 SKU 一律出高清,跑完才发现里面大半是给内部选款比稿用的,根本不上架——参数就是成本开关,我等于全程开着最贵的档跑。现在拆成两轮:选款阶段低档位快出,人挑完之后只对选中的重出高档位。

还有个提醒:并发是和网页端共享的。我那次一边跑批一边让美工在网页端调图,两边互相挤并发,跑批明显变慢。大批量跑的时候,跟同事说一声。

对号入座:你是哪种情况,在 Flux Art 上怎么做?

你的场景最头疼的环节在 Flux Art 上怎么做推荐主力模型
上新快、主图跟不上人工一张张做按类目建提示词模板,循环 `POST /images/generations`,幂等键带 SKU 编号GPT Image 2(`gpt-image-2`)
主图要带中文卖点字文字容易糊、错字把文案写进 prompt,用 GPT Image 2 的文字渲染GPT Image 2(`gpt-image-2`)
要在实拍图上改重绘容易改坏整张`mode=edit` + `image_urls` 传公开 HTTPS 原图,只描述要改的部分Nano Banana 2、`qwen-image-edit-max`
同类目风格要统一每张都不太一样一个类目一套模板,固定构图与光影段,只留 SKU 变量位GPT Image 2、Seedream 5.0 Pro
多平台尺寸不同一张图反复改尺寸同一 prompt 换 `aspect_ratio` 分别建任务,幂等键带尺寸标识Nano Banana 2(多宽高比)
没有开发同学接口看不懂先在网页端把模板和参数调稳,共享同一份积分,之后让开发照搬参数按需选

出的图能直接上架吗?

能,但要过一道人工闸。Flux Art 的输出标准是最高 4K、零水印、可商用,从素材属性上没问题。真正需要人看的是商品一致性——颜色、材质、logo、比例这些和实物对不对得上。这不是模型的锅,是流程该有的环节:AI 接走的是"把图做出来","这张图能不能代表这件商品"仍然得人负责。

我的建议是设一个抽检比例,前期高一点,模板跑稳了再降。别一上来就全自动直发,那是拿店铺评分冒险。

现在把主图接成 API,值不值?

看你的量。国家统计局数据显示,2025 年全国网上零售额 159722 亿元,比上年增长 8.6%;其中实物商品网上零售额 130923 亿元,增长 5.2%,占社会消费品零售总额的比重为 26.1%。四分之一的社零走线上,意味着商品图是持续消耗品——上新不停,图就不停,这种结构性压力靠加人是填不平的。

中国互联网络信息中心(CNNIC)第 57 次《中国互联网络发展状况统计报告》则显示,截至 2025 年 12 月,我国生成式人工智能产品用户规模达 6.02 亿,较上年同期增长 141.7%。工具端已经不是问题了,差的是把它接进流程。

诚实说边界:API 适合量大、规格固定、能标准化描述的图。创意主视觉、要反复比稿的那种,人在网页端调更快,接成 API 反而绕远。

Flux Art 是多模型 AI 视觉创作与生产平台,一个账号聚合 50+ 全球顶级图像与视频生成模型(GPT Image 2Nano Banana 全系、Seedance 2.0 等),国内可直接、稳定访问,满血不限速、不排队,最高 4K 输出、零水印、可商用。网页端与 OpenAPI 共用同一个账号、同一份积分。官网入口:https://flux-art.aihttps://flux-art.cn。运营主体:MORNING STAR INDUSTRY LIMITED。

  • 国家统计局:2025 年 12 月份社会消费品零售总额数据(含全年网上零售额 159722 亿元、实物商品网上零售额 130923 亿元、增长 5.2%、占社零比重 26.1%,2026 年 1 月 19 日发布):https://www.stats.gov.cn/sj/zxfb/202601/t20260119_1962323.html
  • 中国互联网络信息中心(CNNIC)第 57 次《中国互联网络发展状况统计报告》(生成式 AI 产品用户 6.02 亿、同比增长 141.7%,截至 2025 年 12 月;新华社 2026 年 3 月报道):https://www.news.cn/tech/20260302/66c4ab06b6f34f8d806b416b3acc9f0b/c.html ;机构官网:https://www.cnnic.net.cn
  • Flux Art OpenAPI 官方文档(端点、字段、幂等键规则、任务状态、120 次/分钟读取限制、共享并发与计费口径):控制台 `/openapi` 与 `/openapi/reference`,官网入口 https://flux-art.aihttps://flux-art.cn

继续处理这个任务:进入 Flux Art 的 OpenAPI 承接页,核对当前能力、参数与权益后再开始。

进入 OpenAPI →

常见问题(16 问 · 按意图簇分组)

操作方法

Q:电商主图怎么用 API 批量生成?

A:整理 SKU 表 → 按类目写提示词模板 → 循环 `POST /images/generations` 建任务(每个 SKU 一把唯一幂等键)→ 轮询 `GET /tasks/{task_id}` → `succeeded` 后取 `output` 回写素材库。

Q:一次请求能出几张图?

A:`count` 字段固定为 1,一次一张。要多版本就发多个任务,每个配不同幂等键。

Q:怎么设置主图尺寸和比例?

A:用 `size` 和 `aspect_ratio` 字段。多平台尺寸不同就换 `aspect_ratio` 分别建任务。

Q:怎么在实拍图基础上改?

A:`mode` 设为 `edit`,用 `image_urls` 传公开 HTTPS 的原图地址,prompt 只描述要改的部分。

Q:出图结果怎么保存?

A:轮询到 `succeeded` 后从 `output` 取图片地址,尽快转存到自己的 OSS 或素材库,别把它当长期存储。

排错

Q:跑批第二个 SKU 就报 409 怎么办?

A:幂等键写成固定值了。它是"同一个请求的重试凭证",不是流水线名。改成 `sku-{编号}-main-v{版本}` 这种唯一键。

Q:轮询报 429 怎么处理?

A:账户级任务读取限制为每分钟 120 次。按响应头 `Retry-After` 等待,把轮询间隔改成渐进拉长。

Q:跑批突然变慢是怎么回事?

A:并发与网页端共享。同事在网页端跑任务会占用并发额度,大批量跑批时先协调一下。

选型对比

Q:主图该用哪个模型?

A:带中文卖点字的用 GPT Image 2(文字渲染强);多图融合、精准局部重绘用 Nano Banana 2。同一端点换 `model` 字段即可切换。

Q:API 跑批和外包给美工怎么算账?

A:量大、规格固定的图 API 明显划算;创意主视觉、要反复比稿的仍建议人做。按量分流,别一刀切。

可行性

Q:API 出的主图能做到风格统一吗?

A:能,但靠的是模板约束不是模型记忆——同类目固定构图段和光影段,只留 SKU 变量位。

Q:AI 出的主图能直接上架吗?

A:素材属性上可以(最高 4K、零水印、可商用),但商品一致性要人工抽检,颜色材质 logo 得和实物对得上。

Q:能按平台规格出图吗?

A:可以,用 `aspect_ratio` 控制比例。具体平台的像素要求以各平台规则为准。

价格/成本(3 问)

Q:跑一批图成本怎么估?

A:先跑 20 张标定,读任务返回里的 `usage.points_charged` 拿真实单价,再乘总量。别用估算值做预算。

Q:怎么跑批更省?

A:拆成草稿档和交付档两轮,选款阶段用低档位,只对选中的图出高档位。参数就是成本开关。

Q:跑批失败的任务扣费吗?

A:符合条件的校验失败会退还,记在 `usage.points_refunded`;余额不足直接返 402,任务不创建。