GPT Image 2 API 接入详解

把 GPT Image 2 接进自己的产品,整个链路只有四步:建 Key → 发任务 → 轮询 → 拿图。API 由聚合平台 Flux Art 提供(官网 flux-art.ai 及 flux-art.cn),国内服务器可直连,与网页端共用同一账号与积分池。本文给出可直接复制的最小接入示例;想先感受出图质量,本站首页可免费体验一次。

GPT Image 2 API 使用:先准备计划与 Key

• 计划门槛:Open API Support 包含在 Pro / Max / Ultra 付费计划中,价格与权益以官网当前为准;
• 创建 Key:控制台生成,fa_live_ 开头,创建后立即存入服务端环境变量或密钥管理器;
• 安全红线:Key 等同账户积分,严禁写进前端代码或提交进代码仓库。

基址、鉴权与端点怎么用?

接口基址:https://open-api.flux-art.ai/openapi/v1(注意:接口域只有 .ai,不存在 flux-art.cn 的接口域,别照官网双域名的习惯想当然)。鉴权用请求头 Authorization: Bearer fa_live_...。核心端点三个:

端点	作用
POST /images/generations	创建生成任务
GET /tasks/{id}	查询任务状态与结果
GET /tasks	按 limit、cursor、type、status 分页查询任务
GET /models	列出可用模型

最小可用示例长什么样?

BASE="https://open-api.flux-art.ai/openapi/v1"  # 接口域只有 .ai,没有 flux-art.cn 接口域
curl -X POST "$BASE/images/generations" \
  -H "Authorization: Bearer $FA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: poster-20260718-0001" \
  -d '{
    "model": "gpt-image-2",
    "mode": "generate",
    "prompt": "咖啡店开业海报,主标题「开业大吉」,暖色调,现代简约排版",
    "count": 1
  }'

body 里 mode 支持 generate(文生图)与 edit(图生图编辑);编辑模式还需要可公开访问的 image_urls。size、aspect_ratio 等字段存在,但各模型的具体枚举未公开,应读取控制台当前文档或模型目录后再传,不要凭网页端标签硬编码 API 值。

异步任务怎么拿到结果?

创建成功返回 201 与状态为 queued 的任务对象;随后轮询 GET /tasks/{id},直到 succeeded 取结果、或 failed 读错误信息。两个工程注意点:

1. 任务读取限流 120 次/分,收到 429 按响应头 Retry-After 等待再查,别用死循环硬轮询;
2. Idempotency-Key(8–128 字符)是防重复扣费的保险:超时重试沿用同一把键,服务端识别为同一任务;全新请求换新键,推荐用业务单号或 UUID。

计费与错误码怎么处理?

积分在任务创建时扣除,校验失败自动退还;余额不足直接返回 402,任务不会创建。积分、会员权益、并发额度均与网页端共享。错误码速查:

状态码	含义	处理
400 / 422	请求或参数校验不通过	修正后再发
401	Key 缺失或无效	检查鉴权头
402	积分不足,任务未创建	充值或升级后重发
404	任务或资源不存在	核对任务 id
409	请求冲突	核对幂等键使用方式
429	触发限流	按 Retry-After 退避
5xx	服务端异常	指数退避重试

具体错误响应结构以官网文档当前说明为准;各档位积分单价未公开,以控制台显示为准,计费逻辑详见 API 计费说明。GPT Image 2 的活动与折扣以官网当前为准。