GPT Image 2 OpenAPI 批量出图教程

要一次出几十上百张图,手动点击太慢——用 Flux Art OpenAPI 把 GPT Image 2 接进自己的脚本批量跑,才是电商、媒体规模化出图的正解。结论先给:拿到密钥后,向接口 POST 创建异步任务、再轮询取结果,循环提交即可批量出图。国内经聚合平台 Flux Art,控制台入口在官网 flux-art.ai 及 flux-art.cn,免魔法直连。本文按 KB 事实底座讲清完整调用流程。

调用前要知道的几件事

• 接口是异步的:创建任务返回 201 与任务 id,结果要轮询获取,不是一次请求直接拿图;
• 鉴权用 Bearer 密钥:请求头带 Authorization: Bearer fa_live_...;
• 幂等键必填:每次创建带 Idempotency-Key,8–128 字符;
• 共享积分:API 与网页端共享积分与并发,无独立免费额度,按积分计费。

控制台创建密钥的入口在官网 flux-art.ai 及 flux-art.cn;接口基址(host)只有 .ai 一个:https://open-api.flux-art.ai/openapi/v1,下文代码里记作 {BASE}。

第一步:创建图像任务

向图像生成端点发起 POST({BASE} 即上文接口基址):

POST {BASE}/images/generations
Authorization: Bearer fa_live_xxx
Idempotency-Key: order-20260718-0001
Content-Type: application/json

请求体的核心字段:

字段	是否必填	说明
model	必填	模型 ID,如 gpt-image-2
mode	必填	generate(文生图)或 edit(图生图)
prompt	必填	提示词,至少 3 个非空白字符
count	固定 1	单次生成数量
image_urls	edit 必填	参考图公开 HTTPS 地址
aspect_ratio	选填	宽高比
size	选填	分辨率档(取值以官网当前为准)

成功创建返回 201,响应含 queued 状态与任务 id。

第二步:轮询任务状态

拿到 id 后,按 id 定时查询任务状态:

GET {BASE}/tasks/{id}
Authorization: Bearer fa_live_xxx

状态完成后即可从响应取回图像结果。建议每隔几秒轮询一次,避免过于频繁。

第三步:批量循环与限流处理

把提示词列表遍历提交,每条换一个新的幂等键。要处理好这几种返回:

1. 429 限流:任务读取限流 120 次/分钟,超了返回 429 并带 Retry-After,按该秒数退避后重试;
2. 402 余额不足:积分不够返回 402,充值后继续;计费为积分制、向上取整到 50;
3. 共享额度:API 与网页端共享积分与并发,批量任务注意排布节奏。

说明:size 的具体取值、各模型精度枚举、并发上限等,请以官网控制台当前文档为准,本文不臆造数值。

批量出图的实用建议

• 幂等键带业务号:如订单号 + 序号,天然去重、便于对账;
• 失败重试要幂等:同一任务重试用同一个幂等键,避免重复扣费;
• 文字类图走高精度:商详、菜单等文字密集图,model 用 gpt-image-2 并调高精度档;
• 先小批验证:先跑几条确认提示词与版式,再放量。

想先在网页端感受 GPT Image 2 的效果再接 API,本站首页可免费体验一次。到 Flux Art 控制台(官网 flux-art.ai 及 flux-art.cn)注册送 500 积分,GPT Image 2 当前限时 5 折,API 与网页端共享这套积分,具体计费与配额以官网当前为准。