gpt-image-2.5 API文档，支持10万并发

https://wellapi.cc

gpt-image-2.5-flare-img,gpt-image-2.5-sunburst-img,gpt-image-2-1k-new,gpt-image-2-2k-new,gpt-image-2-4k-new

{
  "object": "list",
  "data": [
    {
      "id": "gpt-image-2.5-flare-img",
      "object": "model",
      "created": 0,
      "owned_by": "x"
    }
  ]
}

{
  "model": "gpt-image-2.5-flare-img",
  "prompt": "生成一张白色背景上的蓝色圆形图标，无文字",
  "n": 1,
  "response_format": "url"
}

{
  "model": "gpt-image-2.5-flare-img",
  "prompt": "生成一张未来城市海报，无文字，高清细节，赛博朋克风格",
  "n": 1,
  "size": "2048x1536",
  "quality": "high",
  "response_format": "url"
}

{
  "created": 1783487667,
  "data": [
    {
      "url": "https://example-image-domain/images/2026/07/08/example.png",
      "revised_prompt": "生成一张未来城市海报，无文字，高清细节，赛博朋克风格"
    }
  ],
  "usage": {
    "input_tokens": 30,
    "output_tokens": 8000,
    "total_tokens": 8030
  }
}

data[0].url

data[0].url
data[1].url
...

{
  "response_format": "b64_json"
}

{
  "created": 1783487667,
  "data": [
    {
      "b64_json": "<base64 image data>",
      "revised_prompt": "..."
    }
  ]
}

{
  "model": "gpt-image-2.5-flare-img",
  "prompt": "参考这些图片生成一张新海报，无文字",
  "images": [
    "https://example.com/a.png",
    "https://example.com/b.jpg"
  ],
  "response_format": "url"
}

{
  "model": "gpt-image-2.5-flare-img",
  "prompt": "增强图片细节，无文字",
  "image": "data:image/png;base64,<base64>",
  "response_format": "url"
}

{
  "model": "gpt-image-2.5-flare-img",
  "prompt": "参考这些图片生成一张统一风格海报，无文字",
  "images": [
    "data:image/png;base64,<base64-a>",
    "data:image/jpeg;base64,<base64-b>"
  ],
  "response_format": "url"
}

{
  "file_id": "file-xxx"
}

data[0].url

data[0].b64_json

{
  "batch_id": "img_batch_example123",
  "status": "queued",
  "model": "gpt-image-2.5-flare-img",
  "prompt": "生成一张未来城市海报，无文字，高清细节",
  "size": "2048x1536",
  "quality": "high",
  "response_format": "url",
  "total": 3,
  "queued": 3,
  "running": 0,
  "succeeded": 0,
  "failed": 0,
  "unknown": 0,
  "canceled": 0,
  "cancel_requested": false,
  "created_at": 1784491200,
  "updated_at": 1784491200,
  "poll_url": "/v1/image-batches/img_batch_example123"
}

{
  "model": "gpt-image-2.5-flare-img",
  "prompt": "分别把每张图片调整为统一的商业摄影风格",
  "tasks": [
    {"images": ["https://example.com/input-1.png"]},
    {"images": ["https://example.com/input-2.png"]},
    {"images": ["https://example.com/input-3.png"]}
  ],
  "response_format": "url"
}

{
  "object": "list",
  "data": [
    {
      "item_id": "img_batch_example123_000001",
      "position": 1,
      "input_url": "",
      "status": "succeeded",
      "attempt_count": 1,
      "output_url": "https://example-image-domain/images/result-1.png",
      "http_status": 200,
      "started_at": 1784491202,
      "finished_at": 1784491240,
      "created_at": 1784491200,
      "updated_at": 1784491240
    },
    {
      "item_id": "img_batch_example123_000002",
      "position": 2,
      "input_url": "",
      "status": "failed",
      "attempt_count": 1,
      "http_status": 400,
      "error_code": "content_policy_violation",
      "error_message": "请求未能生成图片",
      "started_at": 1784491202,
      "finished_at": 1784491205,
      "created_at": 1784491200,
      "updated_at": 1784491205
    }
  ],
  "next_cursor": "12345",
  "has_more": true
}

{
  "batch_id": "img_batch_example123",
  "requeued": 2
}

{
  "error": {
    "message": "Idempotency-Key 长度必须在 8 到 128 之间",
    "type": "invalid_request_error",
    "code": "invalid_idempotency_key",
    "param": null
  }
}

data[i].output_url

当前同时支持同步和异步生图。

同步文生图使用 POST /v1/images/generations，同步图生图使用 POST /v1/images/edits，接口会等待图片完成后返回。

异步纯文生图使用 POST /v1/image-batches/generations；异步图生图统一使用 POST /v1/image-batches/edits。逐图处理时在 tasks 的每个任务中只放 1 张图；多图合成一张时使用顶层 images；批量分组时使用 tasks 并在每个任务中放 1-10 张图。提交成功后返回 batch_id，客户通过 GET /v1/image-batches/{batch_id} 查询状态，通过 /items 接口获取每个任务的 output_url。

生图可能需要 1-10 分钟。如果客户端前端在 60-120 秒左右自行超时，就可能先显示失败，但服务端仍在等待生图结果。建议同步接口读取超时设置到 700 秒以上，并以最终 HTTP 响应里的 data 数组为准。

请求时设置 response_format=url。接口成功后从 data[0].url 获取图片下载地址。如果 n 大于 1，则依次读取 data[0].url、data[1].url。

JSON 调用请把图片 URL 填在 image 字段里，例如 "image": "https://example.com/input.png"。不要使用 image_url。

4K 和标准生图使用同一套模型名，model 都填写 gpt-image-2.5-flare-img。调用 4K 时必须使用已开通 4K 权限的专用 Token，不需要添加额外路由字段，也不要修改模型名。

同步 4K 文生图使用 /v1/images/generations；同步 4K 图片编辑使用 /v1/images/edits 和 multipart 文件上传。异步 4K 纯文生图使用 /v1/image-batches/generations，且只支持 response_format=url。当前不对客户承诺异步 4K 图生图，4K 图片编辑请继续使用同步 multipart 方式。

先通过 GET /v1/image-batches/{batch_id} 等待批次进入终态，再调用 GET /v1/image-batches/{batch_id}/items 分页读取明细。status=succeeded 的项目从 output_url 取图片地址。异步接口不返回 b64_json。

使用 POST /v1/image-batches/edits，并把 1-10 张公网图片 URL 放在同一个 images 数组中。整个 images 数组只创建一个任务，最终只生成一张结果图。

如果要批量提交多组“多图生成一图”任务，则使用 tasks 数组；每个 tasks[i].images 是一组参考图，每组独立生成一张结果图。