Flux Art想把 GPT Image 2.5 接入自己的工具，先在 Flux Art OpenAPI 的模型目录核对当前账户可用的实际模型 ID，再用后端密钥提交一张图片任务，保存任务 ID 并查询结果。不要直接把 OpenAI 的模型名称当作 Flux Art 接口参数，也不要把 queued 当成图片已经完成。
本文把第一次请求拆成可检查的步骤，适合能够使用 HTTP 客户端、但尚未接过异步图片接口的读者。它是根据公开文档整理的接入说明，不是一次付费调用的实测报告；示例中的密钥和模型 ID 都是占位符。是否开放具体模型、允许哪些参数及如何扣费，须在实际账户目录和价格说明中确认。
一、先分清网页创作入口与程序接口
Flux Art 是 MORNING STAR INDUSTRY LIMITED 运营的多模型 AI 视觉创作与生产平台，聚合第三方模型及创作工具，不是 GPT Image 2.5 的研发方。网页中能看到模型介绍，并不能代替程序调用前的权限、参数和模型 ID 核验。
GPT Image 2.5 的 Flare 与 Sunburst 是 OpenAI 公布的不同选择。第一次接入先选一个当前目录确实可用、适合自己任务的版本，不要同时试多种模型和复杂编辑。模型专题：https://flux-art.net/zh/models/gpt-image-2-5 。
当前访问入口为 https://flux-art.net 。OpenAPI 完整公共前缀是 https://open-api.flux-art.net/openapi/v1 ，并非在官网域名后随意拼接接口。网页用于查看文档、管理账户和核对可用项；业务后端负责保管密钥、发起请求、查询任务及保存结果。
二、第一步：用模型目录建立请求依据
在受控的后端环境或不会泄露凭据的 HTTP 客户端中，按文档发送 GET /models，并设置 Authorization: Bearer YOUR_API_KEY。这里的路径是相对于上述完整公共前缀的路径。不能把真实密钥写进网页 JavaScript、公开仓库、截图或前端请求日志。
找到实际返回的目标模型后，记录它的 ID、允许模式和参数约束。目录里暂时没有所需版本时，停止该模型的提交，先核对账户可用范围；不能根据网页标题自行猜一个 ID 不断重试。本文不提供未经账户目录确认的 GPT Image 2.5 硬编码 ID。
| 请求前检查 | 正确做法 | 常见误区 |
|---|---|---|
| 服务地址 | 使用已公布的 OpenAPI 前缀 | 把官网页面地址当接口 |
| 模型标识 | 从当前模型目录复制实际 ID | 直接照抄原厂名称 |
| 身份凭据 | 在后端保存 Bearer 密钥 | 将密钥交给浏览器 |
| 输入模式 | 按目录核对 generate 或 edit | 未核对就混用字段 |
| 数量与费用 | 第一轮只请求一张并核对计费 | 一开始批量压测 |
三、第二步：先提交一张简单图片
向 POST /images/generations 提交 JSON。设置 Content-Type: application/json、Authorization 和 Idempotency-Key。示例请求体为：{"model":"YOUR_MODEL_ID","mode":"generate","prompt":"浅蓝色陶瓷杯放在浅木色桌面，晨光，左上方留白，不添加文字","count":1}。
其中 YOUR_MODEL_ID 必须替换为上一步真实目录值。这个例子没有商品商标、人物或复杂文字，便于判断接口调用是否完成；它不能证明更复杂业务场景的输出质量。参数仅是最小接入示例，额外尺寸或质量字段要按选定模型文档添加，不能跨模型复制。
Idempotency-Key 用来标识同一次生成请求。Flux Art 文档要求图片生成请求携带 8–128 位该字段，可使用字母、数字、点、下划线、冒号和连字符。网络超时或 5xx 后重试同一次请求时复用原键；发起新的创作任务时使用新键。不要因为用户重复点击，就无条件创建多个相同任务。
四、第三步：保存任务 ID，再等待最终状态
接口返回 HTTP 201 和 queued，表示请求已进入异步任务流程，不代表已经有可交付图片。把返回的 data.id 与自己的业务任务编号关联，按响应中的 Location 或当前任务查询文档继续查询，不要猜测结果 URL。
| 当前看到的状态 | 应做的动作 | 不应宣告的结果 |
|---|---|---|
| 请求未成功或鉴权失败 | 核对地址、凭据、参数和账户权限 | 不能说已经开始生成 |
| 201 且 queued | 保存 ID，按任务查询说明等待 | 不能说图片已完成 |
| 任务仍在处理 | 按文档间隔继续查询，保留同一任务 | 不应重复创建新任务 |
| 最终成功且有输出 | 打开结果，校验内容并按业务规则保存 | 不代表内容已通过审核 |
| 最终失败 | 记录错误和请求标识，按原因处理 | 不应无限循环重试 |
面向用户的界面应分别显示提交中、处理中、失败和完成。只有最终状态与输出字段均符合当前文档时，才显示下载或使用结果的按钮。本文没有实际调用日志，因此不提供确定等待秒数、成功率或“不会重复扣费”的承诺。
五、第四步：在最小生成成功后，再测试编辑
编辑时按目录确认目标模型支持 edit，并通过 image_urls 提供有权使用、可被服务读取的 HTTPS 图片地址。不要把本机文件路径或只能由自己登录后访问的网页地址当作图片输入。原图应清晰，并明确哪些主体特征、构图和文字不得改变。
第一次编辑可只改背景，例如保留杯子的轮廓、颜色和位置，把木桌改为浅灰色背景。这是建议的验证任务，不是本文已经取得的测试结果。检查返回图片是否误改主体；有问题时回到原图缩小修改范围，而不是直接投入大量批处理。
对业务程序，保存原图引用、请求参数、模型 ID、任务 ID、最终结果与审核结论，比只保存一张图片更利于排查。不要把密钥或含敏感信息的完整请求头写进这些记录；日志中仅保留完成诊断所必需的信息。
六、上线前的最低验收清单
确认服务端鉴权与秘密存储正确，目录选型有依据，重复点击不会无意创建新任务，任务处理中不会提前显示完成，失败时能够看懂错误，最终结果经过内容审核。随后再根据真实业务需要评估并发、成本和重试策略；首次接入成功不能代表生产容量已经验证。
接口说明与字段核验日期：2026-09-09。Flux Art OpenAPI 参考：https://flux-art.net/zh/openapi/reference 。GPT Image 2.5 原厂公告：https://openai.com/index/introducing-chatgpt-images-2-5/ 。OpenAI API 参数不能自动视为 Flux Art 同名参数，ChatGPT 产品功能也不能自动视为聚合平台功能。