OpenAI

gpt-image-2.5

gpt-image-2.5-flare

OpenAI 图像生成与编辑模型，含 Flare 速度版与 Sunburst 精度版，支持文生图与多轮图像编辑，最高 3840px 输出

线路

gpt-image-2.5-flare gpt-image-2.5-flare/image-to-image gpt-image-2.5-flare/text-to-image gpt-image-2.5-sunburst/image-to-image gpt-image-2.5-sunburst/text-to-image

价格

gpt-image-2.5-flare 每张

规格	单价
low	$0.0172
medium	$0.0672
high	$0.1829
xhigh	$0.3572
max	$0.7143
auto	$0.3572

定位简介

gpt-image-2.5-flare 是 OpenAI gpt-image-2.5 图像家族中的默认变体，面向速度与通用场景，支持文生图与图像编辑两种调用方式，最高输出 3840px。相比 GPT Image 2，官方称其在质量更高的同时延迟降低约 50%。适合需要在有限时间内批量产出营销配图、社媒素材或对既有图片做多轮迭代修改的开发者；若需求是商业级高保真细节，同家族的 Sunburst 变体更合适。

核心亮点

速度优先的默认变体——定位为速度优化型号，官方称质量高于 GPT Image 2 的同时延迟约降低一半，适合对吞吐敏感的批量生成。
生成与编辑同一套模型——同时提供文生图与图像编辑端点，生成新图与修改既有图片无需切换不同模型。
多轮编辑一致性增强——对聚焦的编辑指令遵循更可靠，早期编辑结果在后续轮次中更易保留。
参考图主体保留更稳——从参考照片中提取的人物或主体在生成结果中更易被准确还原，可用于一致性图像产出。

能力说明

文生图：用文本提示直接生成图像，最高支持 3840px 输出，可作为批量配图与素材生产的基础能力接入业务管线。

图像编辑与多轮迭代：对已有图像执行编辑并可连续多轮修改，跨轮次保持前后一致，适合在已有素材上逐步精修而非反复重生成。

编辑指令遵循：更可靠地执行聚焦的编辑要求，开发者可以用更少的重试轮次完成局部修改类任务。

参考图主体保留：从参考照片中提取的主体在结果中更易被准确还原，适用于需要保持人物或产品一致性的生成任务。

版式与透明背景处理：复杂版式与透明背景场景的处理有所改进，可用于设计流程中需要抠图或叠加的素材产出。

适用场景

营销与社媒团队批量出图——输入商品或活动主题的文本描述，批量得到可发布的配图素材，直接用于社媒与推广渠道。
设计流程中的图像精修——输入已有设计稿并给出局部修改指令，多轮迭代得到精修版本，用于设计稿定稿前的调整。
基于参考照片的一致性生成——输入人物或产品参考图与场景描述，产出主体一致的图像，用于需要形象统一的系列素材。
应用内图像生成与编辑功能——通过 API 接入文生图与编辑端点，为自有产品提供配图生成、图片修改等面向终端用户的功能。

限制与选型建议

单张输出最高 3840px，超出该尺寸的需求无法满足。Flare 侧重速度与通用质量，画面精细度不及同家族的 Sunburst，对复杂细节保真度要求高的商业级制作应选 Sunburst，但需接受更长的单次请求耗时，强实时场景两者都不适合。官方未公开参数量与训练数据等底层细节，可用性与配额以 OpenAI 官方渠道为准。

提交生成任务

POST https://api.hiapi.ai/v1/tasks

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：gpt-image-2.5-flare

routestring可选

当前固定值：default

inputobject必填

gpt-image-2.5-flare 和线路 default 的业务参数对象，见下方参数表。

promptstring必填minLength 1maxLength 10000

提示词，描述要生成的画面，或说明需要对参考图片执行的修改；最大 10000 个字符。

qualitystring可选默认值: "medium"

选择输出细节、生成速度和价格档位。默认 medium。

可选项：lowmediumhighxhighmaxauto

backgroundstring可选默认值: "auto"

选择自动、透明或不透明背景。默认 auto。

可选项：autotransparentopaque

image_urlsarray可选minItems 1maxItems 16

参考图片数组，元素为图片地址；传入后用于编辑、合成或保持主体与风格，为可选参数。

Array [ string ]

aspect_ratiostring可选默认值: "1:1"

选择输出画幅或像素尺寸；auto 由模型根据请求决定。默认 1:1。

可选项：1:13:22:34:33:416:99:16auto

显示全部（10 项）

1024x10241536x10241024x15361536x11521152x15362048x20482048x11521152x20483840x21602160x3840

output_formatstring可选默认值: "webp"

选择输出图片格式。默认 webp。

可选项：pngjpegwebp

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2.5-flare",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "background": "auto",
    "aspect_ratio": "1:1",
    "output_format": "webp"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2.5-flare",
    input: {
      "prompt": "…",
      "quality": "medium",
      "background": "auto",
      "aspect_ratio": "1:1",
      "output_format": "webp"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gpt-image-2.5-flare",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "background": "auto",
          "aspect_ratio": "1:1",
          "output_format": "webp"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2.5-flare@pro",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "background": "auto",
    "aspect_ratio": "1:1",
    "output_format": "webp"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2.5-flare@pro",
    input: {
      "prompt": "…",
      "quality": "medium",
      "background": "auto",
      "aspect_ratio": "1:1",
      "output_format": "webp"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gpt-image-2.5-flare@pro",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "background": "auto",
          "aspect_ratio": "1:1",
          "output_format": "webp"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}