OpenAI

GPT Image 2

gpt-image-2/text-to-image

OpenAI 的图像生成与编辑模型，主打照片级真实感、高精度文字渲染和原生 4K 输出，适合含文字的商业物料与产品图

线路

default ext beta

gpt-image-2/image-to-image gpt-image-2/text-to-image

试用 gpt-image-2/text-to-image

输入

作品灵感

查看全部作品

输出

image

填写参数并生成，结果会显示在这里。

价格

gpt-image-2/text-to-image 每张

规格	单价
1K	$0.030
2K	$0.040
4K	$0.060

定位简介

gpt-image-2 是 OpenAI 的文本生成图像模型，面向需要稳定产出商业级视觉素材的开发者。它擅长还原复杂提示词中的多重约束，在含文字的海报、包装与版式中保持较好的排版整洁度，并支持 1K 至 4K 分辨率与多种画幅比例。通过 HiAPI.ai 统一接口传入一段提示词即可出图，适合把出图能力嵌入设计工具、营销物料流水线与内容生产后台的团队。

核心亮点

复杂提示词遵循度较好——继承 GPT 系列语义理解能力，面对同时含主体、风格、文字与版式约束的提示词仍能按意图出图。
含文字画面渲染更可靠——对招牌、包装、版式类文字内容有较好的还原与排版表现，减少出图后返工修字。
分辨率与画幅覆盖面广——支持 1K、2K、4K 输出与从 1:1 到 21:9 的十余种比例，一次接入适配多种投放规格。
单次调用多版本产出——可一次生成多张结果，便于在同一提示词下做方案比选与风格探索。

能力说明

文本提示生成图像：传入最长 20000 字符的提示词即可生成图像，适合把自然语言描述直接转成可用视觉素材。

多分辨率与多画幅输出：可在 1K、2K、4K 间选择，并按投放位选择横竖比例；auto 比例与 9:21、3:1 等极端比例限 1K，1:1 不支持 4K。

透明背景输出：background 支持 auto、opaque、transparent 三种模式，透明底图可直接用于合成与叠加，该参数仅在 1K 下生效。

文字与版式呈现：对含文字的图文混排画面有较好的渲染与排版表现，适合需要成稿感的商业画面。

多张结果一次返回：单次提示可产出多张风格一致的图像，便于快速做版本对比与选优。

适用场景

营销团队：广告海报与主视觉出图——输入活动主题与版式要求，产出可直接进入投放或二次精修的 campaign 主视觉。
电商运营：商品图与产品摄影风格渲染——以商品描述为输入生成摄影风格产品图，用于详情页、货架图与社交素材。
设计团队：带文字的包装与版式稿——输入文案与图文关系，产出含多语言文字的包装、招牌与版式设计稿。
内容平台：方案多版本迭代——同一提示词批量出图做风格探索，把候选方案交给评审后再定稿。

限制与选型建议

仅输出图像，不支持视频等其他模态。官方将生成速度评为中等，不适合对延迟极敏感的实时交互场景；高分辨率与批量出图会同时拉长耗时并抬高调用成本，需要按投放规格权衡。含精确文字的画面仍建议人工校对。若需求偏向复杂场景构图推理或极致出图速度，应另行评估其他模型；HiAPI.ai 上另有本系列的图生图线路，需要以现有图像为输入时可改用该线路。计费按张数计算，具体金额以价格面板为准。

近期更新

查看更新日志 →

参数变更 gpt-image-2 新增 1K / 2K / 4K 分辨率档位 Apr 30, 2026

常见问题

查看全部常见问题 →

什么是 GPT Image 2？

GPT Image 2 是 OpenAI 的文生图模型，适合海报、知识卡片、产品视觉和包含明确文字与版式要求的图像生成。
GPT Image 2 和 GPT Image 2.0 是同一个模型吗？

GPT Image 2.0 是常见的搜索简称；使用 GPT Image 2 页面和 API 文档列出的准确模型 ID。
GPT Image 2 API 使用哪个端点和模型 ID？

向 POST /v1/tasks 发送请求，文生图将 model 设置为 gpt-image-2/text-to-image，并在 input 中传入 prompt、aspect_ratio 和 resolution。接口会先返回 taskId，再通过任务查询或 callback 获取最终图片。
如何使用 GPT Image 2？

在 Playground 中写明主体、场景、版式和必须出现的文字，再选择画幅、分辨率和背景，点击运行并查看结果。

提交生成任务

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/text-to-image

routestring可选

当前固定值：default

inputobject必填

gpt-image-2/text-to-image 和线路 default 的业务参数对象，见下方参数表。

promptstring必填minLength 1maxLength 20000

文本提示词，必填，最大长度 20000 个字符。

backgroundstring可选

背景模式，仅在 1K 分辨率下支持该参数。

可选项：autoopaquetransparent

resolutionstring可选默认值: "1K"

生成图像的分辨率，默认 1K。当 aspect_ratio 为 auto 时仅支持 1K，1:1 不支持 4K；当 aspect_ratio 为 3:1/1:3/9:21 时仅支持 1K；当 background 为 auto/opaque/transparent 时仅支持 1K。

可选项：1K2K4K

aspect_ratiostring可选默认值: "auto"

生成图像的宽高比，默认 auto。省略或设为 auto 时仅支持 1K 分辨率。

可选项：auto1:13:22:34:33:45:44:5

显示全部（8 项）

16:99:162:11:23:11:321:99:21

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/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1K",
    "aspect_ratio": "auto"
  }
}'

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/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1K",
      "aspect_ratio": "auto"
    }
  }),
});
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/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1K",
          "aspect_ratio": "auto"
        }
    },
)
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/text-to-image@beta",
  "input": {
    "size": "auto",
    "prompt": "…"
  }
}'

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/text-to-image@beta",
    input: {
      "size": "auto",
      "prompt": "…"
    }
  }),
});
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/text-to-image@beta",
        "input": {
          "size": "auto",
          "prompt": "…"
        }
    },
)
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/text-to-image@ext",
  "input": {
    "prompt": "…",
    "quality": "low",
    "resolution": "1K",
    "aspect_ratio": "1:1"
  }
}'

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/text-to-image@ext",
    input: {
      "prompt": "…",
      "quality": "low",
      "resolution": "1K",
      "aspect_ratio": "1:1"
    }
  }),
});
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/text-to-image@ext",
        "input": {
          "prompt": "…",
          "quality": "low",
          "resolution": "1K",
          "aspect_ratio": "1:1"
        }
    },
)
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"
    }
  }
}